Firebase App Distribution: kernbegrippen, distributie van APK en IPA en configuratie

Auteur: IT Sectr Gepubliceerd: 2026-04-29 Leestijd: 8 min

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

  • App Distribution — Firebase-service voor het distribueren van bètaversies van apps onder testers zonder publicatie in Google Play en App Store.
  • Testergroepen — flexibel toegangsbeheersysteem: maak groepen op basis van rollen, projecten of testfasen met verschillende rechten voor builds.
  • Automatische meldingen — testers ontvangen e-mail en pushmeldingen bij elke nieuwe build met een installatielink.
  • Fastlane + Gradle — volledige integratie met CI/CD-systemen voor automatische publicatie van builds bij elke commit of pull request.
  • Feedback — testers kunnen screenshots, logs en opmerkingen sturen via de ingebouwde interface of Firebase Crashlytics.

Wat is Firebase App Distribution

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.

Waarom App Distribution nodig is

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.

Ondersteunde buildformaten

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 en versiebeheer

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.

Versiebeheer via Firebase Console

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.

Automatisch uploaden via Firebase CLI

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.

bash
# 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"

Testers en groepen beheren

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.

Testergroepen maken

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.

Testers toevoegen via API

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.

js
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

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.

Vereisten voor Android-builds

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.

Gradle configureren voor App Distribution

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.

groovy
// 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

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.

Ad-hoc-distributie configureren

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.

IPA bouwen via Fastlane

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.

ruby
# 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

Integratie met CI/CD en Fastlane

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.

Configureren via GitHub Actions

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.

yaml
# .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

Feedback verzamelen

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

Waarin verschilt App Distribution van TestFlight?

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.

Hoe lang worden builds bewaard in App Distribution?

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.

Hoeveel testers kunnen worden toegevoegd?

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.

Kan AAB worden geüpload in plaats van APK voor Android?

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.

Is Firebase App Distribution gratis?

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

  • Firebase App Distribution — service voor het distribueren van bètabulds van mobiele apps met ondersteuning voor Android (APK/AAB) en iOS (IPA) zonder publicatie in winkels.
  • Testerbeheer — flexibel groepssysteem met automatische e-mail- en pushmeldingen bij elke nieuwe build.
  • Builds uploaden gebeurt via Firebase Console, CLI, Gradle-plugin of Fastlane met automatische testermelding.
  • Android-builds ondersteunen APK en AAB met automatische APK-generatie uit AAB, installatie via directe link zonder Google Play Console.
  • iOS-builds vereisen een ad-hoc- of enterprise Apple-certificaat, met ondersteuning voor UDID-registratie en Fastlane voor automatisering van IPA-bouw.
  • CI/CD-integratie — GitHub Actions, GitLab CI, Jenkins, Bitrise met Firebase CLI of Fastlane voor automatische publicatie bij elke push.
  • Gratis tot 500 testers en 25.000 installaties per maand, builds 150 dagen bewaard, geïntegreerd met Firebase Crashlytics voor crashrapporten.

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.

Bespreek het project

Lees ook