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.)
Bu öğreticiyi nasıl kullanacaksınız?
iOS uygulamaları oluşturma deneyiminizi nasıl değerlendirirsiniz?
2. Firebase konsol projesi oluşturun
Yeni Firebase projesi ekle
- Firebase'de oturum açın.
- 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.
- 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
- Podfile'ı aynı dizinde açın
cd firebase-appdistribution-ios/start Open Podfile
- Pod 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.<your_name>" 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 üstteki 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 aşağıdakileri yapmanızı sağlayan 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:
- 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.
- 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 en üstünde 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 bir 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 profili ile 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:
- Firebase konsolunun Uygulama Dağıtımı sayfasını açın. İstendiğinde Firebase projenizi seçin.
- Başlayın'a basın
- Sürümler sayfasında, açılır menüden dağıtmak istediğiniz uygulamayı seçin.
- Uygulamanızın IPA dosyasını yüklemek için konsola sürükleyin.
- 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.
- 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.
- 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.
- 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.
- Uygulamanızın temel hazırlık profilini daha sonra güncelleyebilmeniz için UDID'nizi Firebase ile paylaşmak için Cihazı kaydet'e dokunun.
- Talimatları izleyin ve profili indirmek ve UDID'nizi paylaşmak için ayarlara gidin.
Şimdi, App Distribution'a 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 kullanıcısı 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:
Daha sonra, kullandıkları cihaz ön hazırlık profiline henüz dahil edilmemişse, 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.
- Tüm UDID'leri dışa aktarmak için Test Ediciler ve Gruplar sekmesini açın.
- "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:
- 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.
- Kayıtlı cihazları ön hazırlık profilinize ekleyin.
- 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.
- Uygulamanızı Firebase konsolundan veya CLI'den yeniden dağıtın . Aynı yapı numarasına ve sürümüne sahip bir yapı 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üm, test cihazının UDID'sine sahiptir, böylece test cihazı uygulamayı indirebilir ve yükleyebilir. App Distribution, UDID'leri yeni bir sürüme eklendiğinde test kullanıcılarına bir e-posta gönderir.
- 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.
- Fiziksel bir cihazdaysanız, indir'e basın, ardından uygulamayı kurun ve çalıştırın!
- Uygulama başladığında sizden yeni derleme uyarılarını etkinleştirmenizi isteyecektir. "Aç" ı seçin
- Ardından sizden oturum açmanızı isteyecektir. "Devam Et"i tıklayın.
- Test kullanıcısı hesabınızla oturum açın.
- 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
- Yapı numaranızı "2" olarak güncelleyin.
- 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.
- 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ı
- Açıksa uygulamayı kapattığınızdan emin olun. Uygulamayı yeniden başlatın.
- Uygulama yeniden başladığında, "Yeni Sürüm Kullanılabilir" uyarısı almanız gerekir.
- En son sürümü almak için "Güncelle"ye tıklayın.
- Bir sonraki ekranda "Yükle" ye tıklayın.
- 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ü ve hissi ile daha iyi eşleşebilir.
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
Daha fazla bilgi edin
Sorunuz mu var?
Sorunları Bildir