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 ön sürüm 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 tanıtılmaktadır. Bu belgede fastlane'e odaklanılsa da size daha fazla esneklik sağlamak için Firebase konsolu, Firebase KSA'sı ve herkese açık Firebase App Distribution API'si üzerinden kullanılabilen çözümleri de açıklıyoruz. Ayrıca, en iyi deneyimi sunmak için önceden plan yapabilmeniz amacıyla sürüm ve test kullanıcılarıyla ilgili sınırlamaları da açıklıyoruz.

Android kullanıyorsanız CI/CD kullanarak Android uygulamalarını kalite denetimi 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 App Distribution'yı Firebase konsolunda her uygulama için etkinleştirdiğinizden emin olun. App Distribution'yı etkinleştirmediyseniz 404 hatası alırsınız.

App Distribution özelliğini etkinleştirmek için şu 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

Uygulamaları test kullanıcılarınıza oluşturma ve yayınlama sürecini 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 CLI'yı kullanmaktır.

fastlane'i kullanma

iOS ve Android uygulamalarının oluşturulmasını ve yayınlanmasını otomatikleştiren açık kaynaklı bir araç olan fastlane'i kullanarak App Distribution'yı CI/CD ardışık düzeninize entegre edin. En son sürümlerinizi otomatik olarak oluşturup 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 entegre etmeyi öğrenmek için fastlane kullanarak iOS uygulamalarını test kullanıcılarına dağıtma başlıklı makaleyi inceleyin. Ayrıca, fastlane entegrasyon sürecinde size yol gösteren bir codelab'e de göz atabilirsiniz.

Firebase KSA'sını kullanma

App Distribution'ın sağladığı Firebase KSA araçlarını kullanarak derlemeleri test kullanıcılarına programatik olarak dağıtın. Bir derleme için test kullanıcılarını ve sürüm notlarını belirtebilirsiniz.

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

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

Firebase KSA'yı kullanarak derlemelerinizi otomatikleştirmek hakkında daha fazla bilgi edinmek için 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

App Distribution fastlane eklentisini veya Firebase CLI'yı, Uygulama Varsayılan Kimlik Bilgileri'nden yararlanan ve CI'nizi yönetmenize yardımcı olan hizmet hesaplarıyla birlikte 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ı ile kimlik doğrulama başlıklı makaleyi inceleyin.

İş yükü kimliği federasyonunu kullanıyorsanız hizmet hesabı anahtarı yerine kimlik bilgisi yapılandırma dosyası oluşturup kullanabilirsiniz.

Yayın sınırlarını göz önünde bulundurma

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ını birden fazla sürüme ekleme

Yayınlarınıza çok sayıda test kullanıcısı eklemek istiyorsanız App Distribution'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 kontrol listesi olarak işlev görür. Bir test kullanıcısını gruptan kaldırdığınızda, bu test kullanıcısı gruba dağıtılan tüm sürümlere erişimini kaybeder. Daha fazla bilgi edinmek için Bir 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'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ı 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ı ekleme konusunda 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ını kaydetmenize yardımcı olmak için App Distribution, e-posta veya CSV dosyaları aracılığıyla yeni test kullanıcısı iOS cihazları hakkında sizi bilgilendirerek Apple Developer Portal'daki iOS test cihazlarınızı yönetmenize yardımcı olur. Daha fazla bilgi 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 çeken, bunları Apple geliştirici konsoluna ekleyen, ardından uygulamayı yeniden oluşturup dağıtan bir fastlane işlemi ayarlamayı öğrenmek için App Distribution ve fastlane ile yayın öncesi iOS derlemelerinizi daha hızlı dağıtın başlıklı makaleye bakın.

Potansiyel test kullanıcılarının teste kendi kendilerine kaydolmalarını sağlama

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 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 izin vermek, dahili test kullanıcı tabanınızı artırmanın sorunsuz bir yoludur.

Davet bağlantılarının kullanım alanları arasında şirketin kendi ürünlerini test ettiği programlar, büyük kalite güvencesi ekiplerine sahip kuruluşlar ve bağımsız müşterilerin test uzmanı 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 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 Bir gruba test kullanıcıları ekleme ve gruptan test kullanıcılarını 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 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 etmesini sağlayabilirsiniz:

  • 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 iOS uygulamalarını Firebase konsolunu kullanarak test kullanıcılarına dağıtma başlıklı makaleyi inceleyin. Bu bağlantılar, derleme otomasyonu araçlarınızla kullanılmak üzere 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ı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 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ş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: