İsteğe bağlı Firebase App Distribution iOS ve Android SDK'ları, uygulamanızın yeni derlemeleri yüklenmeye hazır olduğunda test kullanıcılarınıza uygulama içi uyarılar göstermenize olanak tanır. Bu kılavuzda, test kullanıcılarınız için yeni derleme uyarıları oluşturmak ve bunları özelleştirmek üzere App Distribution iOS ve Android SDK'larını nasıl kullanacağınız açıklanmaktadır.
Başlamadan önce
Henüz yapmadıysanız Firebase'i iOS projenize ekleyin.
1. Adım: App Distribution Tester API'yi etkinleştirin
Google Cloud Console'da projenizi seçin.
Firebase App Testers API'nin altında Etkinleştir'i tıklayın.
2. Adım: Uygulamanıza App Distribution'ı ekleyin
Proje için oluşturduğunuz Podfile'ı açın (veya oluşturmak için
pod init
komutunu çalıştırın), ardından aşağıdaki satırı hedef bölüme ekleyin:pod 'FirebaseAppDistribution'
Podfile dosyanızın dizininde
pod install
komutunu çalıştırın ve oluşturulan.xcworkspace
dosyasını açın.Firebase modülünü
App
yapınıza veyaUIApplicationDelegate
dosyanıza aktarın:Swift
import FirebaseCore import FirebaseAppDistribution
Objective-C
@import FirebaseCore; @import FirebaseAppDistribution;
Uygulama yetkilinizin
application(_:didFinishLaunchingWithOptions:)
yöntemindeFirebaseApp
paylaşılan örneği yapılandırın:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
Kaydırma devre dışıysa
application(_:open:options:)
uygulamanızda açık URL'leri App Distribution SDK'sına iletin:Swift
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool { if AppDistribution.appDistribution().application(application, open: url, options: options) { return true } // Handle other non-Firebase URLs here. return false }
Objective-C
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options { if ([[FIRAppDistribution appDistribution] application:app openURL:url options:options]) { return YES; } // Handle other non-Firebase URLs here. return NO; }
Son olarak, uygulamanızı yeniden derleyin.
3. Adım: Uygulama içi uyarıları yapılandırın
App Distribution SDK'sı, test kullanıcılarınız için uygulama içi derleme uyarılarını ayarlamak üzere iki yol sunar: Test kullanıcılarına gösterilecek önceden oluşturulmuş uygulama güncelleme ve oturum açma iletişim kutularını içeren temel bir uyarı yapılandırması ve kendi kullanıcı arayüzünüzü özelleştirmenizi sağlayan gelişmiş bir uyarı yapılandırması. App Distribution SDK'sını kullanmaya yeni başladıysanız önce temel uyarı yapılandırmasını kullanmanızı öneririz.
Temel yapılandırma
Henüz uyarıları etkinleştirmemiş test kullanıcılarına önceden oluşturulmuş uyarıları etkinleştirme iletişim kutusunu görüntülemek için checkForUpdate
öğesini kullanın ve ardından yeni bir derlemenin kullanılabilir olup olmadığını kontrol edin. Bu yöntem çağrıldığında aşağıdaki sırayı uygular:
Bir test kullanıcısının, Google Hesabı ile App Distribution'da oturum açmasını isteyerek uyarıları etkinleştirip etkinleştirmediğini kontrol eder.
Test kullanıcısı henüz uyarıları etkinleştirmediyse önceden oluşturulmuş bir iletişim kutusu görüntüler.
Uyarıları etkinleştirme, test cihazında tek seferlik bir işlemdir ve uygulama güncellemeleriniz 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 referans belgelerini (Swift veya Objective-C) inceleyin.Test kullanıcısının yüklemesi için yeni kullanıma sunulan derlemeleri kontrol eder.
checkForUpdate()
öğesini istediğiniz zaman uygulamanızda çağırabilirsiniz. Örneğin, uygulamanızın kök görünümünün onAppear(perform:)
bölümüne checkForUpdate()
öğesini ekleyerek test kullanıcılarınızdan başlangıçta yeni kullanıma sunulan derlemeleri yüklemelerini isteyebilirsiniz.
Aşağıdaki örnek, test kullanıcısının uyarıları etkinleştirip etkinleştirmediğini ve yeni bir derlemeye erişimi olup olmadığını kontrol eder. Böyle bir durumda, derleme yüklenmeye hazır olduğunda bir iletişim kutusu görüntülenir:
Swift
AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
if error != nil {
// Handle error
return
}
guard let release = release else {
return
}
// Customize your alerts here.
let title = "New Version Available"
let message = "Version \(release.displayVersion)(\(release.buildVersion)) is available."
let 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 should be a UIViewController.
self.present(uialert, animated: true, completion: nil)
})
Objective-C
[[FIRAppDistribution appDistribution]
checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
NSError *_Nullable error) {
if (error) {
// Handle error
return;
}
if (release) {
UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"New Version Available"
message:[NSString stringWithFormat:@"Version %@ (%@) is available.", release.displayVersion,
release.buildVersion] preferredStyle:UIAlertControllerStyleAlert];
UIAlertAction *updateAction = [UIAlertAction actionWithTitle:@"Update"
style:UIAlertActionStyleDefault handler:^(UIAlertAction *action) {
[[UIApplication sharedApplication] openURL:release.downloadURL options:@{}
completionHandler:nil];
}];
UIAlertAction *cancelAction = [UIAlertAction actionWithTitle:@"Cancel"
style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {}];
[alert addAction:updateAction];
[alert addAction:cancelAction];
[self presentViewController:alert animated:YES completion:nil];
}
}];
Gelişmiş yapılandırma
signInTester()
ve isTesterSignedIn
yöntemleri, test kullanıcınızın oturum açma deneyimini özelleştirirken size daha fazla esneklik sağlar. Böylece, uygulamanızın görünümü ve tarzıyla daha iyi eşleşir.
Aşağıdaki örnek, test kullanıcısının Firebase App Distribution test kullanıcısı hesabında önceden oturum açıp açmadığını kontrol eder. Bu nedenle, oturum açma kullanıcı arayüzünüzü yalnızca henüz oturum açmamış test kullanıcıları için göstermeyi seçebilirsiniz. Test kullanıcısı oturum açtıktan sonra, test kullanıcısının yeni bir derlemeye erişiminin olup olmadığını kontrol etmek için checkForUpdate()
öğesini çağırabilirsiniz.
Swift
// Sign in a tester without automatically checking for update
if (!AppDistribution.appDistribution().isTesterSignedIn) {
AppDistribution.appDistribution().signInTester (completion: { error in
// completion block for signInTester
if (error != nil) {
// handle failed sign in
return
}
// handle successful sign in
})
}
// Only check for update if tester is already signed in - do not prompt
if (AppDistribution.appDistribution().isTesterSignedIn) {
AppDistribution.appDistribution().checkForUpdate(completion: { release, error in
// completion block for check for update
})
}
Objective-C
// Sign in a tester without automatically checking for update
if(![[FIRAppDistribution appDistribution] isTesterSignedIn]) {
[[FIRAppDistribution appDistribution]
signInTesterWithCompletion:^(NSError *_Nullable error) {
// completion block for signInTester
if (error) {
// handle failed sign in
return;
}
// handle successful sign in
}];
}
// only check for update if tester is already signed in - do not prompt
if([[FIRAppDistribution appDistribution] isTesterSignedIn]) {
[[FIRAppDistribution appDistribution]
checkForUpdateWithCompletion:^(FIRAppDistributionRelease *_Nullable release,
NSError *_Nullable error) {
// completion block for check for update
}];
}
signOutTester()
dahil olmak üzere ek yöntemler hakkında bilgi edinmek için Swift ve Objective-C ile ilgili App Distribution referans belgelerine bakın.
4. Adım: Uygulamanızı oluşturun ve test edin
Son olarak, uygulamanızı oluşturun ve Firebase konsolunu kullanıp derlemeyi test kullanıcılarına dağıtarak uygulamanızı test edin.
Aşağıdakiler gibi yaygın sorunlarla ilgili yardım almak için Uygulama Dağıtımıyla İlgili Sorun Giderme kılavuzunu ziyaret edin:
- Test kullanıcısı uygulama içi uyarıları almıyor
- Test kullanıcısından Google'da birden fazla kez oturum açması isteniyor