Firebase App Distribution ist ein Google-Dienst zur Verteilung von Vorabversionen mobiler Anwendungen an Tester und interne Teams, ohne sie in App-Stores veröffentlichen zu müssen. App Distribution bietet eine einheitliche Oberfläche zum Hochladen von APK- und IPA-Dateien, zur Verwaltung von Testergruppen und zum Sammeln von Feedback. Laut Firebase Documentation, 2026 benachrichtigt der Dienst Tester automatisch per E-Mail und Push-Benachrichtigungen über neue Versionen, und die Fastlane-Integration ermöglicht die Veröffentlichung von Builds direkt aus der CI/CD-Pipeline ohne manuelle Aktionen. App Distribution unterstützt sowohl Android (AAB/APK) als auch iOS (IPA), einschließlich Ad-hoc- und Enterprise-Verteilung.
Wichtige Punkte
Firebase App Distribution ist ein Google-Dienst zur Verteilung von Vorabversionen mobiler Anwendungen an Tester und Stakeholder. Im Gegensatz zur Veröffentlichung in App-Stores können Sie mit App Distribution Builds sofort an ausgewählte Teilnehmer ausliefern, ohne einen langwierigen Überprüfungsprozess. Der Dienst ist in Firebase Crashlytics integriert, sodass Entwickler direkt von Testern Absturzberichte erhalten und Probleme vor der öffentlichen Veröffentlichung beheben können.
Der traditionelle Prozess der Beta-Verteilung umfasst das manuelle Versenden von APK/IPA-Dateien per E-Mail, das Hochladen auf Dateifreigabedienste von Drittanbietern oder das Einrichten eines eigenen Servers. Firebase App Distribution löst diese Probleme: ein einheitliches Build-Repository in der Google Cloud, automatische Tester-Benachrichtigungen, zentrale Zugriffsverwaltung und integriertes Feedback über Firebase Crashlytics. Der Dienst ist für Teams unverzichtbar, die CI/CD und regelmäßige Veröffentlichungen praktizieren: Ein neuer Build steht Testern innerhalb einer Minute nach dem Hochladen zur Verfügung.
App Distribution unterstützt alle Standard-Build-Formate für mobile Plattformen. Für Android — APK und Android App Bundle (AAB) mit automatischer APK-Generierung aus AAB bei der Installation. Für iOS — IPA-Dateien für Ad-hoc-, Entwicklungs- und Enterprise-Verteilung. Jeder Build wird von Versionshinweisen, Versionsnummer und Build-Code zur Nachverfolgung begleitet. Die maximale Upload-Dateigröße beträgt 500 MB, und Builds werden 150 Tage lang gespeichert.
Das Hochladen von Builds in Firebase App Distribution erfolgt über die Firebase Console, CLI (firebase appdistribution:distribute) oder automatisierte Tools wie Fastlane und Gradle. Beim Hochladen geben Sie die Build-Version, Versionshinweise und die Liste der Tester oder Gruppen an, die eine Benachrichtigung erhalten sollen. Firebase weist dem Build automatisch eine eindeutige Kennung zu und stellt ihn über einen Link zur Installation bereit.
Die Firebase Console bietet eine Weboberfläche zum Hochladen von Builds und zur Versionsverwaltung. Die Konsole zeigt den Verlauf aller hochgeladenen Builds mit Datum, Version, Status und Installationsanzahl. Ein Entwickler kann eine bestimmte Version deaktivieren, wenn ein kritischer Fehler gefunden wird — dies blockiert die Installation dieser Version für alle Tester. Die Konsole zeigt auch ein Installationsdiagramm nach Tagen an, das hilft, die Testaktivität zu verfolgen.
Die Firebase CLI ermöglicht das Hochladen von Builds mit einem einzigen Befehl, was für die Integration in CI/CD-Pipelines praktisch ist. Der distribute-Befehl akzeptiert einen Dateipfad, ein Projektzugriffstoken, eine Liste von Testergruppen und optionale Versionshinweise. Die Authentifizierung verwendet ein Firebase-Dienstkonto mit der Rolle Firebase App Distribution Admin. Die CLI unterstützt sowohl Android- als auch iOS-Builds und erkennt die Plattform automatisch an der Dateierweiterung.
# Hochladen eines Builds über die Firebase CLI
firebase appdistribution:distribute \
app-release.apk \
--app 1:123456789:android:abc123def456 \
--groups "qa-team,product-owners" \
--release-notes "Autorisierungsfehler behoben" \
--token "FIREBASE_TOKEN"
Firebase App Distribution bietet ein flexibles Testerverwaltungssystem: Sie können Teilnehmer per E-Mail hinzufügen, Gruppen nach Rollen oder Projekten erstellen und verschiedenen Gruppen verschiedene Builds zuweisen. Wenn ein neuer Tester hinzugefügt wird, sendet das System ihm eine Einladungs-E-Mail mit Anweisungen zur Installation der Anwendung. Tester erhalten automatische Benachrichtigungen über jeden neuen Build, der ihrer Gruppe zugewiesen wurde.
Gruppen ermöglichen es, Tester funktional zu organisieren. Beispiele für Gruppen: QA-Team (vollständiger Zugriff auf alle Builds), Product Owners (Zugriff auf stabile Builds), Externe Tester (eingeschränkter Zugriff für externe Beta-Tester). Ein einzelner Tester kann mehreren Gruppen angehören. Beim Hochladen eines Builds wählt der Entwickler die Zielgruppen aus — nur Mitglieder der ausgewählten Gruppen erhalten Benachrichtigungen, was Informationsrauschen vermeidet.
Um Tester programmatisch hinzuzufügen, wird die Firebase App Distribution API verwendet. Die API ermöglicht es, Tester zu erstellen, zu Gruppen hinzuzufügen und bei Bedarf zu löschen. Dies ist praktisch für die Integration mit internen Testmanagementsystemen und Bug-Trackern. Wenn ein Tester über die API hinzugefügt wird, erhält er ebenfalls eine Einladungs-E-Mail mit einem Link zur Installation der ersten Anwendung.
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 zur Gruppe hinzugefügt")
} catch (error) {
console.error("Fehler:", error)
}
}
addTestersToGroup("tester@example.com", "qa-team")
Die Verteilung von Android-Builds über Firebase App Distribution unterstützt zwei Formate: APK und Android App Bundle (AAB). Beim Hochladen eines AAB generiert Firebase automatisch ein mit dem Gerät des Testers kompatibles APK mit Google Play App Signing. Tester installieren die Anwendung über einen direkten Link — sie benötigen keinen Zugriff auf die Google Play Console und müssen nicht als Tester in der Play Console hinzugefügt werden. Dies vereinfacht den Beta-Testprozess für Android erheblich.
Für die Installation über App Distribution müssen Tester die Installation aus unbekannten Quellen auf ihrem Gerät aktivieren. Firebase generiert automatisch einen Link zu einer Webseite mit einem APK-Installationsbutton. Für das AAB-Format muss das Gerät die Play Core Library unterstützen und Google Play Store installiert haben. Firebase empfiehlt, AAB für endgültige Versionen und APK für schnelle Iterationen zu verwenden.
Das Firebase App Distribution Gradle-Plugin ermöglicht das Senden von Builds direkt aus einer Gradle-Aufgabe. Die Konfiguration umfasst das Hinzufügen des Plugins com.google.firebase.appdistribution, das Einrichten eines Dienstkontos und die Konfiguration der Zielgruppen. Nach der Einrichtung erstellt die Aufgabe assembleDistRelease die Anwendung und lädt sie mit einem einzigen Befehl in Firebase App Distribution hoch.
// 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 "Automatischer Build"
}
Die Verteilung von iOS-Builds über Firebase App Distribution erfordert zusätzliche Einrichtung, da Apple die Installation von Anwendungen außerhalb des App Stores einschränkt. Zum Verteilen von iOS-Apps müssen Ad-hoc- oder Enterprise-Zertifikate des Apple Developer Program verwendet werden. Tester müssen als Geräte für die Ad-hoc-Verteilung im Apple Developer Portal hinzugefügt werden oder die Enterprise-Verteilung ohne Gerätebeschränkung verwenden.
Für die Ad-hoc-Verteilung müssen Sie die UDIDs aller Testergeräte sammeln und im Apple Developer Portal hinzufügen. Firebase App Distribution zeigt Testern Anweisungen zum Auffinden ihrer UDID und speichert registrierte Geräte automatisch. Nach dem Hinzufügen der UDID zum Provisioning-Profil und dem Erstellen des IPA erhalten Tester einen Installationslink. Firebase empfiehlt die Verwendung eines Enterprise-Zertifikats für Projekte mit vielen Testern, da Ad-hoc auf 100 Geräte pro Konto beschränkt ist.
Fastlane ist das empfohlene Tool zur Automatisierung von iOS-App-Builds. Die match-Lane verwaltet Zertifikate und Provisioning-Profile, während die sigh-Lane ein IPA zur Verteilung erstellt. Firebase App Distribution integriert sich über das Plugin firebase_app_distribution mit Fastlane, das das IPA hochlädt und Tester benachrichtigt. Fastlane unterstützt auch die Versionsverwaltung und Versionshinweise über zusätzliche 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 vom #\{Time.now.strftime
('%Y-%m-%d %H:%M')}"
)
end
Die vollständige Integration von Firebase App Distribution mit CI/CD ermöglicht die automatische Veröffentlichung neuer Builds bei jedem Commit im Repository. Durch die Einrichtung einer CI-Pipeline erhält das Team Minuten nach einem Code-Push sofortiges Feedback von Testern. App Distribution unterstützt alle gängigen CI-Systeme: GitHub Actions, GitLab CI, Jenkins, Bitrise und CircleCI. Jede Plattform erfordert ihre eigene Konfiguration, aber das allgemeine Prinzip ist dasselbe: Build → Hochladen → Benachrichtigen.
GitHub Actions ermöglicht die Einrichtung der automatischen Build-Verteilung bei Push in den develop-Branch oder bei Erstellung eines Pull-Requests. Der Workflow umfasst die Installation von Java/Flutter/Node.js, das Erstellen der Anwendung, die Authentifizierung über ein Firebase-Dienstkonto und das Ausführen der Firebase CLI mit dem distribute-Befehl. Geheimnisse (Token, Dienstkonten) werden in GitHub Secrets gespeichert und nicht in Build-Protokollen offengelegt. Für iOS ist zusätzlich die Einrichtung von Xcode und die Installation von Fastlane im Workflow erforderlich.
# .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 ist in Firebase Crashlytics integriert, um automatisch Absturzberichte von Testern zu sammeln. Crashlytics verknüpft automatisch einen Absturz mit einer bestimmten Build-Version und einem bestimmten Gerät, was hilft, das Problem schnell zu lokalisieren und zu beheben. Tester können auch Screenshots und Kommentare über die Weboberfläche von App Distribution senden und erhalten nach der Installation des Builds einen Link zum Feedback-Formular.
Häufig gestellte Fragen
Firebase App Distribution ist ein plattformübergreifender Dienst (Android + iOS), anders als TestFlight, das nur für iOS funktioniert. App Distribution ist auch in Crashlytics und Firebase Analytics integriert und bietet ein einheitliches Ökosystem für Beta-Tests auf beiden Plattformen.
Builds werden 150 Tage lang ab dem Upload-Datum gespeichert. Nach diesem Zeitraum werden sie automatisch gelöscht. Es wird empfohlen, regelmäßig neue Builds hochzuladen und veraltete manuell über die Firebase Console zu löschen, um zu verhindern, dass Tester alte Versionen installieren.
Es gibt keine Begrenzung der Anzahl der Tester in Firebase App Distribution. Für die iOS Ad-hoc-Verteilung gilt das Apple-Limit von 100 Geräten pro Konto. Für die Android- und iOS-Enterprise-Verteilung gibt es keine Beschränkungen hinsichtlich der Anzahl der Tester.
Ja, App Distribution unterstützt AAB (Android App Bundle). Firebase generiert automatisch ein APK aus dem AAB für jedes Testergerät mit Google Play App Signing. Dies ist besonders nützlich zum Testen vor der Veröffentlichung im Play Store.
Ja, App Distribution ist im kostenlosen Firebase Spark-Plan enthalten. Grenzen des Spark-Plans: bis zu 500 Tester und 25.000 Installationen pro Monat pro Projekt. Der Blaze-Plan entfernt diese Grenzen und fügt Prioritäts-Support hinzu.
Zusammenfassung
Wir entwickeln eine mobile Applikation schlüsselfertig
IT Sectr entwickelt seit 2017 iOS- und Android-Apps für Startups und Unternehmen. Wir beraten Sie und schlagen die beste Lösung vor.
Lesen Sie auch