Bu kılavuz, Firebase CLI kullanarak Android Uygulama Paketlerinin (AAB'ler) test kullanıcılarına nasıl dağıtılacağını açıklar. CLI aracı, bir yapı için test ediciler ve sürüm notları belirtmenize olanak tanır ve ardından yapıyı buna göre dağıtı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ına göre optimize edilmiş optimize edilmiş APK'ları (Google Play tarafından sunulan) çalıştırın.
Cihaza özgü sorunları ortaya çıkarın ve hatalarını ayıklayın.
Test kullanıcılarınız için indirme boyutunu azaltı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 eylemleri gerçekleştirmek için gerekli erişim düzeyine sahip olmanız gerekir.
Gerekli Firebase erişimine sahip değilseniz, Firebase konsolu IAM ayarları yoluyla bir Firebase proje Sahibinden size uygun rolü atamasını isteyebilirsiniz. Sahip bulma veya atama da dahil olmak üzere Firebase projenize erişimle ilgili sorularınız varsa "Firebase projelerine izinler ve erişim" SSS bölümünü 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 konsolunda işlem||Gerekli IAM izni||Varsayılan olarak gerekli izinleri içeren IAM rolleri||Ek gerekli rol(ler)|
|Bir Firebase uygulamasını Google Play'deki bir uygulamaya bağlama|| ||Aşağıdaki rollerden biri:||Yönetici olarak bir Google Play geliştirici hesabına erişim|
|AAB'leri App Distribution'a yükleyin|| ||Aşağıdaki rollerden biri:||––|
Sen başlamadan önce
Henüz yapmadıysanız, Firebase'i Android projenize ekleyin . Bu iş akışının sonunda, Firebase projenizde bir Firebase Android Uygulamanız olacak.
Başka bir Firebase ürünü kullanmıyorsanız, yalnızca bir proje oluşturmanız ve uygulamanızı kaydetmeniz gerekir. Ek ürünler kullanmaya karar verirseniz Firebase'i Android projenize ekleyin bölümündeki tüm adımları tamamladığınızdan emin olun.
Google Play'e bir 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 kaydedilir.
Google Play'deki uygulama , uygulama kontrol panelinde kurulur ve Google Play kanalları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ınlanmıştır: Dahili test (Taslak dahili testi 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,gidin Proje ayarları , ardından Entegrasyonlar sekmesini seçin.
Google Play kartında Bağlantı'yı tıklayın.
Halihazırda Google Play bağlantılarınız varsa bunun yerine Yönet'i tıklayın.
Uygulama Dağıtımı entegrasyonunu etkinleştirmek için ekrandaki talimatları izleyin ve hangi Firebase Android Uygulamalarının Google Play'e bağlanacağını seçin.
Google Play'e bağlanma hakkında daha fazla bilgi edinin.
1. Adım. Uygulamanızı oluşturun
Uygulamanızın yayın öncesi bir 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 kullanarak yükleyin:
- Firebase CLI'nin en son sürümünü yükleyin veya güncelleyin (işletim sisteminize özgü CLI için bağımsız ikili dosyayı indirmenizi öneririz). Oturum açtığınızdan ve projelerinize erişebildiğ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:distributekomutunu ç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 konsolunda, Genel Ayarlar sayfasında bulabilirsiniz.
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
Firebase CLI ile CI ortamınızın kimliğini doğruladığınızda yazdırılan bir yenileme belirteci (daha fazla bilgi için CLI'yi CI sistemleriyle kullanma bölümünü okuyun).
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Bu yapı için 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ış bir e-posta adresi listesi olarak belirtebilirsiniz:
--testers "email@example.com, firstname.lastname@example.org, email@example.com"
Veya virgülle ayrılmış e-posta adresleri listesi içeren bir düz metin dosyasının yolunu belirleyebilirsiniz:
--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önet ). Gruplar kullanılarak belirtilir
grup takma adları, Firebase konsolunda arayabilirsiniz.
Grupları virgülle ayrılmış bir liste olarak belirleyebilirsiniz:
--groups "qa-team, trusted-testers"
Veya virgülle ayrılmış grup adları listesi içeren bir düz metin dosyasının yolunu belirleyebilirsiniz:
--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 edicilerin ve diğer geliştiricilerin doğru sürüme sahip olmalarını sağlamanıza yardımcı olur:
-
firebase_console_uri- Tek bir sürümü görüntüleyen Firebase konsolu bağlantısı. Bu bağlantıyı kuruluşunuzdaki diğer geliştiricilerle paylaşabilirsiniz.
-
testing_uri- Test edicilerin sürüm notlarını görüntülemesine ve uygulamayı cihazlarına yüklemesine olanak tanıyan, test kullanıcısı deneyimindeki (Android yerel uygulaması) yayın 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 dosyasını (APK veya AAB dosyası) doğrudan indiren ve yükleyen imzalı bir bağlantı. Bağlantı 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:addve
appdistribution:testers:removeda kullanabilirsiniz.
Firebase projenize bir test kullanıcısı eklendikten sonra, bunları ayrı sürümlere ekleyebilirsiniz. Bir test kullanıcısını kaldırdığınızda, artık projenizdeki sürümlere erişemezler. Kısa bir süre önce kaldırılan test kullanıcılarının, belirli bir süre için sürümlerinize erişmeye devam edebileceğini unutmayın.
Örneğin:
firebase appdistribution:testers:add firstname.lastname@example.org email@example.com
firebase appdistribution:testers:remove firstname.lastname@example.org email@example.com
Test kullanıcısı e-postaları bir boşlukla ayrılmalıdır. Test kullanıcılarını
--file /path/to/testers.txtkullanarak 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:createve
appdistribution:group:deletekullanabilirsiniz.
--group-aliaskullanarak
appdistribution:testers:addve
appdistribution:testers:removekomutları için bir grup belirtin.
Örneğin:
firebase appdistribution:group:create "QA team" qa-team
firebase appdistribution:testers:add --group-alias=qa-team firstname.lastname@example.org email@example.com
firebase appdistribution:testers:remove --group-alias=qa-team firstname.lastname@example.org email@example.com
firebase appdistribution:group:delete qa-team
-
Yapınızı dağıttıktan sonra, Firebase konsolunun Uygulama Dağıtım panosunda 150 gün (beş ay) kullanılabilir hale gelir. Derlemenin süresinin dolmasına 30 gün kala, hem konsolda hem de test cihazınızın test cihazındaki derlemeler listesinde bir son kullanma bildirimi görünür.
Uygulamayı test etmeye davet edilmemiş olan test kullanıcıları, başlamak için e-posta davetleri 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 kullanıcısı kurulum kılavuzunu okuyun). Her test kullanıcısının durumunu (daveti kabul edip etmediklerini ve uygulamayı indirip indirmediklerini) Firebase konsolunda izleyebilirsiniz.
Test kullanıcılarının, uygulamayı süresi dolmadan önce test etme davetini kabul etmeleri için 30 günleri vardır. Davetiyenin süresinin dolmasına 5 gün kaldığında, Firebase konsolunda bir sürümde test kullanıcısının yanında 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üklenebilir olduğunda test kullanıcılarınıza uygulama içi uyarıları nasıl göstereceğinizi öğrenin.
CI/CD kullanarak Android uygulamalarını QA test uzmanlarına dağıtmak için en iyi uygulamaları öğrenin.