Firebase App Distribution: əsas anlayışlar, APK və IPA paylanması və quraşdırma

Müəllif: IT Sectr Dərc olunub: 2026-04-29 Oxuma vaxtı: 8 dəq

Firebase App Distribution — mobil tətbiqlərin ilkin qurğularını testerlər və daxili komandalar arasında yaymaq üçün Google xidmətidir. App Distribution APK və IPA yükləmək, tester qruplarını idarə etmək və rəy toplamaq üçün vahid interfeys təmin edir. Firebase Documentation, 2026-ya görə, xidmət e-poçt və push bildirişləri vasitəsilə testerlərə yeni versiyalar barədə avtomatik məlumat verir, Fastlane inteqrasiyası isə qurğuları birbaşa CI/CD boru kəmərindən əl ilə əməliyyat olmadan yayımlamağa imkan verir. App Distribution həm Android (AAB/APK), həm də iOS (IPA) daxil olmaqla ad-hoc və enterprise paylanmasını dəstəkləyir.

Əsas məqamlar

  • App Distribution — Google Play və App Store-da dərc etmədən tətbiqlərin beta versiyalarını testerlər arasında yaymaq üçün Firebase xidmətidir.
  • Tester qrupları — rollar, layihələr və ya test mərhələləri üzrə qruplar yaratmaqla çevik giriş idarəetmə sistemi.
  • Avtomatik bildirişlər — testerlər hər yeni qurğuda quraşdırma linki ilə e-poçt və push bildirişləri alır.
  • Fastlane + Gradle — hər commit və ya pull request zamanı qurğuların avtomatik yayımlanması üçün CI/CD sistemləri ilə tam inteqrasiya.
  • Rəy bildirmə — testerlər daxili interfeys və ya Firebase Crashlytics vasitəsilə ekran görüntüləri, jurnallar və şərhlər göndərə bilər.

Firebase App Distribution nədir

Firebase App Distribution — mobil tətbiqlərin ilkin versiyalarını testerlər və maraqlı tərəflər arasında yaymaq üçün Google xidmətidir. Tətbiq mağazalarında dərc etməkdən fərqli olaraq, App Distribution seçilmiş iştirakçılara qurğuları dərhal, uzun rəy prosesi olmadan çatdırmağa imkan verir. Xidmət Firebase Crashlytics ilə inteqrasiya olunub ki, bu da tərtibatçılara testerlərdən birbaşa çökmə hesabatları almağa və ictimai buraxılışdan əvvəl problemləri düzəltməyə imkan verir.

App Distribution nə üçün lazımdır

Beta versiyalarının yayılmasının ənənəvi prosesi APK/IPA-nın e-poçtla əl ilə göndərilməsini, üçüncü tərəf fayl paylaşıcılarına yüklənməsini və ya öz serverinin qurulmasını əhatə edir. Firebase App Distribution bu problemləri həll edir: Google Cloud-da vahid qurğu anbarı, testerlərə avtomatik bildirişlər, mərkəzləşdirilmiş giriş idarəetməsi və Firebase Crashlytics vasitəsilə daxili rəy. Xidmət CI/CD və müntəzəm buraxılışları tətbiq edən komandalar üçün əvəzolunmazdır: yeni qurğu yükləmədən bir dəqiqə sonra testerlər üçün əlçatan olur.

Dəstəklənən qurğu formatları

App Distribution mobil platformalar üçün bütün standart qurğu formatlarını dəstəkləyir. Android üçün — APK və Android App Bundle (AAB) quraşdırma zamanı AAB-dan avtomatik APK generasiyası ilə. iOS üçün — ad-hoc, development və enterprise paylanması üçün IPA faylları. Hər qurğuya buraxılış qeydləri (release notes), versiya nömrəsi və izləmə üçün qurğu kodu əlavə olunur. Yüklənən faylın maksimum ölçüsü 500 MB, qurğuların saxlanma müddəti — 150 gündür.

Qurğuların yüklənməsi və versiyaların idarə edilməsi

Qurğuların yüklənməsi Firebase App Distribution-a Firebase Console, CLI (firebase appdistribution:distribute) və ya Fastlane və Gradle kimi avtomatlaşdırılmış alətlər vasitəsilə həyata keçirilir. Yükləmə zamanı qurğunun versiyası, buraxılış qeydləri və bildiriş almalı olan testerlər və ya qrupların siyahısı göstərilir. Firebase avtomatik olaraq qurğuya unikal identifikator təyin edir və onu link vasitəsilə quraşdırma üçün əlçatan edir.

Firebase Console vasitəsilə versiyaların idarə edilməsi

Firebase Console qurğuların yüklənməsi və versiyaların idarə edilməsi üçün veb interfeys təqdim edir. Konsolda göstərilir tarix, versiya, status və quraşdırma sayı ilə bütün yüklənmiş qurğuların tarixçəsi. Tərtibatçı kritik səhv aşkar edilərsə, müəyyən versiyanı söndürə bilər — bu, versiyanın bütün testerlər tərəfindən quraşdırılmasını bloklayır. Konsol həmçinin test fəallığını izləməyə kömək edən günlər üzrə quraşdırma qrafikini göstərir.

Firebase CLI vasitəsilə avtomatik yükləmə

Firebase CLI qurğuları bir əmrlə yükləməyə imkan verir ki, bu da CI/CD boru kəmərlərinə inteqrasiya üçün əlverişlidir. distribute əmri fayl yolunu, layihə giriş tokenini, tester qruplarının siyahısını və isteğe bağlı buraxılış qeydlərini qəbul edir. Doğrulama üçün Firebase App Distribution Admin rolu ilə Firebase xidmət hesabı istifadə olunur. CLI həm Android, həm də iOS qurğularını dəstəkləyir, platformanı fayl genişlənməsinə əsasən avtomatik təyin edir.

bash
# Qurğunun Firebase CLI vasitəsilə yüklənməsi
firebase appdistribution:distribute \
    app-release.apk \
    --app 1:123456789:android:abc123def456 \
    --groups "qa-team,product-owners" \
    --release-notes "Avtorizasiya xətası düzəldildi" \
    --token "FIREBASE_TOKEN"

Testerlərin və qrupların idarə edilməsi

Firebase App Distribution çevik tester idarəetmə sistemi təmin edir: iştirakçıları e-poçtla əlavə etmək, rollar və ya layihələr üzrə qruplar yaratmaq və müxtəlif qurğuları müxtəlif qruplara təyin etmək olar. Yeni tester əlavə edildikdə sistem ona tətbiqin quraşdırılması təlimatı ilə dəvət məktubu göndərir. Testerlər qrupuna təyin edilmiş hər yeni qurğu barədə avtomatik bildirişlər alır.

Tester qruplarının yaradılması

Qruplar testerləri funksional prinsip üzrə təşkil etməyə imkan verir. Qrup nümunələri: QA komandası (bütün qurğulara tam giriş), Product Owners (sabit qurğulara giriş), External Testers (xarici beta testerlər üçün məhdud giriş). Bir tester bir neçə qrupa daxil ola bilər. Qurğu yüklənərkən tərtibatçı hədəf qrupları seçir — bildirişləri yalnız seçilmiş qrupların üzvləri alır ki, bu da məlumat səs-küyünü aradan qaldırır.

API vasitəsilə testerlərin əlavə edilməsi

Testerlərin proqram vasitəsilə əlavə edilməsi üçün Firebase App Distribution API istifadə olunur. API imkan verir testerlər yaratmaq, onları qruplara əlavə etmək və lazım olduqda silmək. Bu, daxili test idarəetmə sistemləri və bug tracker-lərlə inteqrasiya zamanı əlverişlidir. API vasitəsilə tester əlavə edildikdə o, həmçinin ilk tətbiqin quraşdırılması linki ilə dəvət məktubu alır.

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("Tester qrupa əlavə edildi")
    } catch (error) {
        console.error("Xəta:", error)
    }
}

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

Android qurğularının paylanması

Android qurğularının paylanması Firebase App Distribution vasitəsilə iki formatı dəstəkləyir: APK və Android App Bundle (AAB). AAB yüklənərkən Firebase Google Play App Signing istifadə edərək testerin cihazına uyğun APK-nı avtomatik generasiya edir. Testerlər tətbiqi birbaşa link vasitəsilə quraşdırır — onlara Google Play Console-a giriş lazım deyil və Play Console-da tester kimi əlavə olunmalı deyillər. Bu, Android üçün beta test prosesini əhəmiyyətli dərəcədə asanlaşdırır.

Android qurğuları üçün tələblər

App Distribution vasitəsilə quraşdırma üçün testerlər cihazda naməlum mənbələrdən quraşdırmanı aktivləşdirməlidir. Firebase avtomatik APK quraşdırma düyməsi olan veb səhifəyə aparan link generasiya edir. AAB formatı üçün cihazın Play Core Library-ni dəstəkləməsi və Google Play Store-un quraşdırılmış olması tələb olunur. Firebase son versiyalar üçün AAB, sürətli iterasiyalar üçün APK istifadə etməyi tövsiyə edir.

App Distribution üçün Gradle konfiqurasiyası

Firebase App Distribution üçün Gradle plagini qurğuları birbaşa Gradle tapşırığından göndərməyə imkan verir. Konfiqurasiya daxildir com.google.firebase.appdistribution plagininin əlavə edilməsi, xidmət hesabının konfiqurasiyası və hədəf qrupların təyin edilməsi. Konfiqurasiyadan sonra assembleDistRelease tapşırığı tətbiqi qurub bir əmrlə Firebase App Distribution-a yükləyəcək.

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 "Avtomatik qurğu"
}

iOS qurğularının paylanması

iOS qurğularının paylanması Firebase App Distribution vasitəsilə əlavə konfiqurasiya tələb edir, çünki Apple tətbiqlərin App Store-dan kənarda quraşdırılmasını məhdudlaşdırır. iOS tətbiqlərinin paylanması üçün Apple Developer Proqramının ad-hoc və ya enterprise sertifikatlarından istifadə etmək lazımdır. Testerlər Apple Developer Portal-da ad-hoc paylanması üçün cihaz kimi əlavə edilməli və ya cihaz məhdudiyyəti olmayan enterprise paylanmasından istifadə etməlidir.

Ad-hoc paylanmasının konfiqurasiyası

Ad-hoc paylanması üçün bütün tester cihazlarının UDID-lərini toplamaq və onları Apple Developer Portal-a əlavə etmək lazımdır. Firebase App Distribution testerlərə UDID-ni tapmaq üçün təlimat göstərir və qeydiyyatdan keçmiş cihazları avtomatik saxlayır. UDID provisioning profile-ə əlavə edildikdən və IPA qurulduqdan sonra testerlər quraşdırma linki alır. Firebase çox sayda testeri olan layihələr üçün enterprise sertifikatından istifadə etməyi tövsiyə edir, çünki ad-hoc hesab başına 100 cihazla məhdudlaşır.

Fastlane vasitəsilə IPA-nın qurulması

Fastlane — iOS tətbiqlərinin qurulmasını avtomatlaşdırmaq üçün tövsiyə olunan alətdir. Lane match sertifikatları və provisioning profile-ları idarə edir, lane sigh isə paylanma üçün IPA yaradır. Firebase App Distribution firebase_app_distribution plagini vasitəsilə Fastlane ilə inteqrasiya olunur, IPA-nı yükləyir və testerlərə bildiriş göndərir. Fastlane həmçinin əlavə plaginlər vasitəsilə versiya idarəetməsi və buraxılış qeydlərini dəstəkləyir.

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

CI/CD və Fastlane ilə inteqrasiya

Firebase App Distribution-un tam inteqrasiyası CI/CD ilə hər repository-yə commit zamanı avtomatik olaraq yeni qurğular yayımlamağa imkan verir. CI boru kəmərini quraraq, komanda kod göndərildikdən bir neçə dəqiqə sonra testerlərdən anında rəy alır. App Distribution bütün populyar CI sistemlərini dəstəkləyir: GitHub Actions, GitLab CI, Jenkins, Bitrise və CircleCI. Hər platforma üçün öz konfiqurasiya tələb olunur, lakin ümumi prinsip eynidir: qurma → yükləmə → bildiriş.

GitHub Actions vasitəsilə konfiqurasiya

GitHub Actions develop budarına göndərmə və ya pull request yaradılması zamanı qurğuların avtomatik paylanmasını konfiqurasiya etməyə imkan verir. Workflow daxildir Java/Flutter/Node.js quraşdırılması, tətbiqin qurulması, Firebase xidmət hesabı vasitəsilə doğrulama və distribute əmri ilə Firebase CLI-nin işə salınması. Sirlər (tokenlər, xidmət hesabları) GitHub Secrets-də saxlanılır və qurğu jurnallarında açıqlanmır. iOS üçün əlavə olaraq Xcode konfiqurasiyası və workflow-da Fastlane quraşdırılması tələb olunur.

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

Rəy toplanması

Firebase App Distribution testerlərdən çökmə hesabatlarının avtomatik toplanması üçün Firebase Crashlytics ilə inteqrasiya olunur. Crashlytics avtomatik çökməni müəyyən qurğu versiyasına və cihaza aid edir ki, bu da problemi tez lokallaşdırmağa və düzəltməyə kömək edir. Testerlər həmçinin App Distribution-un veb interfeysi vasitəsilə ekran görüntüləri və şərhlər göndərə bilər, qurğu quraşdırıldıqdan sonra rəy formasının linkini alır.

Tez-tez verilən suallar

App Distribution TestFlight-dan nə ilə fərqlənir?

Firebase App Distribution — yalnız iOS üçün işləyən TestFlight-dan fərqli olaraq çoxplatformalı xidmətdir (Android + iOS). App Distribution həmçinin Crashlytics və Firebase Analytics ilə inteqrasiya olunaraq hər iki platformada beta test üçün vahid ekosistem təmin edir.

Qurğular App Distribution-da nə qədər saxlanılır?

Qurğular 150 gün saxlanılır yükləmə anından etibarən. Bu müddətdən sonra avtomatik silinir. Testerlərin köhnəlmiş versiyaları quraşdırmaması üçün müntəzəm olaraq yeni qurğular yükləmək və Firebase Console vasitəsilə köhnələri əl ilə silmək tövsiyə olunur.

Nə qədər tester əlavə etmək olar?

Məhdudiyyət yoxdur Firebase App Distribution-da tester sayı üçün. iOS ad-hoc paylanması üçün Apple-ın hesab başına 100 cihaz limiti var. Android və iOS enterprise paylanması üçün tester sayı məhdudiyyəti yoxdur.

Android üçün APK əvəzinə AAB yükləmək olar?

Bəli, App Distribution AAB (Android App Bundle)-ı dəstəkləyir. Firebase Google Play App Signing vasitəsilə hər tester cihazı üçün AAB-dan avtomatik APK generasiya edir. Bu, Play Store-da dərc etməzdən əvvəl test etmək üçün xüsusilə əlverişlidir.

Firebase App Distribution pulsuzdur?

Bəli, App Distribution Firebase-in pulsuz Spark planına daxildir. Spark məhdudiyyətləri: layihə üzrə ayda 500 tester və 25 000 quraşdırma. Blaze planı bu məhdudiyyətləri aradan qaldırır və prioritet dəstək əlavə edir.

Xülasə

  • Firebase App Distribution — mağazalarda dərc etmədən Android (APK/AAB) və iOS (IPA) dəstəyi ilə mobil tətbiqlərin beta qurğularını yaymaq üçün xidmət.
  • Tester idarəetməsi — hər yeni qurğuda avtomatik e-poçt və push bildirişləri ilə çevik qrup sistemi.
  • Qurğuların yüklənməsi Firebase Console, CLI, Gradle plagini və ya Fastlane vasitəsilə testerlərə avtomatik bildirişlə həyata keçirilir.
  • Android qurğuları APK və AAB-ni dəstəkləyir, AAB-dan avtomatik APK generasiyası, Google Play Console olmadan birbaşa linklə quraşdırma.
  • iOS qurğuları Apple ad-hoc və ya enterprise sertifikatı tələb edir, UDID qeydiyyatı və IPA qurulmasının avtomatlaşdırılması üçün Fastlane dəstəyi.
  • CI/CD inteqrasiyası — GitHub Actions, GitLab CI, Jenkins, Bitrise Firebase CLI və ya Fastlane ilə hər göndərmədə avtomatik yayımlama.
  • Pulsuz ayda 500 tester və 25 000 quraşdırmaya qədər, qurğular 150 gün saxlanılır, çökmə hesabatları üçün Firebase Crashlytics ilə inteqrasiya olunub.

Açar təslim mobil tətbiq hazırlayacağıq

IT Sectr 2017-ci ildən startaplar və bizneslər üçün iOS və Android tətbiqləri yaradır. Sizə məsləhət verəcəyik və ən yaxşı həlli təklif edəcəyik.

Layihəni müzakirə et

Həm də oxuyun