Android uygulamalarını Firebase CLI kullanarak test kullanıcılarına dağıtma

Bu kılavuzda, Android App Bundle'ların (AAB'ler) Firebase CLI kullanarak test kullanıcılarına nasıl dağıtılacağı açıklanmaktadır. CLI aracı, bir derleme için test kullanıcılarını ve sürüm notlarını belirtmenizi sağlar, ardından derlemeyi uygun şekilde dağıtır.

App Distribution, yüklediğiniz AAB'leri işlemek ve test kullanıcılarınızın cihaz yapılandırmaları için optimize edilmiş APK'ları sunmak için Google Play'in dahili uygulama paylaşım hizmetiyle entegre olur. AAB dağıtma, aşağıdakileri yapmanıza olanak tanır:

  • Test kullanıcılarınızın cihazları için optimize edilmiş optimize edilmiş APK'ları (Google Play tarafından sunulan) çalıştırın.

  • Cihaza özgü sorunları bulun ve hataları ayıklayın.

  • Play Feature Delivery ve Play Asset Delivery gibi uygulama paketi özelliklerini test edin.

  • Test kullanıcılarınız için indirmelerin boyutunu küçültün.

Gerekli izinler

AAB'leri App Distribution'a yüklemek için Firebase uygulamanızı Google Play'deki bir uygulamaya bağlamanız gerekir. Bu işlemleri gerçekleştirmek için gereken erişim düzeyine sahip olmanız gerekir.

Gerekli Firebase erişimine sahip değilseniz bir Firebase projesi sahibinden Firebase konsolu IAM ayarları aracılığıyla size geçerli rolü atamasını isteyebilirsiniz. Sahip bulma veya sahip atama da dahil olmak üzere Firebase projenize erişimle ilgili sorularınız varsa "Firebase projelerine izinler ve erişim" ile ilgili SSS bölümünü inceleyin.

Aşağıdaki tablo, Firebase uygulamasını Google Play'deki bir uygulamaya bağlama ve AAB yükleme işlemleri için geçerlidir.

Firebase konsolundaki işlem Gerekli IAM izni Varsayılan olarak gerekli izinleri içeren IAM rolleri Gerekli diğer roller
Firebase uygulamasını Google Play'de bir uygulamaya bağlama firebase.playLinks.update Aşağıdaki rollerden biri: Google Play Geliştirici hesabına Yönetici olarak erişim
AAB'leri App Distribution'a yükleme firebaseappdistro.releases.update Aşağıdaki rollerden biri: -–

Başlamadan önce

  1. Henüz yapmadıysanız Firebase'i Android projenize ekleyin. Bu iş akışının sonunda, Firebase projenizde bir Firebase Android uygulaması olacak.

    Başka bir Firebase ürünü kullanmıyorsanız bir proje oluşturup uygulamanızı kaydetmeniz yeterlidir. Ek ürünler kullanmaya karar verirseniz Firebase'i Android projenize ekleme bölümündeki tüm adımları tamamladığınızdan emin olun.

  2. Google Play'e Firebase bağlantısı oluşturmak ve AAB'leri yüklemek için uygulamanızın aşağıdaki şartları karşıladığından emin olun:

    • Hem Google Play'deki uygulama hem de Firebase Android uygulaması aynı paket adı kullanılarak kaydedilmiştir.

    • Google Play'deki uygulama, uygulama kontrol panelinde oluşturulur ve Google Play kanallarından birine (Dahili test, Kapalı test, Açık test veya Üretim) dağıtılmıştır.

    • Uygulamanın Google Play'deki incelemesi tamamlanmış ve uygulama yayınlanmış olmalıdır. Uygulama durumu sütununda şu durumlardan biri gösteriliyorsa uygulamanız yayınlanmış demektir: Dahili test (Taslak dahili test değil), Kapalı test, Açık test veya Üretim.

  3. Firebase Android uygulamanızı Google Play geliştirici hesabınıza bağlayın:

    1. Firebase konsolunda Proje ayarları'na gidin ve ardından Entegrasyonlar sekmesini seçin.

    2. Google Play kartında Bağlan'ı tıklayın.
      Google Play bağlantılarınız zaten varsa Yönet'i tıklayın.

    3. App Distribution entegrasyonunu etkinleştirmek için ekrandaki talimatları uygulayın ve Google Play'e hangi Firebase Android uygulamalarının bağlanacağını seçin.

    Google Play'e bağlama hakkında daha fazla bilgi edinin.

1. adım: Uygulamanızı oluşturma

Uygulamanızın yayın öncesi sürümünü test kullanıcılarına dağıtmaya hazır olduğunuzda AAB'nizi oluşturun (talimatlar için Android Studio dokümanlarına bakın).

2. adım: Uygulamanızı test kullanıcılarına dağıtın

Uygulamanızı test kullanıcılarına dağıtmak için uygulamanızın dosyasını Firebase CLI'ı kullanarak yükleyin:

  1. Firebase CLI'ın en son sürümünü yükleyin veya en son sürüme güncelleyin (OS'nize özel CLI için bağımsız ikili programı indirmenizi öneririz). Oturum açtığınızdan emin olun ve projelerinize erişip erişemediğinizi test edin.
  2. Firebase konsolunun Uygulama Dağıtımı sayfasında, dağıtmak istediğiniz uygulamayı seçin ve ardından Başlayın'ı tıklayın.

  3. Uygulamanızı yükleyip test kullanıcılarına dağıtmak için appdistribution:distribute komutunu çalıştırın. Dağıtımı yapılandırmak için aşağıdaki parametreleri kullanın:

    uygulama dağıtım:seçenekleri dağıtma
    --app

    Zorunlu: Uygulamanızın Firebase Uygulama Kimliği. Uygulama kimliğini Firebase konsolundaki Genel Ayarlar sayfasında bulabilirsiniz.

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    CI ortamınızın kimliğini Firebase CLI ile doğruladığınızda yazdırılan bir yenileme jetonu (daha fazla bilgi için CLI'yı CI sistemleriyle kullanma bölümünü okuyun). 

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Bu derlemenin sürüm notları.

    Sürüm notlarını doğrudan belirtebilirsiniz:

    --release-notes "Text of release notes"

    İsterseniz düz metin dosyasının yolunu da belirtebilirsiniz:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Davet etmek istediğiniz test kullanıcılarının e-posta adresleri.

    Test kullanıcılarını virgülle ayrılmış e-posta adresleri listesi olarak belirtebilirsiniz:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    Alternatif olarak, e-posta adreslerinin virgülle ayrılmış listesini içeren düz metin dosyasının yolunu belirtebilirsiniz:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Davet etmek istediğiniz test kullanıcısı grupları (Test kullanıcılarını yönetme bölümüne bakın). Gruplar, Firebase konsolunda arayabileceğiniz grup takma adları kullanılarak belirlenir.

    Grupları virgülle ayrılmış liste olarak belirtebilirsiniz:

    --groups "qa-team, trusted-testers"

    Alternatif olarak, grup adlarının virgülle ayrılmış listesini içeren bir düz metin dosyasının yolunu belirtebilirsiniz:

    --groups-file "/path/to/groups.txt"
    --debug

    Ayrıntılı günlük çıkışını yazdırmak için ekleyebileceğiniz bir işaret.
    --test-devices
    --test-devices-file

    Aşağıdaki dağıtım türleri, Otomatik test kullanıcısı beta özelliği kapsamındadır.

    Derlemeleri dağıtmak istediğiniz test cihazları (Otomatik testler bölümüne bakın).

    Test kullanıcılarını virgülle ayrılmış e-posta adresleri listesi olarak belirtebilirsiniz:

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

    Alternatif olarak, test cihazlarının noktalı virgülle ayrılmış listesini içeren bir düz metin dosyasının yolunu belirtebilirsiniz:

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    Otomatik testler sırasında kullanılacak otomatik giriş kullanıcı adı.
    --test-password
    --test-password-file

    Otomatik testler sırasında kullanılacak otomatik giriş şifresi.

    Alternatif olarak, şifre içeren bir düz metin dosyasının yolunu belirtebilirsiniz:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    Otomatik testler sırasında kullanılacak otomatik girişe yönelik kullanıcı adı alanının kaynak adı.
    --test-password-resource

    Otomatik testler sırasında kullanılacak otomatik giriş şifre alanının kaynak adı.
    --test-non-blocking

    Otomatik testleri eşzamansız olarak çalıştırın. Otomatik test sonuçları için Firebase konsolunu ziyaret edin.

    Örnek:

    firebase appdistribution:distribute test.aab  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    Firebase CLI, sürüm yüklendikten sonra aşağıdaki bağlantıları oluşturur. Bu bağlantılar, ikili programları yönetmenize yardımcı olup test kullanıcılarının ve diğer geliştiricilerin doğru sürüme sahip olmasını sağlar:

    • firebase_console_uri - Tek bir sürümü gösteren Firebase konsolu bağlantısı. Bu bağlantıyı kuruluşunuzdaki diğer geliştiricilerle paylaşabilirsiniz.
    • testing_uri - Test kullanıcılarının sürüm notlarını görüntüleyip uygulamayı cihazlarına yüklemesine olanak tanıyan, test kullanıcısı deneyimindeki (Android yerel uygulaması) sürüm bağlantısı. Test kullanıcısının bağlantıyı kullanabilmesi için sürüme erişmesi gerekir.
    • binary_download_uri - Uygulama ikili programını (APK veya AAB dosyası) doğrudan indirip yükleyen imzalı bir bağlantı. Bağlantının süresi bir saat sonra dolar.

    Test kullanıcılarını ve grupları yönet

    Sürümleri dağıtmanın yanı sıra yeni test kullanıcıları davet etmek veya mevcut test kullanıcılarını Firebase projenizden kaldırmak için appdistribution:testers:add ve appdistribution:testers:remove araçlarını da kullanabilirsiniz.

    Firebase projenize eklenen test kullanıcılarını bağımsız sürümlere ekleyebilirsiniz. Kaldırdığınız test kullanıcısı artık projenizdeki sürümlere erişemez. Yakın zamanda kaldırılan test kullanıcılarının belirli bir süre boyunca sürümlerinize erişmeye devam edebileceğini unutmayın.

    Örnek:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

    Test kullanıcısı e-posta adresleri boşlukla ayrılmalıdır. Ayrıca --file /path/to/testers.txt kullanarak test kullanıcılarını da belirtebilirsiniz.

    Çok sayıda test kullanıcınız varsa grupları kullanmayı düşünebilirsiniz: Firebase projenizde grup oluşturmak veya silmek için appdistribution:group:create ve appdistribution:group:delete gruplarını kullanabilirsiniz.

    appdistribution:testers:add ve appdistribution:testers:remove komutları için bir grup belirtmek amacıyla --group-alias kullanın.

    Örnek:

    firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

Derlemeniz dağıtıldıktan sonra Firebase konsolunun Uygulama Dağıtımı kontrol panelinde 150 gün (beş ay) boyunca kullanılabilir hale gelir. Derlemenin süresinin dolmasından 30 gün sonra, hem konsolda hem de test kullanıcınızın test cihazındaki derleme listesinde bir geçerlilik bitiş bildirimi görünür.

Uygulamayı test etmeye davet edilmemiş test kullanıcıları başlamak için e-posta davetiyeleri alır. Mevcut test kullanıcıları ise yeni bir derlemenin teste hazır olduğuna dair e-posta bildirimleri alır (test uygulamasının nasıl yükleneceğiyle ilgili talimatlar için test kullanıcısı kurulum kılavuzunu okuyun). Firebase konsolunda her test kullanıcısının durumunu (daveti kabul edip etmediğini ve uygulamayı indirip indirmediğini) izleyebilirsiniz.

Test kullanıcılarının 30 gün içinde uygulamayı test etme davetini süresi dolmadan kabul etmeleri gerekir. Bir davetiyenin süresinin dolmasından 5 gün sonra, Firebase konsolunda bir sürümde test kullanıcısının yanında bir geçerlilik bitiş bildirimi görünür. Davetiye, test kullanıcısı satırındaki açılır menü aracılığıyla yeniden gönderilerek yenilenebilir.

Sonraki adımlar