Firebase App Distribution — är Googles tjänst för att distribuera preliminära byggen av mobilappar bland testare och interna team utan att behöva publicera dem i appbutiker. App Distribution tillhandahåller ett enhetligt gränssnitt för att ladda upp APK och IPA, hantera testgrupper och samla in feedback. Enligt Firebase Documentation, 2026, meddelar tjänsten automatiskt testare om nya versioner via e-post och push-meddelanden, och Fastlane-integration gör det möjligt att publicera byggen direkt från CI/CD-pipeline utan manuella åtgärder. App Distribution stöder både Android (AAB/APK) och iOS (IPA), inklusive ad-hoc- och enterprise-distribution.
Huvudpunkter
Firebase App Distribution — är Googles tjänst för att distribuera förhandsversioner av mobilappar bland testare och intressenter. Till skillnad från publicering i appbutiker gör App Distribution det möjligt att omedelbart leverera byggen till utvalda deltagare utan en lång granskningsprocess. Tjänsten är integrerad med Firebase Crashlytics, vilket gör att utvecklare kan få kraschrapporter direkt från testare och åtgärda problem före offentlig lansering.
Den traditionella processen för att distribuera betaversioner innefattar manuell sändning av APK/IPA via e-post, uppladdning till externa filservrar eller konfigurering av en egen server. Firebase App Distribution löser dessa problem: enhetligt byggförråd i Google Cloud, automatiska testarmeddelanden, centraliserad åtkomsthantering och inbyggd feedback via Firebase Crashlytics. Tjänsten är oumbärlig för team som använder CI/CD och regelbundna lanseringar: ett nytt bygge är tillgängligt för testare inom en minut efter uppladdning.
App Distribution stöder alla standardbyggformat för mobila plattformar. För Android — APK och Android App Bundle (AAB) med automatisk generering av APK från AAB vid installation. För iOS — IPA-filer för ad-hoc-, development- och enterprise-distribution. Varje bygge åtföljs av versionsinformation (release notes), versionsnummer och byggkod för spårning. Den maximala filstorleken för uppladdning är 500 MB, lagringstiden för byggen är 150 dagar.
Ladda upp byggen till Firebase App Distribution sker via Firebase Console, CLI (firebase appdistribution:distribute) eller automatiserade verktyg som Fastlane och Gradle. Vid uppladdning anges byggversion, versionsinformation och lista över testare eller grupper som ska få meddelande. Firebase tilldelar automatiskt bygget en unik identifierare och gör det tillgängligt för installation via en länk.
Firebase Console tillhandahåller ett webbgränssnitt för uppladdning av byggen och versionshantering. I konsolen visas historiken för alla uppladdade byggen med datum, version, status och antal installationer. Utvecklaren kan inaktivera en specifik version om ett kritiskt fel upptäcks — detta blockerar möjligheten att installera versionen för alla testare. Konsolen visar också ett diagram över installationer per dag, vilket hjälper till att följa testaktiviteten.
Firebase CLI gör det möjligt att ladda upp byggen med ett enda kommando, vilket är praktiskt för integration i CI/CD-pipelines. Kommandot distribute accepterar sökvägen till filen, projektets åtkomsttoken, listan över testgrupper och valfria versionsinformation. För autentisering används ett Firebase-tjänstkonto med rollen Firebase App Distribution Admin. CLI stöder både Android- och iOS-byggen och bestämmer automatiskt plattformen baserat på filtillägget.
# Ladda upp bygge via Firebase CLI
firebase appdistribution:distribute \
app-release.apk \
--app 1:123456789:android:abc123def456 \
--groups "qa-team,product-owners" \
--release-notes "Auktoriseringsfel åtgärdat" \
--token "FIREBASE_TOKEN"
Firebase App Distribution tillhandahåller ett flexibelt system för testarhantering: deltagare kan läggas till via e-post, grupper kan skapas efter roller eller projekt och olika byggen kan tilldelas olika grupper. När en ny testare läggs till skickar systemet ett inbjudningsmail med installationsinstruktioner. Testare får automatiska meddelanden om varje nytt bygge som tilldelats deras grupp.
Grupper gör det möjligt att organisera testare enligt funktionell princip. Exempel på grupper: QA-team (full åtkomst till alla byggen), Product Owners (åtkomst till stabila byggen), External Testers (begränsad åtkomst för externa betatestare). En testare kan vara medlem i flera grupper. Vid uppladdning av ett bygge väljer utvecklaren målgrupper — endast medlemmar i de valda grupperna får meddelanden, vilket eliminerar informationsbrus.
För programmerad tilläggning av testare används Firebase App Distribution API. API:et gör det möjligt att skapa testare, lägga till dem i grupper och ta bort dem vid behov. Detta är praktiskt vid integration med interna testhanteringssystem och buggspårare. När en testare läggs till via API får han också ett inbjudningsmail med en länk för att installera den första appen.
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("Testare tillagd i grupp")
} catch (error) {
console.error("Fel:", error)
}
}
addTestersToGroup("tester@example.com", "qa-team")
Distribuera Android-byggen via Firebase App Distribution stöder två format: APK och Android App Bundle (AAB). Vid uppladdning av AAB genererar Firebase automatiskt APK som är kompatibelt med testarens enhet med hjälp av Google Play App Signing. Testare installerar appen via en direkt länk — de behöver inte åtkomst till Google Play Console och behöver inte läggas till som testare i Play Console. Detta förenklar betatestningsprocessen för Android avsevärt.
För installation via App Distribution måste testare aktivera installation från okända källor på enheten. Firebase genererar automatiskt en länk till en webbsida med en APK-installationsknapp. För AAB-format måste enheten stödja Play Core Library och ha Google Play Store installerat. Firebase rekommenderar att använda AAB för slutliga versioner och APK för snabba iterationer.
Firebase App Distribution-plugin för Gradle gör det möjligt att skicka byggen direkt från en Gradle-uppgift. Konfigurationen omfattar att lägga till plugin-programmet com.google.firebase.appdistribution, konfigurera ett tjänstkonto och ställa in målgrupper. Efter konfiguration kommer uppgiften assembleDistRelease att bygga appen och ladda upp den till Firebase App Distribution med ett enda kommando.
// 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 "Automatiskt bygge"
}
Distribuera iOS-byggen via Firebase App Distribution kräver ytterligare konfiguration eftersom Apple begränsar installation av appar utanför App Store. För distribution av iOS-appar måste ad-hoc- eller enterprise-certifikat från Apple Developer Program användas. Testare måste läggas till i Apple Developer Portal som enheter för ad-hoc-distribution eller använda enterprise-distribution utan enhetsbegränsning.
För ad-hoc-distribution måste UDID för alla testarenheter samlas in och läggas till i Apple Developer Portal. Firebase App Distribution visar testare instruktioner för att hitta UDID och sparar automatiskt registrerade enheter. Efter att UDID har lagts till i en provisioning profile och IPA har byggts får testare en installationslänk. Firebase rekommenderar att använda enterprise-certifikat för projekt med många testare eftersom ad-hoc är begränsat till 100 enheter per konto.
Fastlane — det rekommenderade verktyget för att automatisera byggandet av iOS-appar. Lane match hanterar certifikat och provisioning profiles, och lane sigh skapar IPA för distribution. Firebase App Distribution integreras med Fastlane via plugin-programmet firebase_app_distribution, som laddar upp IPA och meddelar testare. Fastlane stöder också versionshantering och versionsinformation via ytterligare plugin-program.
# 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: "Bygg från #\{Time.now.strftime
('%Y-%m-%d %H:%M')}"
)
end
Full integration av Firebase App Distribution med CI/CD möjliggör automatisk publicering av nya byggen vid varje commit i arkivet. Genom att konfigurera en CI-pipeline får teamet omedelbar feedback från testare inom några minuter efter kodpush. App Distribution stöder alla populära CI-system: GitHub Actions, GitLab CI, Jenkins, Bitrise och CircleCI. För varje plattform krävs egen konfiguration, men den allmänna principen är densamma: bygga → ladda upp → meddela.
GitHub Actions gör det möjligt att konfigurera automatisk byggdistribution vid push till develop-grenen eller skapande av pull request. Arbetsflödet omfattar installation av Java/Flutter/Node.js, byggande av appen, autentisering via Firebase Service Account och körning av Firebase CLI med kommandot distribute. Hemligheter (tokens, tjänstkonton) lagras i GitHub Secrets och avslöjas inte i byggloggar. För iOS krävs ytterligare konfiguration av Xcode och installation av Fastlane i arbetsflödet.
# .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 integreras med Firebase Crashlytics för automatisk insamling av kraschrapporter från testare. Crashlytics associerar automatiskt en krasch med en specifik byggversion och enhet, vilket hjälper till att snabbt lokalisera och åtgärda problemet. Testare kan också skicka skärmdumpar och kommentarer via webbgränssnittet i App Distribution och får en länk till feedbackformuläret efter installation av bygget.
Vanliga frågor
Firebase App Distribution — är en plattformsoberoende tjänst (Android + iOS), till skillnad från TestFlight som bara fungerar för iOS. App Distribution integreras också med Crashlytics och Firebase Analytics och ger ett enhetligt ekosystem för betatestning på båda plattformarna.
Byggen lagras i 150 dagar från tidpunkten för uppladdning. Efter denna period tas de bort automatiskt. Det rekommenderas att regelbundet ladda upp nya byggen och manuellt ta bort föråldrade via Firebase Console så att testare inte installerar gamla versioner.
Det finns ingen gräns för antalet testare i Firebase App Distribution. För iOS ad-hoc-distribution gäller Apples gräns på 100 enheter per konto. För Android och iOS enterprise-distribution finns inga begränsningar för antalet testare.
Ja, App Distribution stöder AAB (Android App Bundle). Firebase genererar automatiskt APK från AAB för varje testarenhet med Google Play App Signing. Detta är särskilt praktiskt för testning före publicering i Play Store.
Ja, App Distribution ingår i Firebases kostnadsfria Spark-plan. Spark-begränsningar: upp till 500 testare och 25 000 installationer per månad per projekt. Blaze-planen tar bort dessa begränsningar och lägger till prioriterad support.
Sammanfattning
Vi utvecklar en mobil applikation nyckelfärdigt
IT Sectr skapar iOS- och Android-applikationer för startups och företag sedan 2017. Vi ger dig råd och föreslår den bästa lösningen.
Läs också