Bu belge, Apple platformu 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 ve fastlane kullanımına yönelik en iyi uygulamaları tanıtmaktadır. Bu belge fastlane'e odaklanırken, size daha fazla esneklik sağlamak için Firebase konsolu, Firebase CLI ve genel Firebase App Distribution API aracılığıyla sunulan çözümleri de açıklıyoruz. En iyi deneyimi önceden planlayabilmeniz için 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ı 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.
iOS uygulamanızı seçin.
Başlayın'ı tıklayın.
CI/CD 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 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 iOS uygulamalarını fastlane kullanarak test edicilere dağıtma bölümüne bakın. Fastlane entegrasyon sürecinde size yol gösterecek bir codelab'e de 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 iOS derleme 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
Yapılarınızı otomatikleştirmek için Firebase CLI'yi kullanma hakkında daha fazla bilgi edinmek için Firebase CLI kullanarak iOS 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
Uygulama Dağıtımı fastlane eklentisini veya Firebase CLI'yi, Uygulama Varsayılan Kimlik Bilgilerinden yararlanan ve CI'nizi yönetmenize yardımcı olan hizmet hesaplarıyla birlikte kullanın. Bir hizmet hesabı, kullanıcıların aksine uygulamaları 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. Bir grup, bir 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 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ı?
Yeni iOS test cihazı cihazlarını yönetin ve otomatik olarak ekleyin
App Distribution, ek iOS test cihazı cihazlarını kaydetmenize yardımcı olmak için sizi yeni test cihazı iOS cihazları hakkında e-posta veya CSV dosyaları aracılığıyla bilgilendirerek Apple Developer Portal'da iOS test cihazı 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 bölümüne bakın. Ayrıca fastlane kullanarak yeni cihazları programlı olarak dışa aktarabilirsiniz .
UDID'leri otomatik olarak aşağı çeken, onları Apple geliştirici konsoluna ekleyen ve ardından uygulamayı yeniden oluşturup dağıtan bir hızlı şerit eyleminin nasıl ayarlanacağını öğrenmek için bkz.
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 iOS 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 ve fastlane 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 iOS 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ışmaya başladığında, ş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. Test kullanıcılarını kaldırmak için fastlane kullanma hakkında daha fazla bilgi edinmek için iOS uygulamalarını fastlane kullanarak test kullanıcılarına dağıtma bölümüne bakın.
Genel Firebase Uygulama Dağıtımı API'si :
testers.batchRemoveuç noktasını kullanın.