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

Bu belgede, Apple platformu 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 ve fastlane'i kullanmayla ilgili en iyi uygulamalar açıklanmaktadır. Bu belgede fastlane'e odaklanılsa da size daha fazla esneklik sağlamak için Firebase konsolu, Firebase CLI ve herkese açık Firebase App Distribution API aracılığıyla sunulan çözümler de açıklanmaktadır. Ayrıca, en iyi deneyimi önceden planlayabilmeniz için sürüm ve test kullanıcısı sınırlarını da açıklıyoruz.

Android de kullanıyorsanız CI/CD kullanarak Android uygulamalarını kalite güvencesi test kullanıcılarına dağıtmayla ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

Başlamadan önce

Bu belgedeki en iyi uygulamaları hayata geçirmeden önce Firebase Console'da her uygulama için App Distribution hizmetini etkinleştirdiğinizden emin olun. App Distribution hizmetini etkinleştirmediyseniz 404 hatası alırsınız.

App Distribution özelliğini etkinleştirmek için aşağıdaki adımları uygulayın:

  1. Firebase konsolunda App Distribution sayfasını açın.

  2. iOS uygulamanızı seçin.

  3. Get Started'ı (Başlayın) tıklayın.

CI/CD kullanarak yayın öncesi test iş akışınızı otomatikleştirme

Uygulama derleme ve test kullanıcılarınıza yayınlama işlemlerini otomatikleştirmek istiyorsanız ve CI/CD kullanıyorsanız fastlane'i kullanmanızı öneririz. Bir diğer seçenek de çok çeşitli Firebase ürünlerine erişmenizi sağlayan Firebase CLI'yı kullanmaktır.

Fastlane'i kullanma

iOS ve Android uygulamalarının derlenmesini ve yayınlanmasını otomatikleştiren açık kaynaklı bir araç olan fastlane'i kullanarak App Distribution'i 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ğlarsınız.

App Distribution'i 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. fastlane entegrasyon sürecinde size yol gösterecek codelab'e de göz atın.

Firebase CLI'yı kullanma

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ını ve sürüm notlarını belirtebilirsiniz.

Uygulamanın Firebase uygulama kimliğini belirterek en son iOS derlemenizi test.ipa dağıtın. İsteğe bağlı olarak bir sürüm notu ve test kullanıcılarının e-posta adreslerini 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 CLI'yı kullanma hakkında daha fazla bilgi edinmek istiyorsanız Firebase CLI'yı kullanarak iOS uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin.

Kimlik doğrulaması için hizmet kimlik bilgilerini kullanma

Uygulama Varsayılan Kimlik Bilgileri'nden yararlanan ve CI'nızı yönetmenize yardımcı olan hizmet hesaplarıyla App Distribution fastlane eklentisini veya Firebase CLI'yı kullanın. Hizmet hesabı, kullanıcılar yerine 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 federasyonunu kullanıyorsanız hizmet hesabı anahtarı yerine kimlik bilgisi yapılandırma dosyası oluşturup kullanabilirsiniz.

Sürüm sınırlarını göz önünde bulundurun

App Distribution, uygulama başına en fazla 1.000 sürümü destekler. Bu nedenle, 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ı 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ı grubunu birden fazla sürüme ekleme

Sürümlerinize çok sayıda test kullanıcısı eklemek istiyorsanız App Distribution uygulamasını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 işlevi görür. Bir test kullanıcısını gruptan kaldırdığınızda, o gruba dağıtılan tüm sürümlere erişimini kaybeder. Daha fazla bilgi edinmek için Gruba test kullanıcısı ekleme ve gruptan test kullanıcısı 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 ekleyip 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'yi 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ırlar var mı? başlıklı makaleyi inceleyin.

Yeni iOS test cihazlarını yönetme ve otomatik olarak ekleme

Ek iOS test cihazları kaydetmenize yardımcı olmak için App Distribution, e-posta veya CSV dosyaları kullanarak yeni test iOS cihazları hakkında sizi bilgilendirerek Apple Geliştirici Portalı'nda iOS test cihazlarınızı yönetmenize yardımcı olur. Daha fazla bilgi edinmek için CSV dosyalarından test kullanıcılarını içe aktarma başlıklı makaleyi inceleyin. Ayrıca fastlane kullanarak yeni cihazları programatik olarak dışa aktarabilirsiniz.

UDID'leri otomatik olarak alan, Apple geliştirici konsoluna ekleyen, ardından uygulamayı yeniden derleyip dağıtan bir fastlane işlemi oluşturmayı öğ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 test için kendi kendilerine kaydolmalarına izin verme

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 e-posta adreslerini girerek bir uygulamayı test etmek için kaydolmalarını sağlayan benzersiz bir URL'dir. Kullanıcıların kendilerini uygulama test kullanıcıları listenize eklemelerine olanak tanımak, dahili test tabanınızı artırmanın sorunsuz bir yoludur.

Davet bağlantıları, şirketlerin dogfood programları, büyük kalite güvencesi ekipleri olan kuruluşlar ve test kullanıcısı erişimini bireysel müşterilerin kontrol edebilmesini isteyen geliştirici grupları tarafından kullanılabilir.

Bir 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 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 desteklemek 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 ilgilendiğiniz belirli uygulama sürümünü test ettiğinden 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ı nasıl kullanacağınızı öğrenmek için Firebase konsolunu kullanarak iOS uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin. Bu bağlantılar, derleme otomasyonu araçlarınızla kullanabileceğiniz Firebase ve fastlane komut satırı (CLI) araçlarımızda da mevcuttur.

  • 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ılardan yararlanı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ın nasıl ekleneceğini öğrenmek için Test kullanıcılarını yeni derlemeler 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 çalışmaya başladıktan sonra, şirketten ayrılan kişilerin dahili derlemelerinize erişiminin kaldırıldığından 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: