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
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.
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.
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 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.
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.
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.
# 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"
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.
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.
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.
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 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.
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.
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.
// 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 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.
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.
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.
# 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
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.
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.
# .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
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
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.
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.
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.
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.
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
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.
Basahin din