Bu belgede, Android yayın öncesi test iş akışlarınızı CI/CD ortamında sürdürülebilir ve tekrarlanabilir hale getirmek için Firebase App Distribution'ı kullanmayla ilgili en iyi uygulamalar açıklanmaktadır. Çözümler arasında Gradle ve fastlane yer alıyor. Ancak size daha fazla esneklik sunmak için Firebase konsolu, Firebase CLI ve herkese açık Firebase App Distribution API'de sunulan çözümleri de dahil ediyoruz. Optimum deneyim için önceden plan yapabilmeniz amacıyla sürüm ve test kullanıcısı sınırlarını da açıklıyoruz.
Apple platformlarını da kullanıyorsanız CI/CD ve fastlane kullanarak Apple uygulamalarını KG test kullanıcılarına dağıtmayla ilgili en iyi uygulamalar bölümüne bakın.
Başlamadan önce
Bu belgedeki en iyi uygulamaları uygulamadan önce her uygulama için Firebase konsolunda App Distribution'ı etkinleştirdiğinizden emin olun. App Distribution'ı etkinleştirmediyseniz 404 hatası alırsınız.
App Distribution'ı etkinleştirmek için şu adımları uygulayın:
- Firebase konsolunda Uygulama Dağıtımı sayfasını açın.
- Android uygulamanızı seçin.
- Başlayın'ı tıklayın.
Android App Bundle (AAB) en yaygın Android paketi biçimi haline geldiği için Google Play ile bağlantı oluşturarak AAB'leri test kullanıcılarınıza dağıtma özelliğini ayarlamanızı öneririz.
CI/CD ardışık düzeni kullanarak yayın öncesi test iş akışınızı otomatikleştirme
Uygulama oluşturmayı ve test kullanıcılarınıza yayınlamayı otomatikleştirmek istiyorsanız ve CI/CD kullanıyorsanız Fastlane veya Gradle kullanmanızı öneririz. Diğer bir seçenek de çok çeşitli Firebase ürünlerine erişmenize olanak tanıyan Firebase KSA'yı kullanmaktır.
Fastlane'i kullan
iOS ve Android uygulamalarının geliştirilip yayınlanmasını otomatikleştiren açık kaynaklı bir araç olan fastlane'i kullanarak App Distribution'ı CI/CD ardışık düzeninize entegre edin. En son sürümlerinizi oluşturup test kullanıcılarına otomatik olarak dağıtarak test kullanıcılarının her zaman uygulamanızın en güncel test sürümüne sahip olmasını sağlarsınız.
App Distribution'ı fastlane ile nasıl entegre edeceğinizi öğrenmek için Android uygulamalarını fastlane kullanarak test kullanıcılarına dağıtma başlıklı makaleyi inceleyin.
Gradle kullan
App Distribution Gradle eklentisini kullanarak App Distribution'ı Android derleme sürecinize entegre etmek için Gradle'ı kullanın. Eklenti, uygulamanızın build.gradle
dosyasında test kullanıcılarınızı ve sürüm notlarınızı belirtmenize olanak tanır. Böylece, uygulamanızın farklı derleme türleri ve varyantları için dağıtımları yapılandırabilirsiniz.
App Distribution'ı Gradle ile nasıl entegre edeceğinizi öğrenmek için Android uygulamalarını Gradle kullanarak test kullanıcılarına dağıtma bölümüne bakın.
Firebase CLI'ı kullanma
Derlemeleri test kullanıcılarına programatik olarak dağıtmak için App Distribution'ın sağladığı Firebase CLI araçlarını kullanın. Bir derleme için test kullanıcıları ve sürüm notları belirtebilirsiniz.
Uygulamanın Firebase Uygulama Kimliğini belirterek en yeni Android derlemenizi dağıtın. İsteğe bağlı olarak, bir sürüm notu ve test kullanıcılarının e-postalarını içeren bir dosya da ekleyebilirsiniz:
firebase appdistribution:distribute test.aab \
--app 1:1234567890:android:0a1b2c3d4e5f67890 \
--release-notes "Bug fixes and improvements" --testers-file testers.txt
Derlemelerinizi otomatikleştirmek amacıyla Firebase CLI'ı kullanma hakkında daha fazla bilgi edinmek için Firebase CLI kullanarak Android uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin.
Kimlik doğrulaması için hizmet kimlik bilgilerini kullanma
App Distribution Fastlane eklentisini, Gradle eklentisini veya hizmet hesaplarıyla Firebase CLI'ı kullanın. Hizmet hesabı, kullanıcıları değil uygulamaları temsil eden bir Google hesabı türüdür. CI sisteminiz, App Distribution iş yüklerinizi çalıştırmak için hizmet hesaplarını kullanabilir. Daha fazla bilgi edinmek için Hizmet hesabıyla kimlik doğrulama başlıklı makaleyi inceleyin.
İş yükü kimliği federasyonu kullanıyorsanız bir hizmet hesabı anahtarı yerine kimlik bilgisi yapılandırma dosyası oluşturup kullanabilirsiniz.
Yayın sınırlarını göz önünde bulundurun
App Distribution,uygulama başına en fazla 1.000 sürümü destekler. Yani, sürüm sınırını aştığınızda App Distribution bu sınırın üzerindeki en eski sürümleri otomatik olarak siler. Sürüm sınırlarının nasıl yönetileceğini öğrenmek için Uygulama sürümleri ne kadar süre boyunca kullanılabilir? bölümüne göz atın.
Aynı test kullanıcısı grubunu birden fazla sürüme ekleyin
Sürümlerinize çok sayıda test kullanıcısı eklemek istiyorsanız App Distribution'ın toplu test kullanıcısı yönetim işlevini kullanın.
Aynı test kullanıcılarını birden fazla sürüme eklemek için grupları kullanmanızı öneririz. Grup, erişim kontrol listesi işlevi görür. Gruptan bir test kullanıcısını kaldırdığınızda, bu kullanıcı söz konusu gruba dağıtılan tüm sürümlere erişimi kaybeder. Daha fazla bilgi edinmek için Gruba test kullanıcıları ekleme ve gruptan test kullanıcıları kaldırma başlıklı makaleyi inceleyin.
Yönetmeniz gereken çok sayıda test kullanıcısı varsa Firebase konsolunu kullanarak test kullanıcılarını toplu olarak ekleyebilir ve silebilirsiniz. Test kullanıcıları eklemeyi ve kaldırmayı otomatikleştirmek için Firebase CLI, Fastlane, Gradle veya herkese açık Firebase App Distribution API'yi kullanın.
Test kullanıcılarının sınırlarını göz önünde bulundurun
App Distribution, bir Firebase projesine veya App Distribution grubuna ekleyebileceğiniz test kullanıcısı sayısını sınırlandırır. Bu sınırları aştığınızda uygulamanızı ek test kullanıcılarına dağıtamazsınız. Test kullanıcısı sınırları hakkında daha fazla bilgi edinmek için Uygulamama test kullanıcıları eklemeyle ilgili sınırlar var mı? bölümüne bakın.
Potansiyel test kullanıcılarının test için kendi kendilerine kaydolmalarını sağlayın
Uygulamanızı daha fazla test kullanıcısına dağıtmanızı kolaylaştırmak için davet bağlantılarını kullanmanızı öneririz. Davet bağlantısı, test kullanıcılarının bir uygulamayı test etmek üzere kaydolmak için e-posta adreslerini girmelerine olanak tanıyan benzersiz bir URL'dir. Kullanıcıların kendilerini uygulama test kullanıcıları listenize eklemelerini sağlamak, dahili test tabanınızı genişletmenin sorunsuz bir yoludur.
Davet bağlantılarının kullanım alanları arasında şirket test sürümü programları, büyük KG ekiplerine sahip kuruluşlar ve bireysel müşterilerin test kullanıcısı erişimini kontrol edebilmesini isteyen geliştirici grupları yer alır.
Bir grup için davet bağlantısı oluşturmanızı öneririz. Davet bağlantısını kullanarak kaydolan test kullanıcıları, sonraki sürümlere otomatik olarak eklenir.
Daha fazla bilgi edinmek için Davet bağlantıları oluşturma ve Gruba test kullanıcıları ekleme ve gruptan kaldırma konularını inceleyin.
Test kullanıcılarının, önem verdiğiniz sürümü test ettiğinden emin olun
Yeni bir sürüm yüklendiğinde test kullanıcılarınız e-postayla bilgilendirilir. Bu bildirimi tamamlamak için aşağıdaki özellikleri (sürüm bağlantıları ve uygulama içi uyarılar) kullanarak test kullanıcılarınızın, önem verdiğiniz belirli bir uygulama sürümünü test ettiklerinden emin olabilirsiniz:
- Sürüm bağlantıları: Belirli bir sürümü test kullanıcılarıyla paylaşmak istediğinizde bu özelliği kullanın. Sürüm bağlantılarının nasıl kullanılacağını öğrenmek için Firebase konsolunu kullanarak Android uygulamalarını test kullanıcılarına dağıtma bölümüne bakın. Bu bağlantılara derleme otomasyon araçlarınızla kullanabileceğiniz Firebase, Fastlane ve Gradle komut satırı (CLI) araçlarımızla da erişilebilir.
- Uygulama içi uyarılar: Test kullanıcılarınızın uygulamanızın en yeni sürümünü test ettiğinden emin olmak istediğinizde bu uyarıları kullanın. Firebase App Distribution Android SDK'sını entegre ederek, uygulamanızın yeni derlemeleri kullanıma sunulduğunda uyarıları doğrudan uygulamanın içinde test kullanıcılarınıza gösterebilirsiniz. Uygulama içi uyarıları nasıl ekleyeceğinizi öğrenmek için Test kullanıcılarını yeni derlemeler hakkında bilgilendirme konusuna bakın.
Şirketten ayrılan test kullanıcılarının erişimini otomatik olarak kaldırma
CI/CD dahili test akışınız çalışır durumda olduğunda, şirketten ayrılan kişilerin artık dahili derlemelerinize erişemeyeceğinden emin olmanız gerekir. App Distribution, test kullanıcılarının derlemelere erişimini yönetmenize yardımcı olmak için aşağıdaki seçenekleri sunar:
- Fastlane: Fastfile dosyanızı kullanın veya doğrudan fastlane işlemlerini çalıştırın. Daha fazla bilgi edinmek için Fastlane kullanarak Android uygulamalarını test kullanıcılarına dağıtma konusuna bakın.
- Firebase CLI:
firebase appdistribution:testers:remove
işlemini kullanın. Daha fazla bilgi edinmek için Firebase CLI kullanarak Android uygulamalarını test kullanıcılarına dağıtma konusuna bakın. - Gradle: Test kullanıcılarını kaldırmak için Gradle'ı kullanıyorsanız
build.gradle
dosyanızdaki
ve--PROJECT_NUMBER
bağımsız değişkenleriyle--EMAILS appDistributionRemoveTesters
değerini iletin. Daha fazla bilgi edinmek için Gradle kullanarak Android uygulamalarını test kullanıcılarına dağıtma konusuna bakın. - Herkese açık Firebase App Distribution API:
testers.batchRemove
uç noktasını kullanın.