Bu belgede, Apple platformunuzun yayın öncesi test iş akışlarını CI/CD ortamında sürdürülebilir ve tekrarlanabilir hale getirmek için Firebase App Distribution ve kısayol yolunu kullanmayla ilgili en iyi uygulamalar açıklanmaktadır. Bu dokümanda Fastlane'e odaklanmakla birlikte, size daha fazla esneklik sunmak için Firebase konsolu, Firebase KSA ve herkese açık Firebase App Distribution API üzerinden kullanılabilen çözümleri de açıklıyoruz. 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.
Ayrıca Android kullanıyorsanız CI/CD kullanarak Android uygulamalarını KG test kullanıcılarına dağıtmayla ilgili en iyi uygulamalar bölümüne bakın.
Başlamadan önce
Bu dokümandaki en iyi uygulamalardan önce her uygulama için Firebase konsolunda App Distribution özelliğini etkinleştirdiğinizden emin olun. App Distribution uygulamasını etkinleştirmezseniz 404 hatası alırsınız.
App Distribution'ü etkinleştirmek için aşağıdaki adımları uygulayın:
Firebase konsolunda App Distribution sayfasını açın.
iOS uygulamanızı seçin.
Başlayın'ı tıklayın.
CI/CD'yi 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'i kullanmanızı öneririz. Diğer bir seçenek de çok çeşitli Firebase ürünlerine erişmenizi sağlayan Firebase KSA'yı kullanmaktır.
fastlane'i kullanma
iOS ve Android uygulamalarının geliştirilip yayınlanmasını otomatikleştiren açık kaynaklı bir araç olan fastlane'i kullanarak App Distribution hizmetini 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 Fastlane'i kullanarak iOS uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin. Ayrıca, hızlı entegrasyon sürecinde size yol gösterecek bir codelab'e de göz atın.
Firebase KSA'yı kullan
Derlemeleri test kullanıcılarına programatik olarak dağıtmak için App Distribution tarafından sağlanan 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 son iOS derlemeniz test.ipa
'i 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.ipa \ --app 1:1234567890:ios: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 isterseniz Firebase KSA'yı kullanarak iOS uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin.
Kimlik doğrulama için hizmet kimlik bilgilerini kullanma
Uygulama Varsayılan Kimlik Bilgileri'nden yararlanan ve CI'nizi yönetmenize yardımcı olan App Distribution fastlane 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 edinmek 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. Diğer bir deyişle, sürüm sınırını aştığınızda App Distribution, 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ılarını birden fazla sürüme ekleme
Sürümlerinize çok sayıda test kullanıcısı eklemek istiyorsanız App Distribution ürününü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 görevi 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ını ekleme ve kaldırma işlemlerini otomatikleştirmek için Firebase CLI, fastlane veya herkese açık Firebase App Distribution API'sini 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ısı eklemeyle ilgili sınırlamalar var mı? başlıklı makaleyi inceleyin.
Yeni iOS test kullanıcısı cihazlarını yönetin ve otomatik olarak ekleyin
App Distribution, ek iOS test kullanıcısı cihazlarını kaydetmenize yardımcı olmak için sizi e-posta veya CSV dosyaları aracılığıyla yeni test kullanıcısı iOS cihazları hakkında bilgilendirerek Apple Geliştirici Portalı'nda iOS test kullanıcısı cihazlarınızı yönetmenize yardımcı olur. Daha fazla bilgi edinmek için Test kullanıcılarını CSV dosyalarından içe aktarma başlıklı makaleyi inceleyin. Ayrıca, Fastlane kullanarak yeni cihazları programatik olarak dışa aktarabilirsiniz.
UDID'leri otomatik olarak indiren, Apple geliştirici konsoluna ekleyen ve ardından uygulamayı yeniden oluşturup dağıtan bir Fastlane işleminin nasıl ayarlanacağını öğrenmek için App Distribution ve Fastlane ile yayın öncesi iOS derlemelerinizi daha hızlı dağıtma başlıklı makaleyi inceleyin.
Potansiyel test kullanıcılarının teste kendi kendilerine kaydolmasını sağlama
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 ü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 içi test programları, büyük QA 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ısı 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-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 iOS uygulamalarını test kullanıcılarına dağıtma konusuna göz atın. Bu bağlantılar, derleme otomasyon araçlarınızla birlikte kullanmak için Firebase ve fastlane 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 iOS 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ıları nasıl ekleyeceğinizi öğrenmek 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 oluşturup çalışır hale geldikten sonra, şirketten ayrılan kişilerin dahili derlemelerinize artık 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. Test kullanıcılarını kaldırmak için fastlane'i kullanma hakkında daha fazla bilgi edinmek isterseniz Fastlane kullanarak iOS uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin.
Herkese açık Firebase App Distribution API:
testers.batchRemove
uç noktasını kullanın.