Firebase App Distribution — is de Google-service voor het distribueren van voorlopige builds van mobiele apps onder testers en interne teams zonder ze in app-winkels te hoeven publiceren. App Distribution biedt een uniforme interface voor het uploaden van APK en IPA, het beheren van testergroepen en het verzamelen van feedback. Volgens Firebase Documentation, 2026, stelt de service testers automatisch op de hoogte van nieuwe versies via e-mail en pushmeldingen, en Fastlane-integratie maakt het mogelijk builds rechtstreeks vanuit de CI/CD-pijplijn te publiceren zonder handmatige handelingen. App Distribution ondersteunt zowel Android (AAB/APK) als iOS (IPA), inclusief ad-hoc- en enterprise-distributie.
Belangrijkste punten
Firebase App Distribution — is de Google-service voor het distribueren van pre-releaseversies van mobiele apps onder testers en belanghebbenden. In tegenstelling tot publicatie in app-winkels, maakt App Distribution het mogelijk builds onmiddellijk aan geselecteerde deelnemers te leveren zonder een langdurig beoordelingsproces. De service is geïntegreerd met Firebase Crashlytics, waardoor ontwikkelaars crashrapporten rechtstreeks van testers kunnen ontvangen en problemen kunnen oplossen vóór de openbare release.
Het traditionele proces voor het distribueren van bètaversies omvat het handmatig versturen van APK/IPA via e-mail, uploaden naar externe bestandsservers of het opzetten van een eigen server. Firebase App Distribution lost deze problemen op: centrale opslagplaats voor builds in Google Cloud, automatische testermeldingen, gecentraliseerd toegangsbeheer en ingebouwde feedback via Firebase Crashlytics. De service is onmisbaar voor teams die CI/CD en regelmatige releases toepassen: een nieuwe build is binnen een minuut na upload beschikbaar voor testers.
App Distribution ondersteunt alle standaard buildformaten voor mobiele platforms. Voor Android — APK en Android App Bundle (AAB) met automatische generatie van APK uit AAB bij installatie. Voor iOS — IPA-bestanden voor ad-hoc-, development- en enterprise-distributie. Elke build gaat vergezeld van release notes, versienummer en buildcode voor tracking. De maximale bestandsgrootte voor upload is 500 MB, de bewaartermijn voor builds is 150 dagen.
Builds uploaden naar Firebase App Distribution gebeurt via Firebase Console, CLI (firebase appdistribution:distribute) of geautomatiseerde tools zoals Fastlane en Gradle. Bij het uploaden worden de buildversie, release notes en de lijst van testers of groepen die een melding moeten krijgen, opgegeven. Firebase kent automatisch een unieke identificatie aan de build toe en maakt deze beschikbaar voor installatie via een link.
Firebase Console biedt een webinterface voor het uploaden van builds en versiebeheer. In de console wordt de geschiedenis van alle geüploade builds weergegeven met datum, versie, status en aantal installaties. De ontwikkelaar kan een specifieke versie uitschakelen als er een kritieke fout is gevonden — dit blokkeert de installatie van de versie voor alle testers. De console toont ook een grafiek van installaties per dag, wat helpt bij het volgen van testactiviteit.
Firebase CLI maakt het mogelijk builds met één commando te uploaden, wat handig is voor integratie in CI/CD-pijplijnen. Het distribute-commando accepteert het bestandspad, het projecttoegangstoken, de lijst van testergroepen en optionele release notes. Voor authenticatie wordt een Firebase-serviceaccount gebruikt met de rol Firebase App Distribution Admin. CLI ondersteunt zowel Android- als iOS-builds en bepaalt automatisch het platform op basis van de bestandsextensie.
# Build uploaden via Firebase CLI
firebase appdistribution:distribute \
app-release.apk \
--app 1:123456789:android:abc123def456 \
--groups "qa-team,product-owners" \
--release-notes "Autorisatiefout gerepareerd" \
--token "FIREBASE_TOKEN"
Firebase App Distribution biedt een flexibel testerbeheersysteem: deelnemers kunnen per e-mail worden toegevoegd, groepen worden gemaakt op basis van rollen of projecten, en verschillende builds kunnen aan verschillende groepen worden toegewezen. Bij het toevoegen van een nieuwe tester stuurt het systeem een uitnodigingsmail met installatie-instructies. Testers ontvangen automatische meldingen over elke nieuwe build die aan hun groep is toegewezen.
Groepen maken het mogelijk testers te organiseren volgens een functioneel principe. Voorbeelden van groepen: QA-team (volledige toegang tot alle builds), Product Owners (toegang tot stabiele builds), External Testers (beperkte toegang voor externe bètatesters). Eén tester kan lid zijn van meerdere groepen. Bij het uploaden van een build selecteert de ontwikkelaar de doelgroepen — alleen leden van de geselecteerde groepen ontvangen meldingen, wat informatiestoring voorkomt.
Voor het programmatisch toevoegen van testers wordt Firebase App Distribution API gebruikt. De API maakt het mogelijk testers aan te maken, ze aan groepen toe te voegen en indien nodig te verwijderen. Dit is handig bij integratie met interne testbeheersystemen en bugtrackers. Bij het toevoegen van een tester via API ontvangt deze ook een uitnodigingsmail met een link om de eerste app te installeren.
const admin = require("firebase-admin")
const serviceAccount = require("./serviceAccountKey.json")
admin.initializeApp({ credential: admin.credential.cert(serviceAccount) })
async function addTestersToGroup(email, groupAlias) {
try {
await admin.appDistribution().addTesters(email, [groupAlias])
console.log("Tester toegevoegd aan groep")
} catch (error) {
console.error("Fout:", error)
}
}
addTestersToGroup("tester@example.com", "qa-team")
Android-builds distribueren via Firebase App Distribution ondersteunt twee formaten: APK en Android App Bundle (AAB). Bij het uploaden van AAB genereert Firebase automatisch een APK dat compatibel is met het apparaat van de tester, met behulp van Google Play App Signing. Testers installeren de app via een directe link — ze hebben geen toegang tot Google Play Console nodig en hoeven niet als tester in Play Console te worden toegevoegd. Dit vereenvoudigt het bètatestproces voor Android aanzienlijk.
Voor installatie via App Distribution moeten testers installatie uit onbekende bronnen op het apparaat inschakelen. Firebase genereert automatisch een link naar een webpagina met een APK-installatieknop. Voor AAB-formaat moet het apparaat Play Core Library ondersteunen en Google Play Store geïnstalleerd hebben. Firebase raadt aan AAB te gebruiken voor definitieve versies en APK voor snelle iteraties.
De Firebase App Distribution-plugin voor Gradle maakt het mogelijk builds rechtstreeks vanuit een Gradle-taak te verzenden. Configuratie omvat het toevoegen van de plugin com.google.firebase.appdistribution, het configureren van een serviceaccount en het instellen van doelgroepen. Na configuratie zal de taak assembleDistRelease de app bouwen en in één commando uploaden naar Firebase App Distribution.
// build.gradle (module: app)
plugins {
id 'com.android.application'
id 'com.google.firebase.appdistribution'
}
android { // standard config }
firebaseAppDistribution {
appId "1:123456789:android:abc123def456"
serviceCredentialsFile "firebase-sa.json"
groups "qa-team"
releaseNotes "Automatische build"
}
iOS-builds distribueren via Firebase App Distribution vereist extra configuratie, omdat Apple de installatie van apps buiten de App Store beperkt. Voor het distribueren van iOS-apps moeten ad-hoc- of enterprise-certificaten van het Apple Developer Program worden gebruikt. Testers moeten in Apple Developer Portal worden toegevoegd als apparaten voor ad-hoc-distributie of enterprise-distributie zonder apparaatbeperking gebruiken.
Voor ad-hoc-distributie moeten de UDID's van alle testerapparaten worden verzameld en toegevoegd aan Apple Developer Portal. Firebase App Distribution toont testers instructies voor het vinden van UDID en slaat geregistreerde apparaten automatisch op. Na het toevoegen van UDID aan een provisioning profile en het bouwen van IPA, ontvangen testers een installatielink. Firebase raadt het gebruik van een enterprise-certificaat aan voor projecten met veel testers, omdat ad-hoc is beperkt tot 100 apparaten per account.
Fastlane — het aanbevolen hulpmiddel voor het automatiseren van het bouwen van iOS-apps. Lane match beheert certificaten en provisioning profiles, en lane sigh maakt IPA voor distributie. Firebase App Distribution integreert met Fastlane via de plugin firebase_app_distribution, die IPA uploadt en testers op de hoogte stelt. Fastlane ondersteunt ook versiebeheer en release notes via extra plugins.
# Fastfile
lane :beta do
match(type: :adhoc)
gym(scheme: "MyApp", export_method: "ad-hoc")
firebase_app_distribution(
app: "1:123456789:ios:abc123def456",
groups: "qa-team",
release_notes: "Build van #\{Time.now.strftime
('%Y-%m-%d %H:%M')}"
)
end
Volledige integratie van Firebase App Distribution met CI/CD maakt het mogelijk automatisch nieuwe builds te publiceren bij elke commit in de repository. Door een CI-pijplijn in te stellen, ontvangt het team binnen enkele minuten na het pushen van code directe feedback van testers. App Distribution ondersteunt alle populaire CI-systemen: GitHub Actions, GitLab CI, Jenkins, Bitrise en CircleCI. Voor elk platform is een eigen configuratie vereist, maar het algemene principe is hetzelfde: bouwen → uploaden → melden.
GitHub Actions maakt het mogelijk automatische build-distributie in te stellen bij het pushen naar de develop-branch of het maken van een pull request. De workflow omvat installatie van Java/Flutter/Node.js, het bouwen van de app, authenticatie via Firebase Service Account en het uitvoeren van Firebase CLI met het distribute-commando. Geheimen (tokens, serviceaccounts) worden opgeslagen in GitHub Secrets en worden niet onthuld in buildlogs. Voor iOS is extra configuratie van Xcode en installatie van Fastlane in de workflow vereist.
# .github/workflows/distribute.yml
name: Distribute to Firebase
on:
push: { branches: [ develop ] }
jobs:
build-and-distribute:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Java
uses: actions/setup-java@v3
with: { distribution: "temurin", java-version: "17" }
- name: Build APK
run: ./gradlew assembleDebug
- name: Upload to Firebase
uses: wzieba/Firebase-Distribution-GitHub-Action@v1
with:
appId: "${{ secrets.FIREBASE_APP_ID }}"
serviceCredentialsFileContent: "${{ secrets.FIREBASE_SA_KEY }}"
groups: qa-team
file: app/build/outputs/apk/debug/app-debug.apk
Firebase App Distribution integreert met Firebase Crashlytics voor het automatisch verzamelen van crashrapporten van testers. Crashlytics koppelt automatisch een crash aan een specifieke buildversie en apparaat, wat helpt bij het snel lokaliseren en oplossen van problemen. Testers kunnen ook screenshots en opmerkingen sturen via de webinterface van App Distribution, en ontvangen een link naar het feedbackformulier na installatie van de build.
Veelgestelde vragen
Firebase App Distribution — is een cross-platform service (Android + iOS), in tegenstelling tot TestFlight, dat alleen voor iOS werkt. App Distribution integreert ook met Crashlytics en Firebase Analytics en biedt een uniform ecosysteem voor bètatesten op beide platforms.
Builds worden 150 dagen bewaard vanaf het moment van uploaden. Na deze periode worden ze automatisch verwijderd. Het wordt aanbevolen regelmatig nieuwe builds te uploaden en verouderde handmatig te verwijderen via Firebase Console, zodat testers geen verouderde versies installeren.
Er is geen limiet voor het aantal testers in Firebase App Distribution. Voor iOS ad-hoc-distributie geldt de Apple-limiet van 100 apparaten per account. Voor Android en iOS enterprise-distributie zijn er geen beperkingen voor het aantal testers.
Ja, App Distribution ondersteunt AAB (Android App Bundle). Firebase genereert automatisch APK uit AAB voor elk testerapparaat met Google Play App Signing. Dit is vooral handig voor testen vóór publicatie in Play Store.
Ja, App Distribution maakt deel uit van het gratis Spark-plan van Firebase. Beperkingen van Spark: tot 500 testers en 25.000 installaties per maand per project. Het Blaze-plan heft deze beperkingen op en voegt prioritaire ondersteuning toe.
Samenvatting
We ontwikkelen een mobiele applicatie turnkey
IT Sectr creëert sinds 2017 iOS- en Android-applicaties voor startups en bedrijven. We adviseren u en stellen de beste oplossing voor.
Lees ook