Android uygulamalarını CI/CD kullanarak kalite güvencesi test kullanıcılarına dağıtmayla ilgili en iyi uygulamalar

Bu dokümanda, 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 tanıtılmaktadır. Çözümler arasında Gradle ve fastlane yer alır. Ancak size daha da fazla esneklik sunmak için Firebase konsolu, Firebase CLI ve herkese açık FirebaseApp Distribution API üzerinden kullanılabilen çözümleri de dahil ettik. Ayrıca, en iyi deneyim için önceden plan yapabilmeniz amacıyla sürüm ve test kullanıcısı sınırlarını da açıklarız.

Apple platformlarını da kullanıyorsanız CI/CD ve fastlane'i kullanarak Apple uygulamalarını QA test kullanıcılarına dağıtmayla ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

Başlamadan önce

Bu belgedeki en iyi uygulamaları uygulamadan önce Firebase konsolunda App Distribution'yi her uygulama için etkinleştirdiğinizden emin olun. App Distribution'yi etkinleştirmediyseniz 404 hatası alırsınız.

App Distribution'ü etkinleştirmek için aşağıdaki adımları uygulayın:

  1. Firebase konsolunda App Distribution sayfasını açın.
  2. Android uygulamanızı seçin.
  3. Başlayın'ı tıklayın.

Android App Bundle'ların (AAB) en yaygın Android paketi biçimi haline geldiği göz önüne alındığında, Google Play bağlantısını kullanarak AAB'ları 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

Uygulamaları derleyip test kullanıcılarınıza yayınlamayı otomatikleştirmek istiyorsanız ve CI/CD kullanıyorsanız fastlane veya Gradle'i kullanmanızı öneririz. Diğer bir seçenek de çok çeşitli Firebase ürünlerine erişmenizi sağlayan Firebase CLI'yi kullanmaktır.

fastlane'i kullanma

iOS ve Android uygulamalarının derlenmesini ve yayınlanmasını otomatikleştiren açık kaynak bir araç olan fastlane'i kullanarak App Distribution'ü CI/CD ardışık düzeninize entegre edin. En son sürümlerinizi otomatik olarak derleyip test kullanıcılarına 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ğlayabilirsiniz.

App Distribution'ü fastlane ile nasıl entegre edeceğinizi öğrenmek için fastlane'i kullanarak Android uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin.

Gradle'ı kullanma

App Distribution Gradle eklentisini kullanarak App Distribution'ü Android derleme sürecinize entegre etmek için Gradle'i kullanın. Bu 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 Gradle'i kullanarak Android uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin.

Firebase KSA'yı kullanma

Derlemeleri test kullanıcılarına programatik olarak dağıtmak için App Distribution tarafından sağlanan Firebase KSA araçlarını kullanın. Bir derleme için test kullanıcılarını ve sürüm notlarını belirtebilirsiniz.

Uygulamanın Firebase uygulama kimliğini belirterek en son Android derlemenizi dağıtın, isteğe bağlı olarak bir sürüm notu ve test kullanıcılarının e-postalarını içeren bir dosya ekleyin:

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

Derlemelerinizi otomatikleştirmek için Firebase KSA'yı kullanma hakkında daha fazla bilgi edinmek istiyorsanız Firebase KSA'yı kullanarak Android uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin.

Kimlik doğrulama için hizmet kimlik bilgilerini kullanma

App Distribution fastlane eklentisini, Gradle eklentisini veya hizmet hesaplarıyla Firebase CLI'yi 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 için Hizmet hesabıyla kimlik doğrulama başlıklı makaleyi inceleyin.

Workload Identity federasyonu kullanıyorsanız hizmet hesabı anahtarı yerine kimlik bilgisi yapılandırma dosyası oluşturabilir ve 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. 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 sınırlarını nasıl yöneteceğinizi öğrenmek için Uygulama sürümleri ne kadar süreyle kullanılabilir? başlıklı makaleyi inceleyin.

Aynı test kullanıcılarını birden fazla sürüme ekleme

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 fazla sürüme eklemek için grupları kullanmanızı öneririz. Grup, erişim denetimi listesi gibi çalışır. Bir test kullanıcısını gruptan kaldırdığınızda, söz konusu kullanıcı o gruba dağıtılan tüm sürümlere erişimi kaybeder. Daha fazla bilgi edinmek için Test kullanıcılarını gruplara ekleme ve gruplardan kaldırma başlıklı makaleyi inceleyin.

Yönetmeniz gereken ç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ı ekleme ve kaldırma işlemlerini otomatikleştirmek için Firebase CLI, fastlane, Gradle veya herkese açık Firebase App Distribution API'sini kullanın.

Test kullanıcısı 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ı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ı eklemeyle ilgili sınırlamalar var mı? başlıklı makaleyi inceleyin.

Potansiyel test kullanıcılarının teste kendi kendilerine kaydolmasını etkinleştirme

Uygulamanızı daha fazla test kullanıcısına dağıtmayı kolaylaştırmak için davet bağlantıları kullanmanızı öneririz. Davet bağlantısı, test kullanıcılarının bir uygulamayı test etmek için kaydolmak üzere e-posta adreslerini girmelerine olanak tanıyan benzersiz bir URL'dir. Kullanıcıların kendilerini uygulama test kullanıcıları listenize eklemelerine olanak tanıyarak dahili test tabanınızı sorunsuz bir şekilde artırabilirsiniz.

Davet bağlantılarının kullanım alanları arasında şirket içi test programları, büyük QA ekipleri olan kuruluşlar ve bireysel müşterilerin test kullanıcısı erişimini kontrol edebilmesini isteyen geliştirici grupları yer alır.

Grup için davet bağlantısı oluşturmanızı öneririz. Davet bağlantısını kullanarak kaydolan tüm test kullanıcıları sonraki sürümlere otomatik olarak eklenir.

Daha fazla bilgi edinmek için Davet bağlantıları oluşturma ve Gruplara test kullanıcıları ekleme ve kaldırma başlıklı makaleleri inceleyin.

Test kullanıcılarının sizin için önemli olan 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 bildirimi desteklemek için test kullanıcılarınızın önemsediğiniz belirli uygulama sürümünü test etmesini sağlamak amacıyla 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 kullanıcılarıyla paylaşmak istediğinizde bu özelliği kullanın. Sürüm bağlantılarını nasıl kullanacağınızı öğrenmek için Firebase konsolunu kullanarak Android uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin. 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ızda 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'sını entegre ederek, uygulamanızın yeni derlemeleri kullanıma sunulduğunda test kullanıcılarınıza doğrudan uygulama içinde uyarılar gösterebilirsiniz. Uygulama içi uyarı ekleme hakkında bilgi edinmek için Test kullanıcılarını yeni sürümler hakkında bilgilendirme başlıklı makaleyi inceleyin.

Şirketten ayrılan test kullanıcılarının erişimini otomatik olarak kaldırma

CI/CD dahili test akışınız kullanıma hazır olduğunda, şirketten ayrılan kişilerin artık dahili derlemelerinize erişemediğ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: