Bu kılavuzda, Firebase CLI'yi kullanarak Android Uygulama Paketlerinin (AAB'ler) test kullanıcılarına nasıl dağıtılacağı açıklanmaktadır. CLI aracı, bir yapı için test kullanıcılarını ve sürüm notlarını belirtmenize ve ardından yapıyı buna göre dağıtmanıza olanak tanır.
Uygulama Dağıtımı, 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'leri dağıtmak aşağıdakileri yapmanızı sağlar:
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ı ortaya çıkarın ve hata ayıklayın.
Play Özellik Yayını ve Play Varlık Yayını gibi uygulama paketi özelliklerini test edin.
Test kullanıcılarınız için indirmelerin boyutunu azaltın.
Gerekli izinler
AAB'leri Uygulama Dağıtımı'na yüklemek için Firebase uygulamanızı Google Play'deki bir uygulamaya bağlamanız gerekir. Bu eylemleri gerçekleştirmek için gerekli erişim düzeyine sahip olmanız gerekir.
Gerekli Firebase erişiminiz yoksa Firebase proje Sahibinden, Firebase konsolu IAM ayarları aracılığıyla size uygun rolü atamasını isteyebilirsiniz. Bir Sahip bulma veya atama da dahil olmak üzere Firebase projenize erişimle ilgili sorularınız varsa "İzinler ve Firebase projelerine erişim" SSS'sini inceleyin.
Aşağıdaki tablo, bir Firebase uygulamasını Google Play'deki bir uygulamaya bağlamak ve AAB'leri yüklemek için geçerlidir.
Firebase konsolundaki işlem | Gerekli IAM izni | Varsayılan olarak gerekli izinleri içeren IAM rolleri | Gerekli ek roller |
---|---|---|---|
Firebase uygulamasını Google Play'deki 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 Uygulama Dağıtımına Yükleme | firebaseappdistro.releases.update | Aşağıdaki rollerden biri: | –– |
Sen başlamadan önce
Henüz yapmadıysanız Android projenize Firebase'i ekleyin . Bu iş akışının sonunda Firebase projenizde bir Firebase Android Uygulamasına sahip olacaksınız.
Başka bir Firebase ürünü kullanmıyorsanız yalnızca 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.
Google Play'e Firebase bağlantısı oluşturmak ve AAB'leri yüklemek için uygulamanızın aşağıdaki gereksinimleri karşıladığından emin olun:
Google Play'deki uygulama ve Firebase Android uygulaması aynı paket adı kullanılarak kaydedilmiştir.
Google Play'deki uygulama , uygulama kontrol panelinde kurulur ve Google Play parçalarından birine (Dahili test, Kapalı test, Açık test veya Üretim) dağıtılır.
Uygulamanın Google Play'deki incelemesi tamamlandı ve uygulama yayınlandı. Uygulama durumu sütununda şu durumlardan biri görüntüleniyorsa uygulamanız yayınlanır: Dahili test (Taslak dahili test değil), Kapalı test, Açık test veya Üretim.
Firebase Android Uygulamanızı Google Play geliştirici hesabınıza bağlayın:
Firebase konsolunda şuraya gidin:
Google Play kartında Bağlantı'yı tıklayın.
Zaten Google Play'e bağlantılarınız varsa bunun yerine Yönet'i tıklayın.Uygulama Dağıtımı entegrasyonunu etkinleştirmek ve Google Play'e hangi Firebase Android Uygulamalarının bağlanacağını seçmek için ekrandaki talimatları izleyin.
Google Play'e bağlanma hakkında daha fazla bilgi edinin.
1. Adım. Uygulamanızı oluşturun
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 belgelerini ziyaret edin).
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'yi kullanarak yükleyin:
- Firebase CLI'nin en son sürümünü yükleyin veya güncelleyin (İşletim sisteminize özel CLI için bağımsız ikili dosyayı indirmenizi öneririz). Oturum açtığınızdan ve projelerinize erişebildiğinizi test ettiğinizden emin olun.
- Firebase konsolunun Uygulama Dağıtımı sayfasında dağıtmak istediğiniz uygulamayı seçin ve ardından Başlayın'ı tıklayın.
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:uygulama dağıtımı:dağıtma seçenekleri --app
Gerekli : Uygulamanızın Firebase Uygulama Kimliği. Uygulama Kimliğini Firebase konsolunun 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 belirteci (daha fazla bilgi için CLI'yi CI sistemleriyle kullanma konusunu okuyun).
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Bu yapıya ilişkin sürüm notları.
Sürüm notlarını doğrudan belirtebilirsiniz:
--release-notes "Text of release notes"
Veya 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ı virgülle ayrılmış e-posta adresleri listesi olarak belirtebilirsiniz:
--testers "ali@example.com, bri@example.com, cal@example.com"
Veya virgülle ayrılmış e-posta adresleri 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ı (bkz. Test kullanıcılarını yönetme ). Gruplar kullanılarak belirtilir
grup takma adları Firebase konsolunda arayabilirsiniz.Grupları virgülle ayrılmış liste olarak belirtebilirsiniz:
--groups "qa-team, trusted-testers"
Veya virgülle ayrılmış grup adları listesini içeren düz metin dosyasının yolunu belirtebilirsiniz:
--groups-file "/path/to/groups.txt"
--debug
Ayrıntılı günlük çıktısını yazdırmak için ekleyebileceğiniz bir bayrak.
Örneğin:
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üklemesinden sonra aşağıdaki bağlantıların çıktısını 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üme sahip olmasını sağlamanıza yardımcı olur:
-
firebase_console_uri
- Tek bir sürümü görüntüleyen Firebase konsoluna bağlantı. 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ülemesine ve uygulamayı cihazlarına yüklemesine olanak tanıyan, test deneyimindeki (Android yerel uygulaması) sürüme bağlantı. Bağlantıyı kullanabilmek için test kullanıcısının sürüme erişmesi gerekiyor. -
binary_download_uri
- Uygulama ikili dosyasını (APK veya AAB dosyası) doğrudan indirip yükleyen imzalı bir bağlantı. Bağlantının süresi bir saat sonra sona erer.
Test kullanıcılarını ve grupları yönetin
Sürümleri dağıtmanın yanı sıra, yeni test kullanıcılarını davet etmek veya mevcut test kullanıcılarını Firebase projenizden kaldırmak için
appdistribution:testers:add
veappdistribution:testers:remove
da kullanabilirsiniz.Firebase projenize bir test kullanıcısı eklendikten sonra bunları ayrı ayrı sürümlere ekleyebilirsiniz. Bir test kullanıcısını kaldırdığınızda bu kişi artık projenizdeki sürümlere erişemez. Yakın zamanda kaldırılan test kullanıcılarının bir süre daha sürümlerinize erişmeye devam edebileceklerini 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-postaları bir boşlukla ayrılmalıdır. Ayrıca
--file /path/to/testers.txt
kullanarak test kullanıcılarını da belirleyebilirsiniz.Çok sayıda test kullanıcınız varsa grupları kullanmayı düşünmelisiniz: Firebase projenizde grup oluşturmak veya silmek için
appdistribution:group:create
veappdistribution:group:delete
kullanabilirsiniz.appdistribution:testers:add
veappdistribution:testers:remove
komutlarına yönelik bir grup belirtmek için--group-alias
kullanın.Ö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ığınızda, 150 gün (beş ay) boyunca Firebase konsolunun Uygulama Dağıtımı kontrol panelinde kullanılabilir hale gelir. Derlemenin süresinin dolmasına 30 gün kaldığında, hem konsolda hem de test kullanıcınızın test cihazındaki derlemeler listesinde bir sona erme bildirimi görünür.
Uygulamayı test etmeye davet edilmeyen test kullanıcıları, başlamak için e-posta davetiyeleri alır ve mevcut test kullanıcıları, yeni bir yapının test edilmeye hazır olduğuna dair e-posta bildirimleri alır (test uygulamasının nasıl kurulacağına ilişkin talimatlar için test cihazı kurulum kılavuzunu okuyun). Firebase konsolunda her test kullanıcısının durumunu (daveti kabul edip etmediklerini ve uygulamayı indirip indirmediklerini) izleyebilirsiniz.
Test kullanıcılarının, süresi dolmadan uygulamayı test etme davetini kabul etmek için 30 günü vardır. Davetiyenin süresinin dolmasına 5 gün kaldığında, Firebase konsolunda test kullanıcısının yanında sürümde bir süre sonu bildirimi görünür. Bir davet, test kullanıcısı satırındaki açılır menü kullanılarak yeniden gönderilerek yenilenebilir.
Sonraki adımlar
Test kullanıcılarının uygulamanız hakkında (ekran görüntüleri dahil) geri bildirim göndermesini kolaylaştırmak için uygulama içi geri bildirim uygulayın.
Uygulamanızın yeni sürümleri yüklenmeye hazır olduğunda test kullanıcılarınıza uygulama içi uyarıları nasıl görüntüleyeceğinizi öğrenin.
Android uygulamalarını CI/CD kullanarak QA test kullanıcılarına dağıtmaya yönelik en iyi uygulamaları öğrenin.