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


Bu kılavuzda, Firebase KSA'yı kullanarak Android App Bundle'ları (AAB'ler) test kullanıcılara nasıl dağıtacağınız açıklanmaktadır. KSA aracı, bir yapı için test kullanıcılarını ve sürüm notlarını belirtmenize, ardından yapıyı buna göre dağıtmanıza olanak tanı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 amacıyla Google Play'in dahili uygulama paylaşım hizmetiyle entegre olur. AAB'leri dağıtarak şunları yapabilirsiniz:

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

  • Cihaza özgü sorunları ortaya çıkarın ve hatalarını ayıklayın.

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

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

Gerekli izinler

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

Gerekli Firebase erişiminiz yoksa bir Firebase proje sahibinden Firebase konsolu IAM ayarlarını kullanarak size geçerli rolü atamasını isteyebilirsiniz. Sahip rolü olan kullanıcıyı bulma veya bu rolü atama dahil olmak üzere Firebase projenize erişimle ilgili sorularınız varsa "Firebase projelerine izinler ve erişim" başlıklı SSS bölümünü inceleyin.

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

Firebase konsolundaki işlem Gerekli IAM izni Gerekli izinleri varsayılan olarak içeren IAM rolleri Ek olarak gerekli roller
Firebase uygulamasını Google Play içindeki bir uygulamaya bağlama firebase.playLinks.update Aşağıdaki rollerden biri: Google Play geliştirici hesabına yönetici olarak erişim
App Distribution'ya AAB 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ı bulunur.

    Başka Firebase ürünleri kullanmıyorsanız yalnızca bir proje oluşturmanız ve uygulamanızı kaydetmeniz gerekir. Ek ürünler kullanmaya karar verirseniz Android projenize Firebase 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 şu koşulları karşıladığından emin olun:

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

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

    • Uygulamanın Google Play'deki incelemesi tamamlanmış ve uygulama yayınlanmış olmalıdır. Uygulama durumu sütununda şu durumlardan biri bulunuyorsa 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 Entegrasyonlar sekmesini seçin.

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

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

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

1. Adım. Uygulamanızı geliştirin

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ını inceleyin).

2. Adım. Uygulamanızı test kullanıcılarına dağıtma

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

  1. Firebase CLI'nın en son sürümünü yükleyin veya bu sürüme güncelleyin (CLI'nın işletim sisteminize özel bağımsız ikili dosyasını indirmenizi öneririz). Oturum açtığınızdan ve projelerinize erişebildiğinizi test ettiğinizden emin olun.

  2. Uygulamanızı yüklemek ve 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:

    appdistribution:distribute seçenekleri
    --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ı Firebase CLI ile kimlik doğruladığınızda yazdırılan bir yenileme jetonu (daha fazla bilgi için CLI'yı CI sistemleriyle kullanma başlıklı makaleyi inceleyin). 

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

    Bu derlemeyle ilgili sürüm notları.

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

    --release-notes "Text of release notes"

    Dilerseniz düz metin dosyasının yolunu belirtin:

    --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ı, e-posta adreslerinin virgülle ayrılmış bir 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 bir 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ı (bkz. Test kullanıcılarını yönetme). Gruplar, Firebase konsolunda arayabileceğiniz grup takma adları kullanılarak belirtilir.

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

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

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

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

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

    Aşağıdaki dağıtım türleri, Otomatikleştirilmiş Test Aracı beta özelliğinin bir parçasıdır.

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

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

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

    Alternatif olarak, noktalı virgülle ayrılmış test cihazları listesini içeren 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ş için kullanıcı adı.
    --test-password
    --test-password-file

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

    Dilerseniz şifre içeren bir düz metin dosyasının yolunu da belirtebilirsiniz:

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

    Otomatik testler sırasında kullanılacak otomatik giriş için kullanıcı adı alanının kaynak adı.
    --test-password-resource

    Otomatik testler sırasında kullanılacak otomatik giriş için ş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.

    Örneğin:

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

    Firebase CLI, yayın yüklemesinden sonra aşağıdaki bağlantıları verir. Bu bağlantılar, ikili dosyaları yönetmenize ve test kullanıcılarının ve diğer geliştiricilerin doğru sürümü kullanmasını sağlamanıza yardımcı olur:

    • firebase_console_uri - Tek bir sürümü gösteren Firebase konsoluna giden bağlantı. Bu bağlantıyı kuruluşunuzdaki diğer geliştiricilerle paylaşabilirsiniz.
    • testing_uri - Test kullanıcısı deneyiminde (Android yerel uygulaması) test kullanıcılarının sürüm notlarını görüntülemesine ve uygulamayı cihazlarına yüklemesine olanak tanıyan 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 ikilisini (APK veya AAB dosyası) doğrudan indiren ve yükleyen imzalı bir bağlantı. Bağlantının süresi bir saat sonra dolar.

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

    Sürümleri dağıtmanın yanı sıra appdistribution:testers:add ve appdistribution:testers:remove seçeneklerini kullanarak yeni test kullanıcılarını davet edebilir veya mevcut test kullanıcılarını Firebase projenizden kaldırabilirsiniz.

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

    Örneğin:

    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. --file /path/to/testers.txt kullanarak da test kullanıcılarını belirtebilirsiniz.

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

    --group-alias ve appdistribution:testers:remove komutları için bir grup belirtmek üzere --group-alias öğesini kullanın.appdistribution:testers:add

    Örneğin:

    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

Derlemenizi dağıttıktan sonra 150 gün (beş ay) boyunca App Distribution konsolunun Firebase gösterge tablosunda kullanılabilir. Derlemenin geçerlilik süresinin dolmasına 30 gün kaldığında hem konsolda hem de test cihazındaki test derlemeleri listesinde geçerlilik süresiyle ilgili bir bildirim gösterilir.

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

Test kullanıcılarının, uygulamayı test etme davetini 30 gün içinde kabul etmesi gerekir. Aksi takdirde davetin süresi sona erer. Bir davetin geçerlilik süresinin bitimine 5 gün kala, sürümdeki test kullanıcısının yanında Firebase konsolunda geçerlilik bitişi bildirimi gösterilir. Davet, test kullanıcısı satırındaki açılır menü kullanılarak yeniden gönderilerek yenilenebilir.

Sonraki adımlar