Firebase App Distribution: nyckelbegrepp, distribution av APK och IPA och konfiguration

Författare: IT Sectr Publicerad: 2026-04-29 Lästid: 8 min

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

  • App Distribution — Firebase-tjänst för distribution av betaversioner av appar bland testare utan publicering i Google Play och App Store.
  • Testgrupper — flexibelt åtkomsthanteringssystem: skapa grupper efter roller, projekt eller testfaser med olika behörigheter för byggen.
  • Automatiska meddelanden — testare får e-post och push-meddelanden vid varje nytt bygge med installationslänk.
  • Fastlane + Gradle — full integration med CI/CD-system för automatisk publicering av byggen vid varje commit eller pull request.
  • Feedback — testare kan skicka skärmdumpar, loggar och kommentarer via det inbyggda gränssnittet eller Firebase Crashlytics.

Vad är Firebase App Distribution

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.

Varför App Distribution behövs

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.

Byggformat som stöds

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 och versionshantering

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.

Versionshantering via Firebase Console

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.

Automatisk uppladdning via Firebase CLI

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.

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

Hantera testare och grupper

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.

Skapa testgrupper

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.

Lägga till testare via API

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.

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("Testare tillagd i grupp")
    } catch (error) {
        console.error("Fel:", error)
    }
}

addTestersToGroup("tester@example.com", "qa-team")

Distribuera Android-byggen

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.

Krav för Android-byggen

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.

Konfigurera Gradle för App Distribution

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.

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 "Automatiskt bygge"
}

Distribuera iOS-byggen

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.

Konfigurera ad-hoc-distribution

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.

Bygga IPA via Fastlane

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.

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: "Bygg från #\{Time.now.strftime
            ('%Y-%m-%d %H:%M')}"
    )
end

Integration med CI/CD och Fastlane

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.

Konfigurera via GitHub Actions

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.

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

Samla in feedback

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

Hur skiljer sig App Distribution från TestFlight?

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.

Hur länge lagras byggen i App Distribution?

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.

Hur många testare kan läggas till?

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.

Kan AAB laddas upp istället för APK för Android?

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.

Är Firebase App Distribution gratis?

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

  • Firebase App Distribution — tjänst för distribution av betabyggen av mobilappar med stöd för Android (APK/AAB) och iOS (IPA) utan publicering i butiker.
  • Testarhantering — flexibelt gruppsystem med automatiska e-post- och push-meddelanden vid varje nytt bygge.
  • Uppladdning av byggen sker via Firebase Console, CLI, Gradle-plugin eller Fastlane med automatisk testarmeddelande.
  • Android-byggen stöder APK och AAB med automatisk APK-generering från AAB, installation via direkt länk utan Google Play Console.
  • iOS-byggen kräver ad-hoc- eller enterprise Apple-certifikat, med stöd för UDID-registrering och Fastlane för automatisering av IPA-bygge.
  • CI/CD-integration — GitHub Actions, GitLab CI, Jenkins, Bitrise med Firebase CLI eller Fastlane för automatisk publicering vid varje push.
  • Gratis upp till 500 testare och 25 000 installationer per månad, byggen lagras i 150 dagar, integrerat med Firebase Crashlytics för insamling av kraschrapporter.

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.

Diskutera projektet

Läs också