Firebase App Distribution: mga pangunahing konsepto, pamamahagi ng APK at IPA, at configuration

May-akda: IT Sectr Nai-publish: 2026-04-29 Oras ng pagbabasa: 8 min

Firebase App Distribution — ay serbisyo ng Google para sa pamamahagi ng mga paunang build ng mobile application sa mga tester at internal team nang hindi kailangan i-publish ang mga ito sa mga app store. Nagbibigay ang App Distribution ng pinag-isang interface para sa pag-upload ng APK at IPA, pamamahala ng mga grupo ng tester, at pagkolekta ng feedback. Ayon sa Firebase Documentation, 2026, awtomatikong nag-aabiso ang serbisyo sa mga tester tungkol sa mga bagong bersyon sa pamamagitan ng email at push notification, at ang Fastlane integration ay nagpapahintulot sa pag-publish ng mga build nang direkta mula sa CI/CD pipeline nang walang manu-manong pagkilos. Sinusuportahan ng App Distribution ang Android (AAB/APK) at iOS (IPA), kabilang ang ad-hoc at enterprise distribution.

Mga pangunahing punto

  • App Distribution — serbisyo ng Firebase para sa pamamahagi ng mga beta na bersyon ng mga application sa mga tester nang walang pag-publish sa Google Play at App Store.
  • Mga grupo ng tester — flexible na sistema ng pamamahala ng access: gumawa ng mga grupo ayon sa mga tungkulin, proyekto, o yugto ng pagsubok na may iba't ibang pahintulot para sa mga build.
  • Awtomatikong notification — ang mga tester ay tumatanggap ng email at push notification sa bawat bagong build na may link sa pag-install.
  • Fastlane + Gradle — kumpletong integrasyon sa mga CI/CD system para sa awtomatikong pag-publish ng mga build sa bawat commit o pull request.
  • Feedback — ang mga tester ay maaaring magpadala ng mga screenshot, log, at komento sa pamamagitan ng built-in na interface o Firebase Crashlytics.

Ano ang Firebase App Distribution

Firebase App Distribution — ay serbisyo ng Google para sa pamamahagi ng mga pre-release na bersyon ng mobile application sa mga tester at stakeholder. Hindi tulad ng pag-publish sa mga app store, pinapayagan ng App Distribution ang agarang paghahatid ng mga build sa mga piling kalahok nang walang mahabang proseso ng pagsusuri. Ang serbisyo ay isinama sa Firebase Crashlytics, na nagpapahintulot sa mga developer na makatanggap ng mga ulat ng crash nang direkta mula sa mga tester at ayusin ang mga problema bago ang pampublikong release.

Bakit kailangan ang App Distribution

Ang tradisyonal na proseso ng pamamahagi ng mga beta na bersyon ay kinabibilangan ng manu-manong pagpapadala ng APK/IPA sa pamamagitan ng email, pag-upload sa mga third-party file server, o pag-set up ng sariling server. Firebase App Distribution ay lumulutas sa mga problemang ito: pinag-isang imbakan ng build sa Google Cloud, awtomatikong notification ng tester, sentralisadong pamamahala ng access, at built-in na feedback sa pamamagitan ng Firebase Crashlytics. Ang serbisyo ay kailangang-kailangan para sa mga team na nagsasagawa ng CI/CD at regular na release: isang bagong build ay available sa mga tester isang minuto pagkatapos ng pag-upload.

Mga suportadong format ng build

Sinusuportahan ng App Distribution ang lahat ng karaniwang format ng build para sa mga mobile platform. Para sa Android — APK at Android App Bundle (AAB) na may awtomatikong pagbuo ng APK mula sa AAB sa pag-install. Para sa iOS — mga IPA file para sa ad-hoc, development, at enterprise distribution. Ang bawat build ay may kasamang release notes, numero ng bersyon, at build code para sa pagsubaybay. Ang maximum na laki ng file para sa pag-upload ay 500 MB, ang panahon ng pag-iimbak ng build ay 150 araw.

Pag-upload ng mga build at pamamahala ng bersyon

Pag-upload ng mga build sa Firebase App Distribution ay ginagawa sa pamamagitan ng Firebase Console, CLI (firebase appdistribution:distribute) o mga automated na tool tulad ng Fastlane at Gradle. Sa pag-upload, tinutukoy ang bersyon ng build, release notes, at listahan ng mga tester o grupo na dapat makatanggap ng notification. Awtomatikong nagtatalaga ang Firebase ng natatanging identifier sa build at ginagawa itong available para sa pag-install sa pamamagitan ng link.

Pamamahala ng bersyon sa pamamagitan ng Firebase Console

Ang Firebase Console ay nagbibigay ng web interface para sa pag-upload ng mga build at pamamahala ng bersyon. Sa console ay ipinapakita ang kasaysayan ng lahat ng na-upload na build na may petsa, bersyon, status, at bilang ng mga installation. Ang developer ay maaaring huwag paganahin ang isang partikular na bersyon kung may natuklasang kritikal na error — ito ay hahadlang sa posibilidad ng pag-install ng bersyon para sa lahat ng tester. Ipinapakita rin ng console ang graph ng mga installation ayon sa araw, na tumutulong sa pagsubaybay ng aktibidad ng pagsubok.

Awtomatikong pag-upload sa pamamagitan ng Firebase CLI

Ang Firebase CLI ay nagpapahintulot sa pag-upload ng mga build sa isang utos, na maginhawa para sa integrasyon sa mga CI/CD pipeline. Ang distribute command ay tumatanggap ng path ng file, project access token, listahan ng mga grupo ng tester, at opsyonal na release notes. Para sa authentication, ginagamit ang Firebase service account na may tungkuling Firebase App Distribution Admin. Sinusuportahan ng CLI ang parehong Android at iOS build, awtomatikong tinutukoy ang platform batay sa extension ng file.

bash
# Pag-upload ng build sa pamamagitan ng Firebase CLI
firebase appdistribution:distribute \
    app-release.apk \
    --app 1:123456789:android:abc123def456 \
    --groups "qa-team,product-owners" \
    --release-notes "Naayos ang bug sa awtorisasyon" \
    --token "FIREBASE_TOKEN"

Pamamahala ng mga tester at grupo

Firebase App Distribution ay nagbibigay ng flexible na sistema ng pamamahala ng tester: ang mga kalahok ay maaaring idagdag sa pamamagitan ng email, ang mga grupo ay maaaring gawin ayon sa mga tungkulin o proyekto, at ang iba't ibang build ay maaaring italaga sa iba't ibang grupo. Kapag nagdagdag ng bagong tester, ang sistema ay nagpapadala sa kanya ng email ng imbitasyon na may mga tagubilin sa pag-install ng application. Ang mga tester ay tumatanggap ng awtomatikong notification tungkol sa bawat bagong build na nakatalaga sa kanilang grupo.

Paglikha ng mga grupo ng tester

Ang mga grupo ay nagpapahintulot sa pag-aayos ng mga tester ayon sa functional na prinsipyo. Mga halimbawa ng grupo: QA team (buong access sa lahat ng build), Product Owners (access sa stable na build), External Testers (limitadong access para sa panlabas na beta tester). Ang isang tester ay maaaring maging miyembro ng maraming grupo. Sa pag-upload ng build, pinipili ng developer ang mga target na grupo — ang mga notification ay matatanggap lamang ng mga miyembro ng mga napiling grupo, na nag-aalis ng ingay ng impormasyon.

Pagdaragdag ng mga tester sa pamamagitan ng API

Para sa programmatic na pagdaragdag ng mga tester, ginagamit ang Firebase App Distribution API. Ang API ay nagpapahintulot sa paglikha ng mga tester, pagdaragdag sa kanila sa mga grupo, at pagtanggal kung kinakailangan. Ito ay maginhawa para sa integrasyon sa mga internal na sistema ng pamamahala ng pagsubok at bug tracker. Kapag nagdagdag ng tester sa pamamagitan ng API, siya rin ay tumatanggap ng email ng imbitasyon na may link sa pag-install ng unang application.

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("Idinagdag ang tester sa grupo")
    } catch (error) {
        console.error("Error:", error)
    }
}

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

Pamamahagi ng mga Android build

Pamamahagi ng mga Android build sa pamamagitan ng Firebase App Distribution ay sumusuporta sa dalawang format: APK at Android App Bundle (AAB). Kapag nag-upload ng AAB, awtomatikong bubuo ang Firebase ng APK na tugma sa device ng tester, gamit ang Google Play App Signing. Ang mga tester ay nag-i-install ng application sa pamamagitan ng direktang link — hindi nila kailangan ng access sa Google Play Console at hindi kailangang idagdag bilang tester sa Play Console. Ito ay makabuluhang nagpapasimple sa proseso ng beta testing para sa Android.

Mga kinakailangan para sa Android build

Para sa pag-install sa pamamagitan ng App Distribution, ang mga tester ay dapat paganahin ang pag-install mula sa hindi kilalang mga source sa device. Awtomatikong bubuo ang Firebase ng link patungo sa web page na may button sa pag-install ng APK. Para sa AAB format, ang device ay dapat sumuporta sa Play Core Library at may naka-install na Google Play Store. Inirerekomenda ng Firebase ang paggamit ng AAB para sa mga huling bersyon at APK para sa mabilis na iteration.

Configuration ng Gradle para sa App Distribution

Ang Firebase App Distribution plugin para sa Gradle ay nagpapahintulot sa pagpapadala ng mga build nang direkta mula sa Gradle task. Ang configuration ay kinabibilangan ng pagdaragdag ng plugin na com.google.firebase.appdistribution, configuration ng service account, at pagtatakda ng mga target na grupo. Pagkatapos ng configuration, ang assembleDistRelease task ay bubuo ng application at ia-upload ito sa Firebase App Distribution sa isang utos.

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 "Awtomatikong build"
}

Pamamahagi ng mga iOS build

Pamamahagi ng mga iOS build sa pamamagitan ng Firebase App Distribution ay nangangailangan ng karagdagang configuration, dahil nililimitahan ng Apple ang pag-install ng mga application sa labas ng App Store. Para sa pamamahagi ng mga iOS application, kinakailangang gumamit ng ad-hoc o enterprise na mga sertipiko mula sa Apple Developer Program. Ang mga tester ay dapat idagdag sa Apple Developer Portal bilang mga device para sa ad-hoc distribution, o gumamit ng enterprise distribution na walang limitasyon sa device.

Configuration ng ad-hoc distribution

Para sa ad-hoc distribution, ang mga UDID ng lahat ng device ng tester ay dapat kolektahin at idagdag sa Apple Developer Portal. Ang Firebase App Distribution ay nagpapakita sa mga tester ng mga tagubilin para sa paghahanap ng UDID at awtomatikong nag-iimbak ng mga rehistradong device. Pagkatapos idagdag ang UDID sa provisioning profile at pagbuo ng IPA, ang mga tester ay tumatanggap ng link sa pag-install. Inirerekomenda ng Firebase ang paggamit ng enterprise certificate para sa mga proyektong may maraming tester, dahil ang ad-hoc ay limitado sa 100 device bawat account.

Pagbuo ng IPA sa pamamagitan ng Fastlane

Fastlane — ang inirerekomendang tool para sa pag-automate ng pagbuo ng mga iOS application. Ang Lane match ay namamahala ng mga sertipiko at provisioning profile, at ang lane sigh ay lumilikha ng IPA para sa pamamahagi. Ang Firebase App Distribution ay isinasama sa Fastlane sa pamamagitan ng firebase_app_distribution plugin, na nag-uupload ng IPA at nag-aabiso sa mga tester. Sinusuportahan din ng Fastlane ang pamamahala ng bersyon at release notes sa pamamagitan ng mga karagdagang plugin.

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

Integrasyon sa CI/CD at Fastlane

Kumpletong integrasyon ng Firebase App Distribution sa CI/CD ay nagpapahintulot sa awtomatikong pag-publish ng mga bagong build sa bawat commit sa repository. Sa pag-configure ng CI pipeline, ang team ay tumatanggap ng instant feedback mula sa mga tester sa loob ng ilang minuto pagkatapos ng push ng code. Sinusuportahan ng App Distribution ang lahat ng sikat na CI system: GitHub Actions, GitLab CI, Jenkins, Bitrise, at CircleCI. Para sa bawat platform ay kinakailangan ang sariling configuration, ngunit ang pangkalahatang prinsipyo ay pareho: build → upload → notification.

Configuration sa pamamagitan ng GitHub Actions

Ang GitHub Actions ay nagpapahintulot sa configuration ng awtomatikong pamamahagi ng build sa push sa develop branch o paglikha ng pull request. Ang workflow ay kinabibilangan ng pag-install ng Java/Flutter/Node.js, pagbuo ng application, authentication sa pamamagitan ng Firebase Service Account, at pagpapatakbo ng Firebase CLI gamit ang distribute command. Ang mga lihim (token, service account) ay iniimbak sa GitHub Secrets at hindi isinasalaysay sa build logs. Para sa iOS, karagdagang configuration ng Xcode at pag-install ng Fastlane sa workflow ay kinakailangan.

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

Pagkolekta ng feedback

Ang Firebase App Distribution ay isinasama sa Firebase Crashlytics para sa awtomatikong pagkolekta ng mga ulat ng crash mula sa mga tester. Awtomatikong iniuugnay ng Crashlytics ang crash sa partikular na bersyon ng build at device, na tumutulong sa mabilis na pag-localize at pag-ayos ng problema. Ang mga tester ay maaari ring magpadala ng mga screenshot at komento sa pamamagitan ng web interface ng App Distribution, na tumatanggap ng link sa feedback form pagkatapos ng pag-install ng build.

Mga madalas itanong

Paano naiiba ang App Distribution sa TestFlight?

Firebase App Distribution — ay isang cross-platform na serbisyo (Android + iOS), hindi tulad ng TestFlight na gumagana lamang para sa iOS. Ang App Distribution ay isinasama rin sa Crashlytics at Firebase Analytics, na nagbibigay ng pinag-isang ecosystem para sa beta testing sa parehong platform.

Gaano katagal iniimbak ang mga build sa App Distribution?

Ang mga build ay iniimbak ng 150 araw mula sa sandali ng pag-upload. Pagkatapos ng panahong ito, awtomatiko silang tatanggalin. Inirerekomenda na regular na mag-upload ng mga bagong build at manu-manong tanggalin ang mga luma sa pamamagitan ng Firebase Console, upang hindi mag-install ang mga tester ng mga lumang bersyon.

Ilang tester ang maaaring idagdag?

Walang limitasyon sa bilang ng mga tester sa Firebase App Distribution. Para sa iOS ad-hoc distribution, nalalapat ang Apple limit na 100 device bawat account. Para sa Android at iOS enterprise distribution, walang mga limitasyon sa bilang ng mga tester.

Maaari bang mag-upload ng AAB sa halip na APK para sa Android?

Oo, sinusuportahan ng App Distribution ang AAB (Android App Bundle). Awtomatikong bubuo ang Firebase ng APK mula sa AAB para sa bawat device ng tester gamit ang Google Play App Signing. Ito ay lalong maginhawa para sa pagsubok bago ang pag-publish sa Play Store.

Libre ba ang Firebase App Distribution?

Oo, ang App Distribution ay kasama sa libreng Spark plan ng Firebase. Mga limitasyon ng Spark: hanggang 500 tester at 25,000 installation bawat buwan bawat proyekto. Ang Blaze plan ay nag-aalis ng mga limitasyong ito at nagdaragdag ng priyoridad na suporta.

Buod

  • Firebase App Distribution — serbisyo para sa pamamahagi ng beta build ng mga mobile application na may suporta para sa Android (APK/AAB) at iOS (IPA) nang walang pag-publish sa mga tindahan.
  • Pamamahala ng tester — flexible na sistema ng grupo na may awtomatikong email at push notification sa bawat bagong build.
  • Pag-upload ng build ay ginagawa sa pamamagitan ng Firebase Console, CLI, Gradle plugin, o Fastlane na may awtomatikong notification sa mga tester.
  • Android build ay sumusuporta sa APK at AAB na may awtomatikong pagbuo ng APK mula sa AAB, pag-install sa pamamagitan ng direktang link nang walang Google Play Console.
  • iOS build ay nangangailangan ng ad-hoc o enterprise Apple certificate, na may suporta para sa UDID registration at Fastlane para sa automation ng pagbuo ng IPA.
  • CI/CD integrasyon — GitHub Actions, GitLab CI, Jenkins, Bitrise na may Firebase CLI o Fastlane para sa awtomatikong pag-publish sa bawat push.
  • Libre hanggang 500 tester at 25,000 installation bawat buwan, build ay iniimbak ng 150 araw, isinama sa Firebase Crashlytics para sa pagkolekta ng mga ulat ng crash.

Gagawa kami ng mobile application na turnkey

Gumagawa ang IT Sectr ng mga iOS at Android application para sa mga startup at negosyo mula noong 2017. Magpapayo kami sa iyo at magmumungkahi ng pinakamahusay na solusyon.

Pag-usapan ang proyekto

Basahin din