App Distribution ve fastlane ile yayın öncesi iOS derlemelerinizi daha hızlı dağıtın

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

1. Başlamadan önce

4cddd34bd261cea0.png

Bu kod laboratuvarında, bir iOS uygulamasını test kullanıcılarına dağıtmak, test cihazı UDID'lerini toplamak ve bunları uygulamanızın temel hazırlık profiline kaydetmek için Firebase App Distribution'ı ve onun fastlane eklentisini nasıl kullanacağınızı öğreneceksiniz. ' eller.

ne öğreneceksin

  • Firebase App Distribution ve fastlane kullanan bir yayın öncesi iOS uygulamasını (Ad Hoc) test kullanıcılarına yükleme ve dağıtma.
  • Bir test cihazı olarak kaydolma ve dağıtılan uygulamayı bir test cihazına indirme.
  • App Distribution'ın fastlane eklentisiyle test cihazı UDID'lerini dışa aktararak test cihazlarını hızlı bir şekilde kaydetme.
  • Uygulamanızın temel hazırlık profilini güncelleme ve dağıtım için yeniden yükleme.

Neye ihtiyacın olacak

  • Bir Google hesabı
  • XCode 11.7+ yüklü bir Apple makinesi
  • Xcode'da yerleşik bir Ad Hoc yayın öncesi iOS uygulaması
  • Ücretli bir Apple Developer hesabı
  • Test için fiziksel bir iOS cihazı.

iOS simülatör uygulaması kod laboratuvarının çoğu için çalışır, ancak simülatörler sürümleri indiremez.

App Distribution test cihazı web uygulamasında "İndir" düğmesinin göründüğünü doğrulayarak kurulumun çalıştığını yine de doğrulayabilirsiniz.

2. Başlayın

fastlane'i ayarla

Uygulama Dağıtımı, uygulamanızın yayın öncesi yapılarının dağıtımını otomatikleştirmenizi sağlamak için fastlane ile entegre olur. Uygulama Dağıtımı, fastlane yapılandırmanızla bütünleşir.

  1. Fastlane'i kurun ve kurun .
  2. Kurulum sırasında projenizin kök dizininde fastlane init çalıştırın ve "Manuel kurulum"u seçin. Fastlane'i yapılandırmak için kullanacağınız Fastfile , Appfile ve Pluginfile içeren fastlane adında bir alt dizin göreceksiniz.

3. Uygulamanızı fastlane ile oluşturun

Uygulamanızı oluşturun

  1. ./fastlane/Appfile dosyanızda fastlane için bazı genel değişkenler ayarlayın ./fastlane/Appfile. Uygulamanızın kimliğini ve Apple Kimliğinizi ekleyin:
app_identifier("<your app's bundle identifier>")
apple_id("<your Apple id>")
  1. İlk kulvarınızı oluşturun ve fastlane'in build_app eylemini ( gym olarak da bilinir) kullanarak uygulamanızı ./fastlane/Fastfile dosyanıza ekleyerek oluşturun:
default_platform(:ios)

lane :build do
    build_app(export_method: "ad-hoc")
end
  1. Dağıtım için uygulamanızı imzalayın.

Bu codelab için, yerel olarak imzalama sertifikaları oluşturan ve her şeyi macOS Anahtar Zincirinizde depolayan get_certificates ( cert olarak da bilinir) kullanarak kendi sertifikanızı ve profilinizi yöneteceksiniz. Ancak genellikle, ekibinizin kod imzalama sertifikalarını ve profillerini güvenli bir şekilde yönetmek için fastlane sync_code_signing action ( match olarak da bilinir) kullanmak isteyeceksiniz.

lane :build do
    get_certificates()
    build_app(export_method: "ad-hoc")
end
  1. get_provisioning_profile eylemini ( sigh olarak da bilinir) kullanarak uygulamanız için bir temel hazırlık profili oluşturun. Bu, uygulamanızı test kullanıcılarıyla paylaşmanıza olanak tanır.
lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end
  1. [İsteğe bağlı] Uygulamanızı daha önce hiç çalıştırmadıysanız, uygulamanızı Apple geliştirici konsolunda oluşturmak için aşağıdaki komutu çalıştırın:

$ fastlane produce --skip_itc

  1. Son olarak, şeridi çalıştırarak uygulamanızı oluşturun.

Sizden Apple Kimliğiniz, parolanız (Anahtar Zincirinizde saklanır) ve uygulamanızın paket kimliği istenecektir.

$ fastlane build

Herhangi bir sorunla karşılaşırsanız, lütfen fastlane sorun giderme kılavuzuna bakın.

4. Uygulamanızı Firebase'e yükleyin

Artık uygulamanızı oluşturduğunuza göre, onu App Distribution'a yüklemeye hazırsınız.

Bir Firebase projesi oluşturun ve kurun

  1. Firebase'de oturum açın.
  2. Firebase konsolunda yeni bir proje oluşturun veya ekleyin ve ardından projenizi "UDID Export Codelab" olarak adlandırın.

Bu proje için Google Analytics'i etkinleştirmeniz gerekmez.

  1. Proje oluştur'u tıklayın.

iOS uygulamanızı projeye ekleyin

  1. Yeni bir Firebase iOS uygulaması oluşturmak için iOS simgesini tıklayın ve uygulamanızın paket kimliğini girin.

9c26c130a6c42212.png

  1. Sonraki birkaç adımı atlayın, ardından Konsola Devam Et'i tıklayın. SDK'ları uygulamanıza daha sonra ekleyeceksiniz.

Projeniz ve uygulamanız artık Projeye Genel Bakış sayfasında mevcuttur.

66f79cc8a97fa8e9.png

Uygulama Dağıtımını Etkinleştir

  1. Yayınla ve İzle bölümünün altında, Uygulama Dağıtımı 'nı tıklayın.
  2. Şartları kabul ettikten sonra, uygulamanız için Uygulama Dağıtımını etkinleştirmek üzere "Başlayın"ı tıklayın.

460213326c2784ae.png

Fastlane'de bir dağıtım kurun

  1. Uygulama Dağıtımını fastlane yapılandırmanıza eklemek için iOS projenizin kökünden aşağıdaki komutu çalıştırın.

Komut size bir seçenek sorarsa Seçenek 3'ü seçin: RubyGems.org :

$ fastlane add_plugin firebase_app_distribution

  1. Eklentinin kurulu olduğunu onaylayın:

$ fastlane

Çıktı, kurulu eklentiler listesinde fastlane-plugin-firebase_app_distribution göstermelidir.

  1. Eklentinin kurulduğunu onayladıktan sonra, iptal etmek için 0 seçeneğini belirleyin.

Firebase projenizin kimliğini doğrulayın

Fastlane eklentisini kullanmak için önce Firebase projenizin kimliğini doğrulamanız gerekir.

  1. Aşağıdaki komutu çalıştırın:

$ fastlane run firebase_app_distribution_login

  1. Komut bir kimlik doğrulama bağlantısı yazdırdığında, bağlantıyı bir tarayıcıda açın.
  2. İstendiğinde, Google Hesabınızda oturum açın ve Firebase projenize erişim izni verin.

Ortaya çıkan kodu oturum açma tarayıcısından kopyalayın ve komut satırına yapıştırın.

  1. Ardından oturum açma eylemi, App Distribution eklentisinin Firebase ile kimlik doğrulaması yapmak için kullandığı bir yenileme belirteci yazdırır:

dbd61c40c4131158.png

  1. FIREBASE_TOKEN ortam değişkenini ayarlayarak belirteci iletin:

$ export FIREBASE_TOKEN= <token>

Uygulamanızı dağıtın

Artık uygulamanızı dağıtmaya hazırsınız.

  1. ./fastlane/Fastfile dosyanızın en üstünde, firebase_app_id adında bir değişken tanımlayın. <your_app_id> öğesini, oluşturduğunuz uygulama için Firebase Uygulama Kimliği ile değiştirin (bu, proje ayarları sayfasında bulunabilir).

Fastfile Ruby'de yazılmıştır, dolayısıyla değişkenleri tanımlamak için Ruby sözdizimini kullanın.

firebase_app_id = "<your_app_id>"
  1. Derleme şeridini çağıran ve ardından firebase_app_distribution eylemini kullanarak uygulamanızı dağıtan, distribute adlı yeni bir şerit ekleyin.
lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
    )
end
  1. Uygulamanızı oluşturmak ve bir dağıtım oluşturmak için yeni şeridi çalıştırın.

$ fastlane distribute

Bu noktada, Fastfile'niz aşağıdaki gibi görünmelidir:

firebase_app_id = "<your Firebase app ID>"

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
    )
end

Firebase konsolunu yeniledikten sonra, uygulamanızın yeni sürümünü göreceksiniz.

c59dc1a94de3bf3c.png

5. Test kullanıcılarını uygulamanızı indirmeye davet edin

Bir test kullanıcısı, bir Ad Hoc yapıyı test etme davetini kabul ettiğinde, kendilerinden UDID'lerini paylaşma izni istenir. Kabul ederlerse, App Distribution onların cihaz bilgilerini toplar ve size e-posta yoluyla bildirir. Bu bölümde, dağıtımını yaptığınız uygulamayı indirmek ve test etmek için kendinizi test kullanıcısı olarak ekleyeceksiniz.

Sürüme test kullanıcısı olarak kendinizi ekleyin

  1. Fastfile dosyanızın üst kısmındaki firebase_app_id altında, test kullanıcılarını tutmak için bir değişken oluşturun ve kendi e-posta adresinizin yanı sıra denemek istediğiniz diğer isteğe bağlı e-posta adreslerini ekleyin.
firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]
  1. app_testers dizisini, testers parametresinin beklediği virgülle ayrılmış bir dizeye dönüştürmek için Ruby'nin Array#join yöntemini uygulayın. Ardından, sonucu firebase_app_distribution'ın testers parametresine iletin firebase_app_distribution.
lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!"
        testers: app_testers.join(","),
    )
end

Bu noktada, Fastfile'niz şöyle görünmelidir:

firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
        testers: app_testers.join(","),
    )
end
  1. Şeridi tekrar çalıştırın.

$ fastlane distribute

Kulvarı çalıştırdığınızda, eklediğiniz test kullanıcıları, App Distribution'dan kendilerine yeni çıkan sürümü bildiren bir davet e-postası alacak. Firebase konsolunda, uygulamanızın sürümü kapsamında eklediğiniz test kullanıcılarını artık görebilirsiniz.

2e0fc9603b868af8.png

E-posta adresinizi eklediğiniz için, Firebase App Distribution'dan sizi uygulamayı test etmeye davet eden bir e-posta alacaksınız. Artık ilk testçi sizsiniz! Test cihazınızda test cihazı olarak kurulum yapmak için aşağıdaki bölüme devam edin.

Test cihazınızı kaydedin

Bir test kullanıcısı olarak, test etmeye davet edildiğiniz uygulama sürümlerine erişmek için test cihazınızda Google'da oturum açmanız gerekir. Test derlemeniz Ad Hoc sürüm olduğundan, Firebase profilini yükleyerek test cihazınızı da kaydetmeniz gerekir. Ardından, kullanımınıza sunulan sürümlere, cihazınızın ana ekranına eklenen web klibini kullanarak App Distribution test cihazı web uygulamasından erişebilirsiniz.

  1. iOS test cihazınızda, Firebase App Distribution'dan gönderilen e-postayı açın ve Başlayın bağlantısına dokunun. Bağlantıyı Safari'de açtığınızdan emin olun.
  2. Artık App Distribution tester web uygulamasındasınız. Görünen sayfada, Google hesabınızla oturum açın ve Davetiyeyi kabul et'e dokunun.

d833407de251b89f.png

  1. Artık davet edildiğiniz yayınları görebilirsiniz. Sürümlerden birinin altındaki Cihazı kaydet'e dokunun.

fd141215e54a938d.png

  1. İstendiğinde Firebase profilini indirin, ardından profili Ayarlar uygulamasında yükleyin.

Profili yüklemek, Firebase'e şu izinleri verir:

  • Cihazın benzersiz cihaz kimliğini (UDID) toplayarak test cihazını kaydedin.

Firebase, Firebase projesinin tüm Sahiplerine ve Düzenleyicilerine test cihazının UDID'sini içeren bir e-posta gönderir.

  • Test cihazının ana ekranına bir web klibi yükleyin. Web klibi, tüm test uygulamalarınızı yüklemenize ve bunlara erişmenize olanak tanıyan Uygulama Dağıtımı test cihazı web uygulamasını açar.

Uygulama Dağıtımı test cihazı web uygulamasında, test cihazınız artık uygulamanızın yayınlanması için kaydedilmiştir.

fe93d649dfa25877.png

Test cihazınızın UDID'sini Firebase ile paylaştığınıza göre artık geliştirici olarak devam edebilirsiniz. Uygulama Dağıtımı kontrol panelinin Test Kullanıcıları sekmesinde, test kullanıcısı bilgileriniz artık uygulamanızın sürümünün altında "Kabul Edildi" durumunda görünür:

7b9f665a63a384cf.png

Bir sonraki bölümde, cihaz UDID'sini uygulamanızın temel hazırlık profiline ekleyecek ve ardından uygulamanızın test cihazınızla çalışan bir sürümünü oluşturacaksınız.

Test cihazı cihazınızın UDID'lerini dışa aktarın

Geliştirici olarak, Firebase'den test cihazının UDID'sini içeren bir e-posta alacaksınız. Bir seçenek olarak Uygulama Dağıtımı, birden fazla yeni cihaz UDID'sini doğrudan Firebase konsolundan bir ham metin dosyası olarak dışa aktarmanıza izin vererek aynı anda toplamayı kolaylaştırır.

  1. Tüm UDID'leri dışa aktarmak için Test Cihazları ve Gruplar sekmesini açın.

241a9936898a2fc0.png

  1. Apple UDID'lerini Dışa Aktar'ı tıklayın.

bcf0c26c522d9b4e.png

Dosya, test cihazınızın UDID'sini içermelidir.

Device ID            Device Name                            Device Platform
1234567890     udid.codelab.tester@gmail.com - iPhone SE 2nd Gen        ios

UDID'ler, bir sonraki bölümde yapacağınız fastlane kullanılarak komut satırından da dışa aktarılabilir.

6. Uygulamanızın temel hazırlık profilini güncelleyin ve yeniden oluşturun

Şimdi, test cihazınızın UDID'sini uygulamanızın temel hazırlık profiline ekleyecek, uygulamanızın cihazınız için çalışan bir sürümünü yeniden oluşturacak ve yeni sürümü dağıtacaksınız.

UDID dışa aktarma şeridi ekle

  1. Fastfile dosyanızın üstüne başka bir değişken ekleyin ve onu, test kullanıcılarınızın cihaz UDID'lerinin indirileceği bir dosya yoluna ayarlayın.
firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]
tester_udids_file = "tester_udids.txt"
  1. Tıpkı konsoldan yaptığınız gibi, test cihazı UDID'lerini indirmek için App Distribution eklentisinin UDID dışa aktarma eylemini kullanan yeni bir şerit oluşturun.
lane :download_udids do
    firebase_app_distribution_get_udids(
        app: firebase_app_id,
        output_file: tester_udids_file,
    )
end
  1. UDID'leri indirmek için aşağıdaki şeridi çalıştırın.

$ fastlane download_udids

  1. Test cihazı UDID'lerini içermesi gereken indirilen dosyayı yazdırın.

$ cat tester_udids.txt

Apple geliştirici konsoluna aygıt ekleme

  1. UDID'leri Apple geliştirici konsolundaki cihazlar listenize eklemek için aşağıdaki şeridi oluşturun, böylece bunları fastlane'in register_devices eylemini kullanarak temel hazırlık profilinize ekleyebilirsiniz:
lane :add_new_devices do
    register_devices(devices_file: tester_udids_file)
end
  1. Ardından şeridi çalıştırın:

$ fastlane add_new_devices

Ardından, geliştirici konsolunuzun cihazlar listesinde yeni cihazları görmelisiniz.

Temel hazırlık profilinize aygıt ekleyin

  1. Her derleme yaptığınızda yeni aygıtları almaya zorlamak için, build şeridinizdeki temel hazırlık profili adımına force bağımsız değişkenini ekleyin.
lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true, force: true)
    build_app(export_method: "ad-hoc")
end

İnşa etmek ve yüklemek için şeridi yeniden çalıştırın

Şimdi, cihazları sağlama profiline eklemek, uygulamayı yeniden oluşturmak ve ardından dağıtmak için distribute şeridinizi yeni şeritlerle güncelleyeceksiniz.

  1. distribute öğesinden yeni şeritleri arayın:
lane :distribute do
    download_udids
    add_new_devices
    build
    firebase_app_distribution(
        app: "1:123456789:ios:abcd1234",
        release_notes: "Try out this app!"
        testers: app_testers.join(","),
    )
end
  1. distribute şeridini çalıştırın:

$ fastlane distribute

Bu noktada, Fastfile'niz şöyle görünmelidir:

firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]
tester_udids_file = "tester_udids.txt"

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true, force: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    download_udids
    add_new_devices
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
        testers: app_testers.join(","),
    )
end

lane :download_udids do
    firebase_app_distribution_get_udids(
        app: firebase_app_id,
        output_file: tester_udids_file,
    )
end

lane :add_new_devices do
    register_devices(devices_file: tester_udids_file)
end

Sürümü test cihazından indirin

Artık uygulamanız test cihazı UDID'lerini içerdiğine göre, bunlar test cihazlarına yüklenebilir.

e275f73d57cc8fb1.png

  1. Test cihazınızda, e-postadaki bağlantıyı veya cihazın ana ekranındaki simgeyi kullanarak App Distribution test cihazı web uygulamasına dönün.

UDID codelab uygulamasına gittiğinizde, sürümün indirilmeye hazır olduğunu görebilirsiniz.

baba6d03b6ad78746.png

  1. Fiziksel bir cihaz kullanıyorsanız, indir'e basın, ardından uygulamayı kurun ve çalıştırın!

7. Tebrikler

Artık, yayın öncesi test sürecinizi otomatikleştirmek için App Distribution ve fastlane'i yapılandırdınız. Artık, ek test kullanıcılarını davet etmek veya UDID'lerini uygulamanıza eklemek istediğinizde, tek bir komut çalıştırmanız gerekecek: fastlane distribute .

Bu nedenle, artık test edicilerden UDID'leri tek tek toplamanıza veya cihaz listelerini güncellemek veya profilleri hazırlamak için Apple geliştirici konsoluna gitmenize gerek yok. XCode'u açmanıza bile gerek yok!

Bu iş akışının, sürekli entegrasyon ortamınızda saatlik veya günlük olarak çalıştırılması kolaydır.

daha fazla okuma