Bu belge, Android yayın öncesi test iş akışlarınızı bir CI/CD ortamında sürdürülebilir ve tekrarlanabilir hale getirmek için Firebase App Distribution kullanımına yönelik en iyi uygulamaları tanıtmaktadır. Çözümler arasında Gradle ve fastlane yer alır, ancak size daha da fazla esneklik sağlamak için Firebase konsolu, Firebase CLI ve genel Firebase Uygulama Dağıtım API'sı aracılığıyla sunulan çözümleri de dahil ediyoruz. En iyi deneyimi önceden planlayabilmeniz için 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ı QA test uzmanlarına dağıtmak için en iyi uygulamalar bölümüne bakın.
Sen başlamadan önce
Bu belgedeki en iyi uygulamaları uygulamadan önce, her uygulama için Firebase konsolunda Uygulama Dağıtımını etkinleştirdiğinizden emin olun. Uygulama Dağıtımını etkinleştirmediyseniz 404 hatası alırsınız.
Uygulama Dağıtımını etkinleştirmek için şu adımları izleyin:
- Firebase konsolunda Uygulama Dağıtımı sayfasını açın.
- Android uygulamanızı seçin.
- Başlayın'ı tıklayın.
Android App Bundle'ların (AAB) en yaygın Android paket biçimi haline geldiği göz önüne alındığında, AAB'leri Google Play'e bağlayarak test kullanıcılarınıza dağıtma özelliğini ayarlamanızı öneririz.
Bir CI/CD ardışık düzeni kullanarak yayın öncesi test iş akışınızı otomatikleştirin
Uygulama oluşturmayı ve test cihazları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şmenizi sağlayan Firebase CLI'yi kullanmaktır.
Hızlı şerit kullan
iOS ve Android uygulamalarının oluşturulmasını ve yayınlanmasını otomatikleştiren açık kaynaklı bir araç olan fastlane'i kullanarak Uygulama Dağıtımını CI/CD işlem hattınıza 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.
Uygulama Dağıtımını fastlane ile nasıl entegre edeceğinizi öğrenmek için Fastlane kullanarak Android uygulamalarını test kullanıcılarına dağıtma bölümüne bakın.
Gradle'ı kullan
App Distribution Gradle eklentisini kullanarak App Distribution'ı Android oluşturma işleminize entegre etmek için Gradle'ı kullanın. Eklenti, test cihazlarınızı ve sürüm notlarınızı uygulamanızın build.gradle
dosyasında belirtmenize olanak tanır, bu da uygulamanızın farklı derleme türleri ve varyantları için dağıtımları yapılandırmanıza olanak tanır.
App Distribution'ı Gradle ile nasıl entegre edeceğinizi öğrenmek için Gradle kullanarak Android uygulamalarını test kullanıcılarına dağıtma bölümüne bakın.
Firebase CLI'yı kullanın
Yapıları test kullanıcılarına programlı olarak dağıtmak için App Distribution'ın sağladığı Firebase CLI araçlarını kullanın. Bir derleme için test ediciler ve sürüm notları belirleyebilirsiniz.
Uygulamanın Firebase Uygulama Kimliğini belirterek, isteğe bağlı olarak bir sürüm notu ve test kullanıcılarının e-postalarını içeren bir dosya ekleyerek en son Android derlemenizi dağıtın:
firebase appdistribution:distribute test.aab \
--app 1:1234567890:android:0a1b2c3d4e5f67890 \
--release-notes "Bug fixes and improvements" --testers-file testers.txt
Yapılarınızı otomatikleştirmek için Firebase CLI'yi kullanma hakkında daha fazla bilgi edinmek için Firebase CLI kullanarak Android uygulamalarını test kullanıcılarına dağıtma bölümüne bakın.
Kimlik doğrulaması için hizmet kimlik bilgilerini kullanın
Hizmet hesaplarıyla App Distribution fastlane eklentisini , Gradle eklentisini veya Firebase CLI'yi kullanın. Hizmet hesabı, uygulamaları (kullanıcıların aksine) temsil eden bir tür Google hesabıdır. CI sisteminiz, Uygulama Dağıtımı iş yüklerinizi çalıştırmak için hizmet hesaplarını kullanabilir. Daha fazla bilgi edinmek için bkz. Bir hizmet hesabıyla kimlik doğrulaması yapın.
İş yükü kimlik federasyonu kullanıyorsanız, hizmet hesabı anahtarı yerine bir kimlik bilgisi yapılandırma dosyası oluşturabilir ve kullanabilirsiniz.
Sürüm sınırlarını aklınızda bulundurun
Uygulama Dağıtımı, uygulama başına maksimum 1.000 sürümü destekler. Bu, sürüm sınırını aştığınızda App Distribution'ın sınırın üzerindeki en eski sürümleri otomatik olarak sildiği anlamına gelir. Sürüm limitlerini nasıl yöneteceğinizi öğrenmek için Uygulama sürümleri ne kadar süreyle kullanılabilir? bölümüne bakın.
Aynı test cihazı setini birden çok 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önetimi işlevini kullanın.
Aynı test kullanıcılarını birden çok sürüme eklemek için grupları kullanmanızı öneririz. Grup , erişim kontrol listesi görevi görür; Bir test kullanıcısını bir gruptan çıkardığınızda, o gruba dağıtılan tüm yayınlara erişimi kaybeder. Daha fazla bilgi için bkz. Bir grupta test kullanıcıları ekleme ve gruptan çıkarma .
Yönetecek çok sayıda test kullanıcınız varsa, Firebase konsolunu kullanarak test kullanıcılarını toplu olarak ekleyebilir ve silebilirsiniz . Test kullanıcılarının eklenmesini ve kaldırılmasını otomatikleştirmek için Firebase CLI , fastlane , Gradle veya genel Firebase App Distribution API'yi kullanın.
Test kullanıcısı sınırlarını unutmayın
Uygulama Dağıtımı, bir Firebase projesine veya Uygulama Dağıtımı grubuna ekleyebileceğiniz test kullanıcılarının sayısını sınırlar. Bu sınırları aştığınızda, uygulamanızı başka 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ısı eklemek için sınırlar var mı?
Potansiyel test kullanıcılarının test için kendi kendine kaydolmasını sağlayın
Uygulamanızı daha fazla test kullanıcısına dağıtmayı 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ı artırmanın sorunsuz bir yoludur.
Davet bağlantılarının kullanım örnekleri, şirketin test sürümü programlarını, büyük QA ekiplerine sahip kuruluşları ve bireysel müşterilerin test kullanıcısı erişimini kontrol edebilmesini isteyen geliştirici gruplarını içerir.
Bir grup için davet bağlantısı oluşturmanızı öneririz. Davet bağlantısını kullanarak kaydolan herhangi bir test kullanıcısı sonraki sürümlere otomatik olarak eklenir.
Daha fazla bilgi edinmek için bkz. Davet bağlantıları oluşturma ve Test kullanıcılarını bir gruptan ekleme ve gruptan çıkarma .
Test kullanıcılarının ilgilendiğiniz sürümü test ettiğinden emin olun
Yeni bir sürüm yüklendiğinde, test kullanıcılarınız e-posta ile bilgilendirilir. Bu bildirime ek olarak, test kullanıcılarınızın ilgilendiğiniz belirli uygulama sürümünü test ettiğinden emin olmak için aşağıdaki özellikleri (sürüm bağlantıları ve uygulama içi uyarılar) kullanabilirsiniz:
- Sürüm bağlantıları: Belirli bir sürümü test edicilerle 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ılar, derleme otomasyon araçlarınızla birlikte kullanmak için Firebase , fastlane ve Gradle komut satırı (CLI) araçlarımızla da kullanılabilir.
- Uygulama içi uyarılar: Test kullanıcılarınızın uygulamanızın en son sürümünü test ettiğinden emin olmak istediğinizde bu uyarıları kullanın. Firebase App Distribution Android SDK'yı entegre ederek, uygulamanızın yeni sürümleri 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ın nasıl ekleneceğini öğrenmek için Test kullanıcılarına yeni derlemeler hakkında bilgi verme bölümüne bakın.
Şirketten ayrılan test kullanıcıları için erişimi otomatik olarak kaldır
CI/CD dahili test akışınız çalışır durumdayken, şirketten ayrılan kişilerin artık dahili yapılarınıza erişimi olmadığından emin olmanız gerekir. Yapılara test kullanıcısı erişimini yönetmenize yardımcı olmak için App Distribution aşağıdaki seçenekleri sunar:
- fastlane: Fastfile dosyanızı kullanın veya doğrudan fastlane eylemlerini çalıştırın. Daha fazla bilgi edinmek için Fastlane kullanarak Android uygulamalarını test kullanıcılarına dağıtma bölümüne bakın.
- Firebase CLI:
firebase appdistribution:testers:remove
eylemini kullanın. Daha fazla bilgi edinmek için Firebase CLI kullanarak Android uygulamalarını test kullanıcılarına dağıtma bölümüne bakın. - Gradle: Test cihazlarını kaldırmak için Gradle kullanıyorsanız,
build.gradle
dosyanızda
ve-- PROJECT_NUMBER
bağımsız değişkenleriyle-- EMAILSappDistributionRemoveTesters
iletin. Daha fazla bilgi edinmek için Android uygulamalarını Gradle kullanarak test kullanıcılarına dağıtma bölümüne bakın. - Genel Firebase Uygulama Dağıtımı API'si :
testers.batchRemove
uç noktasını kullanın.