Firebase App Distribution iOS SDK ile yeni uygulama sürümleriniz hakkında test kullanıcılarını uyarın - Codelab

1. Genel Bakış

iOS uygulama kod laboratuvarınızda Firebase Uygulama Dağıtım SDK'sını Entegre Etme'ye hoş geldiniz. Bu kod laboratuvarında, yeni derlemeler indirilebilir olduğunda testçilerinize uygulama içi uyarıları görüntülemek için Uygulama Dağıtım SDK'sını uygulamanıza ekleyeceksiniz. Test kullanıcılarınızın güncellemeleri almak üzere oturum açmasını sağlamak için hem temel yapılandırmayı hem de özel yapılandırmayı nasıl kullanacağınızı öğreneceksiniz. Ardından, App Distribution'a yeni bir sürüm gönderecek ve doğrudan uygulamada yeni bir derleme uyarısı tetikleyeceksiniz.

ne öğreneceksin

• Yayın öncesi bir uygulamayı canlı test kullanıcılarına dağıtmak için Uygulama Dağıtımı nasıl kullanılır?
• Uygulama Dağıtımı iOS SDK'sını uygulamanıza nasıl entegre edebilirsiniz?
• Yüklemeye hazır yeni bir yayın öncesi yapı olduğunda test kullanıcısına nasıl uyarı verilir?
• SDK'yı benzersiz test gereksinimlerinize uyacak şekilde nasıl özelleştirebilirsiniz?

Neye ihtiyacın olacak

• Xcode 12 (veya üstü)
• CocoaPods 1.9.1 (veya üstü)
• Ad Hoc dağıtım için bir Apple Developer hesabı
• Test için fiziksel bir iOS cihazı. ( iOS simülatör uygulaması , codelab'in çoğu için çalışır, ancak simülatörler sürümleri indiremez.)

2. Firebase konsol projesi oluşturun

Yeni Firebase projesi ekle

1. Firebase'de oturum açın.
2. Firebase konsolunda, Proje Ekle'ye tıklayın ve ardından projenize "Firebase Codelab" adını verin.

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

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

Firebase'e Uygulama Ekle

Uygulamanızı Firebase'e kaydettirmek için belgeleri izleyin. iOS Paket Kimliği olarak "com.google.firebase.codelab.AppDistribution.<adınız>" öğesini kullanın.

İstendiğinde projenizin GoogleService-Info.plist dosyasını indirin. Buna daha sonra ihtiyacınız olacak.

3. Örnek Projeyi Alın

Kodu İndir

Örnek projeyi klonlayarak başlayın.

git clone git@github.com:googlecodelabs/firebase-appdistribution-ios.git

Git kurulu değilse, örnek projeyi GitHub sayfasından veya bu bağlantıya tıklayarak da indirebilirsiniz.

Bağımlılıkları indirin ve projeyi Xcode'da açın

1. Podfile'ı aynı dizinde açın

cd firebase-appdistribution-ios/start
Open Podfile

2. Podfile dosyanıza aşağıdaki satırı ekleyin:

pod dosyası

pod 'Firebase/AppDistribution'

Proje dizininde pod update çalıştırın ve projeyi Xcode'da açın.

pod install --repo-update
xed .

Paket Tanımlayıcıyı Firebase uygulamanızla eşleşecek şekilde güncelleyin

Soldaki menüde AppDistributionExample'a çift tıklayın. Ardından, Genel sekmesini bulun ve paket tanımlayıcısını, proje ayarlarında bulunabilen Firebase uygulamanızın paket tanımlayıcısıyla eşleşecek şekilde değiştirin. Bu, "com.google.firebase.codelab.AppDistribution.<adınız>" olmalıdır.

Uygulamanıza Firebase ekleyin

Dosya sisteminizde daha önce indirdiğiniz GoogleService-Info.plist dosyasını bulun ve Xcode projesinin kök dizinine sürükleyin. Bu dosyayı ayrıca projenizin ayarlar sayfasından istediğiniz zaman indirebilirsiniz.

AppDistributionExample/AppDelegate.swift dosyanızda, dosyanın en üstünde Firebase'i içe aktarın

AppDistributionÖrnek/AppDelegate.swift

import Firebase

Ve didFinishLaunchingWithOptions yönteminde Firebase'i yapılandırmak için bir çağrı ekleyin.

AppDistributionÖrnek/AppDelegate.swift

FirebaseApp.configure()

4. App Distribution SDK ile uygulama içi yeni derleme uyarıları ayarlayın

Bu adımda, uygulamanıza Firebase App Distribution SDK'sını ekleyecek ve uygulamanızın yeni sürümleri yüklenebildiğinde testçilerinize uygulama içi uyarılar göstereceksiniz. Bunu yapmak için "Firebase Codelab" projeniz için (Google Cloud Console'da) Firebase App Testers API'yi etkinleştirdiğinizden emin olun. Aynı hesapla giriş yapmanız ve üst kısımdaki açılır menüden doğru projeyi seçmeniz gerekecektir.

Uygulama içi uyarıları yapılandırın

App Distribution SDK, test kullanıcıları için uygulama içi derleme uyarıları ayarlamanın iki yolunu sunar: test kullanıcılarına görüntülenmesi için önceden oluşturulmuş bir oturum açma iletişim kutusuyla birlikte gelen temel bir uyarı yapılandırması ve size izin veren gelişmiş bir uyarı yapılandırması. kendi kullanıcı arayüzünüzü (UI) özelleştirin.

Temel uyarı yapılandırmasıyla başlayacağız. Henüz uyarıları etkinleştirmemiş test kullanıcılarına önceden oluşturulmuş bir etkinleştirme uyarıları diyaloğunu görüntülemek için checkForUpdate kullanabilir ve ardından yeni bir yapı olup olmadığını kontrol edebilirsiniz. Test kullanıcıları, App Distribution'da uygulamaya erişimi olan bir hesapta oturum açarak uyarıları etkinleştirir. Çağrıldığında, yöntem aşağıdaki sırayı uygular:

1. Bir test cihazının uyarıları etkinleştirip etkinleştirmediğini kontrol eder. Değilse, Google hesaplarıyla App Distribution'da oturum açmalarını isteyen önceden oluşturulmuş bir iletişim kutusu görüntüler.

Uyarıları etkinleştirmek, test cihazında tek seferlik bir işlemdir ve uygulamanızın güncellemeleri boyunca devam eder. Uyarılar, uygulama kaldırılana veya signOutTester yöntemi çağrılana kadar test cihazında etkin kalır. Daha fazla bilgi için yöntemin başvuru belgelerine ( Swift veya Objective-C ) bakın.

2. Test cihazının yüklemesi için yeni kullanılabilir yapıları kontrol eder. Bir yayın nesnesi veya bir hata döndürür .

checkForUpdate uygulamanızın herhangi bir noktasına dahil edebilirsiniz. Örneğin, UIViewController'ın viewDidAppear'ına checkForUpdate ekleyerek test kullanıcılarınızdan başlangıçta yeni kullanılabilir yapıları yüklemelerini isteyebilirsiniz.

AppDistributionViewController.swift dosyanızda, dosyanın üst kısmındaki Firebase'i içe aktarın

AppDistributionViewController.Swift

import Firebase

AppDistributionExample/AppDistributionViewController.Swift dosyasını açın ve satırları aşağıdaki gibi viewDidAppear yöntemine kopyalayın:

AppDistributionViewController.Swift

 override func viewDidAppear(_ animated: Bool) {
    checkForUpdate()
 }

Şimdi checkForUpdate() yöntemini uygulayalım.

AppDistributionViewController.Swift

  private func checkForUpdate() {
    AppDistribution.appDistribution().checkForUpdate(completion: { [self] release, error in
      var uiAlert: UIAlertController

      if error != nil {
        uiAlert = UIAlertController(title: "Error", message: "Error Checking for update! \(error?.localizedDescription ?? "")", preferredStyle: .alert)
      } else if release == nil {
        uiAlert = UIAlertController(title: "Check for Update", message: "No releases found!!", preferredStyle: .alert)
        uiAlert.addAction(UIAlertAction(title: "Ok", style: UIAlertAction.Style.default))
      } else {
        guard let release = release else { return }

        let title = "New Version Available"
        let message = "Version \(release.displayVersion)(\(release.buildVersion)) is available."
        uiAlert = UIAlertController(title: title, message: message, preferredStyle: .alert)

        uiAlert.addAction(UIAlertAction(title: "Update", style: UIAlertAction.Style.default) {
          _ in
          UIApplication.shared.open(release.downloadURL)
        })
        uiAlert.addAction(UIAlertAction(title: "Cancel", style: UIAlertAction.Style.cancel) {
          _ in
        })
      }
      self.present(uiAlert, animated: true, completion: nil)
    })
  }

5. Test kullanıcıları oluşturun ve uygulamanızı indirmeye davet edin

Bu adımda, uygulamanızı derleyecek ve yapıyı Firebase konsolunu kullanarak test kullanıcılarına dağıtarak uygulamanızı test edeceksiniz.

Uygulamanızı oluşturun

Uygulamanızın yayın öncesi sürümünü test kullanıcılarına dağıtmaya hazır olduğunuzda, derleme hedefi olarak "Herhangi bir iOS Aygıtı (arm64)" öğesini ve Ürün->Arşiv'i seçin. Arşiv oluşturulduktan sonra, Geliştirme dağıtım profiliyle imzalı bir dağıtım oluşturun.

Derleme tamamlandığında, bir IPA dosyasını ve bazı günlük dosyalarını belirttiğiniz klasöre kaydeder. IPA dosyasını aşağıdaki adımlarda testçilerinize dağıtırsınız.

Uygulamanızı oluştururken sorun yaşarsanız sorun giderme adımları için Apple'ın ortak tasarım belgelerine bakın.

Uygulamanızı test kullanıcılarına dağıtın

Uygulamanızı test kullanıcılarına dağıtmak için Firebase konsolunu kullanarak IPA dosyasını yükleyin:

1. Firebase konsolunun Uygulama Dağıtımı sayfasını açın. İstendiğinde Firebase projenizi seçin.
2. Başlayın'a basın

3. Sürümler sayfasında, açılır menüden dağıtmak istediğiniz uygulamayı seçin.

4. Uygulamanızın IPA dosyasını yüklemek için konsola sürükleyin.
5. Yükleme tamamlandığında, derlemeyi almak istediğiniz test kullanıcı gruplarını ve bireysel test kullanıcılarını belirtin. (Daveti almak için e-postanızı ekleyin.) Ardından, yapı için sürüm notları ekleyin. Test kullanıcıları grupları oluşturma hakkında daha fazla bilgi için Test kullanıcılarını yönetme konusuna bakın.

6. Derlemeyi test kullanıcılarının kullanımına sunmak için Dağıt'a tıklayın.

Kendinizi sürüme test kullanıcısı olarak ekleyin

Firebase konsolunda, uygulamanızın sürümüne eklediğiniz test kullanıcılarını artık görebilirsiniz.

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 kullanıcısısınız! Test cihazınızda test cihazı olarak kurulum yapmak için aşağıdaki bölüme devam edin.

Test cihazınızı kaydedin

Ad Hoc sürümünü indirmek ve test etmek için önce test cihazınızı kaydetmeniz gerekir.

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. Görüntülenen Firebase App Distribution test cihazı web uygulamasında Google hesabınızla oturum açın ve Daveti kabul et'e dokunun.

Şimdi, davet edildiğiniz sürümü göreceksiniz.

3. Uygulamanızın temel hazırlık profilini daha sonra güncelleyebilmek için UDID'nizi Firebase ile paylaşmak için Cihazı kaydet'e dokunun.

4. Talimatları izleyin ve profili indirmek ve UDID'nizi paylaşmak için ayarlara gidin.

Şimdi, Uygulama Dağıtımına geri döndüğünüzde, sürüm artık "Cihaz kayıtlı" olarak işaretleniyor:

Test kullanıcısının UDID'si artık geliştiriciyle paylaşıldı. Test cihazını uygulamanın yeni bir sürümünü oluşturmak artık geliştiriciye kalmıştır.

Konsolda test cihazı bilgilerini görüntüleyin

Geliştiricinin Firebase konsolundaki görünümüne geri dönersek, test cihazı sürüm altında "Kabul Edildi" olarak görünecektir:

Ardından, kullandıkları cihaz ön hazırlık profiline zaten dahil değilse, geliştirici olarak bir e-posta da alırsınız. Bu, eklemeniz gereken yeni UDID'yi size bildirecektir. Ayrıca tüm UDID'leri bir metin dosyası olarak dışa aktarma seçeneğiniz de vardır.

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

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

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

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

Bu e-postalardan birini aldığınızda, ön hazırlık profilinizi UDID ile güncelleyin ve aşağıdaki adımları izleyerek yeni bir yapıyı testçilerinize dağıtın:

1. Aygıtları Apple geliştirici portalınıza ekleyin.

• Seçenek 1: Cihaz UDID'lerini CSV dosyası olarak içe aktarın. App Distribution panosunun Test Ediciler ve Gruplar sekmesinde, Tüm test kullanıcıları'nı seçin, ardından bir CSV dosyası indirmek için Apple UDID'lerini Dışa Aktar'ı tıklayın. Ardından, Birden Fazla Cihaz Kaydet seçeneğini kullanarak dosyayı Apple geliştirici hesabınıza aktarın. Daha fazla bilgi için Apple'ın belgelerine bakın. Apple geliştirici hesabınızın yılda yalnızca sınırlı sayıda cihazı içe aktarmanıza izin verebileceğini unutmayın.
• Seçenek 2: UDID'leri e-posta ile toplayın ve girin. Apple geliştirici portalının Cihaz Ekle sayfasında, aldığınız e-postada belirtilen yeni UDID'yi kaydedin.

2. Kayıtlı cihazları ön hazırlık profilinize ekleyin.
3. Temel hazırlık profilini indirin ve uygulamanızı yeniden oluşturmak için kullanın. Yalnızca kayıtlı cihazları güncellemek için yeniden oluşturuyorsanız, yapı numarasını veya sürümünü güncellemeyin.
4. Uygulamanızı Firebase konsolundan veya CLI'den yeniden dağıtın . Aynı yapı numarasına ve sürümüne sahip bir yapıyı zaten dağıttıysanız, yalnızca yeni kayıtlı cihazların kullanıcıları bildirim e-postaları alır.

Sürümü test cihazından indirin

Artık sürümde test cihazının UDID'si var, böylece test cihazı uygulamayı indirip yükleyebilir. App Distribution, UDID'leri yeni bir sürüme eklendiğinde test kullanıcılarına bir e-posta gönderir.

1. Test cihazında, 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.

2. Fiziksel bir cihaz kullanıyorsanız, indir'e basın, ardından uygulamayı kurun ve çalıştırın!
3. Uygulama başladığında sizden yeni derleme uyarılarını etkinleştirmenizi isteyecektir. "Aç" ı seçin

4. Ardından sizden oturum açmanızı isteyecektir. "Devam Et"i tıklayın.

5. Test kullanıcısı hesabınızla oturum açın.

6. Uygulamaya geri götürüleceksiniz. Uygulamayı bir sonraki çalıştırışınızda oturum açmanız veya uyarıları kabul etmeniz gerekmeyecek.

Test kullanıcılarınıza bir güncelleme dağıtın

1. Yapı numaranızı "2" olarak güncelleyin.

2. Derleme hedefi olarak "Herhangi bir iOS Aygıtı (arm64)" öğesini ve Ürün->Arşiv'i seçin. Arşiv oluşturulduktan sonra, Geliştirme dağıtım profili ile imzalı bir dağıtım oluşturun.
3. Derleme tamamlandığında, bir IPA dosyasını ve bazı günlük dosyalarını belirttiğiniz klasöre kaydeder. Bu yeni IPA'yı Firebase konsolunuza yükleyin, e-postanızı tekrar test kullanıcısı olarak ekleyin ve Dağıtın.

Test oluşturma uyarıları

1. Açıksa, uygulamayı kapattığınızdan emin olun. Uygulamayı yeniden başlatın.
2. Uygulama yeniden başlatıldığında, "Yeni Sürüm Kullanılabilir" uyarısı almanız gerekir.

3. En son sürümü almak için "Güncelle"ye tıklayın.
4. Bir sonraki ekranda "Yükle" ye tıklayın.

5. Tebrikler! Uygulamanızı yerleşik uyarılarla güncelleyebildiniz.

6. Test kullanıcısının oturum açmasını özelleştirin

SignInTester/signOutTester ve isTesterSignedIn yöntemleri, test cihazınızın oturum açma deneyimini özelleştirerek size daha fazla esneklik sağlar, böylece uygulamanızın görünümüne ve hissine daha iyi uyum sağlayabilir.

Aşağıdaki örnek, test kullanıcısının Firebase App Distribution test kullanıcısı hesabında zaten oturum açıp açmadığını kontrol eder, böylece oturum açma kullanıcı arayüzünüzü yalnızca henüz oturum açmamış test kullanıcıları için görüntülemeyi seçebilirsiniz. Test kullanıcısı oturum açtıktan sonra, test cihazının yeni bir yapıya erişimi olup olmadığını kontrol etmek için checkForUpdate'i arayın.

CheckForUpdate () çağrısını yorumlayarak viewDidAppea r'de güncellemeleri otomatik olarak kontrol etmeyi devre dışı bırakalım.

AppDistributionViewController.Swift

 override func viewDidAppear(_ animated: Bool) {
    // checkForUpdate()
 }

Bunun yerine, checkForUpdateButtonClicked() içinde checkForUpdate( ) öğesini çağıralım.

 @objc func checkForUpdateButtonClicked() {
    checkForUpdate()
 }

Şimdi, kullanıcı oturumu kapalıysa oturum açacak veya oturum açmışsa kullanıcı oturumunu kapatacak olan signInOutButtonClicked() yöntemimizi uygulayalım.

AppDistributionViewController.Swift

 @objc func signInOutButtonClicked() {
    if isTesterSignedIn() {
      AppDistribution.appDistribution().signOutTester()

      self.configureCheckForUpdateButton()
      self.configureSignInSignOutButton()
      self.configureSignInStatus()

    } else {
      AppDistribution.appDistribution().signInTester(completion: { error in
        if error == nil {
          self.configureCheckForUpdateButton()
          self.configureSignInSignOutButton()
          self.configureSignInStatus()
        } else {
          let uiAlert = UIAlertController(title: "Custom:Error", message: "Error during tester sign in! \(error?.localizedDescription ?? "")", preferredStyle: .alert)
          uiAlert.addAction(UIAlertAction(title: "Ok", style: UIAlertAction.Style.default) {
            _ in
          })

          self.present(uiAlert, animated: true, completion: nil)
        }
      })
    }
  }

Son olarak isTesterSignedI n yöntemini uygulayalım.

AppDistributionViewController.Swift

 private func isTesterSignedIn() -> Bool {
    return AppDistribution.appDistribution().isTesterSignedIn
 }

Uygulamanızı oluşturun ve test edin

7. Tebrikler!

Firebase App Distribution iOS SDK'yı kullanarak bir uygulamaya "uygulama içi uyarı görüntüleme" özelliğini yerleştirdiniz.

Neyi kapsadık

• Firebase Uygulama Dağıtımı
• Firebase Uygulama Dağıtımı Yeni Uyarılar iOS SDK

Sonraki adımlar

• Fastlane eklentisini kullanma
• CLI araçlarını kullanma

Daha fazla bilgi edin

• Firebase.google.com
• Twitter yeni iOS SDK'sını nasıl kullanıyor?

Sorunuz mu var?

• Stackoverflow 'firebase-app-dağıtım '
• Firebase topluluğu gevşek kanalı #app-dağıtım

Sorunları Bildir

• Github Sorunları