iOS ve Android uygulamaları oluşturmayı ve yayınlamayı otomatikleştiren açık kaynaklı bir platform olan fastlane'i kullanarak derlemeleri test kullanıcılarına dağıtabilirsiniz. Bir Fastfile
içinde tanımlanan basit talimatları takip eder. fastlane ve Fastfile
sonra, App Distribution'ı fastlane yapılandırmanızla entegre edebilirsiniz.
Adım 1. Fastlane'i kurun
Fastlane yapılandırmanıza Uygulama Dağıtımı eklemek için iOS projenizin kökünden aşağıdaki komutu çalıştırın:
fastlane add_plugin firebase_app_distribution
Komut sizden bir seçenek isterse,
Option 3: RubyGems.org
seçin.
2. Adım. Firebase ile kimlik doğrulaması yapın
Fastlane eklentisini kullanabilmeniz için önce Firebase projenizde aşağıdaki yollardan biriyle kimlik doğrulaması yapmalısınız. Varsayılan olarak fastlane eklentisi, başka bir kimlik doğrulama yöntemi kullanılmıyorsa Firebase CLI'den kimlik bilgilerini arar.
Bir hizmet hesabıyla kimlik doğrulama, eklentiyi sürekli entegrasyon (CI) sisteminizle esnek bir şekilde kullanmanıza olanak tanır. Hizmet hesabı kimlik bilgilerini sağlamanın iki yolu vardır:
- Hizmet hesabı anahtar dosyanızı
firebase_app_distribution
eylemine iletin. Derleme ortamınızda hizmet hesabı anahtar dosyanız zaten varsa, bu yöntemi uygun bulabilirsiniz. -
GOOGLE_APPLICATION_CREDENTIALS
ortam değişkenini hizmet hesabı anahtar dosyanızı işaret edecek şekilde ayarlayın. Başka bir Google hizmeti (ör. Google Cloud) için önceden yapılandırılmış Uygulama Varsayılan Kimlik Bilgileriniz (ADC) varsa bu yöntemi tercih edebilirsiniz.
- Google Cloud Console'da projenizi seçin ve yeni bir hizmet hesabı oluşturun.
- Firebase Uygulama Dağıtım Yöneticisi rolünü ekleyin.
- Özel bir json anahtarı oluşturun ve anahtarı, yapı ortamınızın erişebileceği bir konuma taşıyın. Firebase projenizde App Distribution'a yönetici erişimi verdiği için bu dosyayı güvenli bir yerde sakladığınızdan emin olun .
- Uygulamanızı 20 Eylül 2019'dan sonra oluşturduysanız bu adımı atlayın: Google API'leri konsolunda Firebase Uygulama Dağıtım API'sini etkinleştirin. İstendiğinde, Firebase projenizle aynı ada sahip projeyi seçin.
Hizmet hesabı kimlik bilgilerinizi sağlayın veya bulun:
- Hizmet hesabı anahtarınızı şeridinizin
firebase_app_distribution
için, özel anahtar JSON dosyanızın yolu ileservice_credentials_file
parametresini ayarlayın ADC ile kimlik bilgilerinizi bulmak için
GOOGLE_APPLICATION_CREDENTIALS
ortam değişkenini özel anahtar JSON dosyasının yoluna ayarlayın. Örneğin:export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
ADC ile kimlik doğrulama hakkında daha fazla bilgi için Uygulamanız için kimlik bilgileri sağlama konusunu okuyun.
- Hizmet hesabı anahtarınızı şeridinizin
Projenizin kimliğini nasıl doğrulayacağınıza ilişkin talimatlar için Firebase CLI ile oturum açma bölümüne bakın.
3. Adım. Fastfile'ınızı kurun ve uygulamanızı dağıtın
- Bir
./fastlane/Fastfile
şeridinde, birfirebase_app_distribution
bloğu ekleyin. Dağıtımı yapılandırmak için aşağıdaki parametreleri kullanın:firebase_app_distribution parametreleri app
Yalnızca uygulamanız bir Firebase yapılandırma dosyası (
GoogleService-Info.plist
) içermiyorsa gereklidir : Uygulamanızın Firebase Uygulama Kimliği. Uygulama Kimliğini Firebase konsolunda, Genel Ayarlar sayfasında bulabilirsiniz .app: "1:1234567890:ios:0a1b2c3d4e5f67890"
googleservice_info_plist_path
Arşivlenen ürün yoluna göre
GoogleService-Info.plist
dosyanızın yolu. Varsayılan olarakGoogleService-Info.plist
olarak ayarlayın.app
parametresi belirtilmemişse dosya, uygulamanızın Firebase Uygulama Kimliğini almak için kullanılır.firebase_cli_token
Eklentinin oturum açma işlemini çalıştırdığınızda (yukarıdaki Bir Google hesabı kullanarak kimlik doğrulama konusuna bakın) veya CI ortamınızın kimliğini Firebase CLI ile doğruladığınızda (daha fazla bilgi için CI sistemleriyle CLI'yi kullanma konusunu okuyun) yazdırılan bir yenileme belirteci.
service_credentials_file
Google hizmet hesabı json dosyanızın yolu. Hizmet hesabı kimlik bilgilerini kullanarak nasıl kimlik doğrulama yapacağınızı öğrenmek için yukarıya bakın.
ipa_path
apk_path
değiştirir (kullanımdan kaldırıldı). Yüklemek istediğiniz IPA dosyasının mutlak yolu. Belirtilmezse, hızlı şerit, dosyanın oluşturulduğu şeritten dosyanın konumunu belirler.release_notes
release_notes_file
Bu yapı için sürüm notları.
Sürüm notlarını doğrudan belirtebilirsiniz:
release_notes: "Text of release notes"
Veya düz metin dosyasının yolunu belirtin:
release_notes_file: "/path/to/release-notes.txt"
testers
testers_file
Davet etmek istediğiniz test kullanıcılarının e-posta adresleri.
Test kullanıcılarını virgülle ayrılmış e-posta adresleri listesi olarak belirtebilirsiniz:
testers: "ali@example.com, bri@example.com, cal@example.com"
Veya, virgülle ayrılmış bir e-posta adresleri listesi içeren bir düz metin dosyasının yolunu belirtebilirsiniz:
testers_file: "/path/to/testers.txt"
groups
groups_file
Davet etmek istediğiniz test kullanıcısı grupları (bkz. Test kullanıcılarını yönetme ). Gruplar kullanılarak belirtilir
grup takma adları , Firebase konsolunda arayabilirsiniz.Grupları virgülle ayrılmış liste olarak belirtebilirsiniz:
groups: "qa-team, trusted-testers"
Veya virgülle ayrılmış grup adları listesi içeren düz metin dosyasının yolunu belirtebilirsiniz:
groups_file: "/path/to/groups.txt"
debug
Bir boole bayrağı. Ayrıntılı hata ayıklama çıktısını yazdırmak için bunu
true
olarak ayarlayabilirsiniz.
Örneğin:
platform :ios do desc "My awesome app" lane :distribute do build_ios_app(...) # build_ios_app is a built-in fastlane action. firebase_app_distribution( app: "1:123456789:ios:abcd1234", testers: "tester1@company.com, tester2@company.com", release_notes: "Lots of amazing new features to test out!" ) end end
Derlemeyi test kullanıcılarının kullanımına sunmak için şeridinizi çalıştırın:
fastlane <lane>
Derlemenizi dağıttıktan sonra, 150 gün boyunca Firebase konsolunun Uygulama Dağıtımı panosunda bulunur. Derlemenin süresinin dolmasına 30 gün kala konsolda ve test cihazının test cihazındaki derlemeler listesinde bir sona erme bildirimi görünür.
Daha önce uygulamayı test etmeye davet edilmemiş olan test kullanıcıları, başlamak için e-posta davetiyeleri alır. Mevcut test kullanıcıları, yeni bir derlemenin test edilmeye hazır olduğuna dair e-posta bildirimleri alır. Test uygulamasının nasıl yükleneceğini öğrenmek için Test kullanıcısı olarak kurulum yapma bölümüne bakın. Daveti kabul edip etmediklerini ve uygulamayı Firebase konsolunda indirip indirmediklerini belirlemek için her test kullanıcısının durumunu izleyebilirsiniz.
(İsteğe bağlı) App Distribution'da her yeni sürüm oluşturduğunuzda yapı numaranızı otomatik olarak artırmak için firebase_app_distribution_get_latest_release
eylemini ve increment_build_number
eylemini kullanabilirsiniz. Aşağıdaki kod, yapı numaranızı otomatik olarak nasıl artıracağınıza dair bir örnek sağlar:
lane :increment_version do
latest_release = firebase_app_distribution_get_latest_release(
app: "<your Firebase app ID>"
)
increment_build_number({ build_number: latest_release[:buildVersion].to_i + 1 })
end
Bu hızlı şerit eklenti özelliği hakkında daha fazla bilgi edinmek için Uygulamanızın en son sürümü hakkında bilgi alma konusuna bakın.
Adım 4 (Opsiyonel). Dağıtım için test kullanıcılarını yönetin
Fastfile
dosyanızı kullanarak veya doğrudan fastlane eylemlerini çalıştırarak uygulama sürümünüze test kullanıcıları ekleyebilir ve kaldırabilirsiniz. Çalıştırma eylemleri, Fastfile
ayarlanan değerleri doğrudan geçersiz kılar.
Firebase projenize bir test kullanıcısı eklendiğinde, bunları ayrı sürümlere ekleyebilirsiniz. Firebase projenizden kaldırılan test kullanıcılarının artık projenizdeki sürümlere erişimi yoktur, ancak bir süreliğine sürümlerinize erişimlerini koruyabilirler.
Fastfile
kullan
# Use lanes to add or remove testers from an app release. lane(:add_testers) do firebase_app_distribution_add_testers( emails: "foo@google.com,bar@google.com" # or file: "/path/to/testers.txt" ) end lane(:remove_testers) do firebase_app_distribution_remove_testers( emails: "foo@google.com,bar@google.com" # or file: "/path/to/testers.txt" ) endtutucu13 l10n-yer
# Add or remove testers with the terminal $ fastlane add_testers $ fastlane remove_testers
Hızlı şerit eylemlerini çalıştırın
fastlane run firebase_app_distribution_add_testers emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers emails:"foo@google.com,bar@google.com"
Test kullanıcılarını --emails yerine --file="/path/to/testers.txt
--emails
da belirtebilirsiniz.
firebase_app_distribution_add_testers
ve firebase_app_distribution_remove_testers
görevleri de aşağıdaki bağımsız değişkenleri kabul eder:
-
project_name
: Firebase proje numaranız. -
service_credentials_file
: Google hizmeti kimlik bilgileri dosyanızın yolu. -
firebase_cli_token
: Firebase CLI için yetkilendirme belirteci.
service_credentials_file
ve firebase_cli_token
, yükleme eylemi tarafından kullanılan argümanlarla aynıdır.
Adım 5 (Opsiyonel). Uygulamanızın en son sürümü hakkında bilgi alın
firebase_app_distribution_get_latest_release
eylemini, uygulama sürüm bilgileri, sürüm notları ve oluşturma zamanı dahil olmak üzere uygulamanızın App Distribution'daki en son sürümü hakkında bilgi almak için kullanabilirsiniz. Kullanım durumları, sürümü otomatik olarak artırmayı ve önceki sürümden sürüm notlarını taşımayı içerir.
Eylemin dönüş değeri, en son sürümü temsil eden bir karmadır. Bu karma, lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE]
kullanılarak da kullanılabilir. Bu karmadaki kullanılabilir alanlar hakkında daha fazla bilgi için REST API belgelerine bakın.
parametreler
firebase_app_distribution_get_latest_release parametreleri | |
---|---|
app | Yalnızca uygulamanız bir Firebase yapılandırma dosyası ( app: "1:1234567890:ios:0a1b2c3d4e5f67890" |
googleservice_info_plist_path | Arşivlenen ürün yoluna göre |
firebase_cli_token | Eklentinin oturum açma işlemini çalıştırdığınızda (yukarıdaki Bir Google hesabı kullanarak kimlik doğrulama konusuna bakın) veya CI ortamınızın kimliğini Firebase CLI ile doğruladığınızda (daha fazla bilgi için CI sistemleriyle CLI'yi kullanma konusunu okuyun) yazdırılan bir yenileme belirteci. |
service_credentials_file | Google hizmet hesabı json dosyanızın yolu. Hizmet hesabı kimlik bilgilerini kullanarak nasıl kimlik doğrulama yapacağınızı öğrenmek için yukarıya bakın. |
debug | Bir boole bayrağı. Ayrıntılı hata ayıklama çıktısını yazdırmak için bunu |
Sonraki adımlar
- Manuel veya programlı olarak daha fazla cihazı kaydetmek için bkz. Ek iOS cihazları kaydetme .