İsteğe bağlı Firebase Uygulama Dağıtımı iOS ve Android SDK'ları, uygulamanızın yeni sürümleri yüklenmeye hazır olduğunda test kullanıcılarınıza uygulama içi uyarılar görüntülemenize olanak tanır. Bu kılavuzda, test kullanıcılarınız için yeni derleme uyarıları oluşturmak ve özelleştirmek amacıyla Uygulama Dağıtımı iOS ve Android SDK'larının nasıl kullanılacağı açıklanmaktadır.
Sen başlamadan önce
Henüz yapmadıysanız iOS projenize Firebase'i ekleyin .
1. Adım : Uygulama Dağıtımı Test Cihazı API'sini etkinleştirin
Google Cloud Console'da projenizi seçin.
Firebase Uygulama Test Cihazları API'si altında Etkinleştir'i tıklayın.
2. Adım : Uygulamanıza Uygulama Dağıtımı ekleyin
Proje için oluşturduğunuz Pod dosyasını açın (veya bir tane oluşturmak için
pod init
komutunu çalıştırın), ardından hedef bölümün içine aşağıdaki satırı ekleyin:pod 'FirebaseAppDistribution'
Pod 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
aktarın:Süratli
import FirebaseCore import FirebaseAppDistribution
Amaç-C
@import FirebaseCore; @import FirebaseAppDistribution;
Uygulama temsilcinizin
application(_:didFinishLaunchingWithOptions:)
yöntemindeFirebaseApp
paylaşılan örneğini yapılandırın:Süratli
// Use Firebase library to configure APIs FirebaseApp.configure()
Amaç-C
// Use Firebase library to configure APIs [FIRApp configure];
Döndürme devre dışıysa,
application(_:open:options:)
uygulamanızdaki açık URL'leri Uygulama Dağıtımı SDK'sına iletin:Süratli
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 }
Amaç-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
Uygulama Dağıtımı SDK'sı, test kullanıcılarınız için uygulama içi derleme uyarıları ayarlamanın iki yolunu sunar: önceden oluşturulmuş uygulama güncellemesi ve test kullanıcılarına görüntülenecek oturum açma diyaloglarıyla birlikte gelen temel bir uyarı yapılandırması ve gelişmiş bir uyarı yapılandırması. kendi kullanıcı arayüzünüzü özelleştirebilirsiniz. Uygulama Dağıtımı SDK'sında yeniyseniz öncelikle 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ş bir uyarıları etkinleştirme iletişim kutusunu görüntülemek için checkForUpdate
kullanın ve ardından yeni bir yapının mevcut olup olmadığını kontrol edin. Yöntem çağrıldığında aşağıdaki sırayı etkinleştirir:
Test kullanıcısının Google hesabıyla Uygulama Dağıtımı'nda oturum açmasını isteyerek uyarıları etkinleştirip etkinleştirmediğini kontrol eder.
Test cihazı henüz uyarıları etkinleştirmediyse önceden oluşturulmuş bir diyalog görüntüler.
Uyarıların etkinleştirilmesi, test cihazında tek seferlik bir işlemdir ve uygulamanızın güncellemeleri boyunca devam eder. Uygulama kaldırılana veya
signOutTester
yöntemi çağrılana kadar test cihazında uyarılar etkin kalır. Daha fazla bilgi için yöntemin referans belgelerine ( Swift veya Objective-C ) bakın.Test cihazının yüklemesi için mevcut yeni yapıları kontrol eder.
Uygulamanızın herhangi bir noktasında checkForUpdate()
işlevini çağırabilirsiniz. Örneğin, uygulamanızın kök görünümünün onAppear(perform:)
öğesine checkForUpdate()
dahil ederek, test kullanıcılarınızdan başlangıçta yeni kullanılabilir yapıları yüklemelerini isteyebilirsiniz.
Aşağıdaki örnek, test cihazının uyarıları etkinleştirip etkinleştirmediğini ve yeni bir yapıya erişimi olup olmadığını kontrol eder ve eğer öyleyse, yapı yüklenmeye hazır olduğunda bir diyalog görüntüler:
Süratli
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)
})
Amaç-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ştirme konusunda size daha fazla esneklik sağlar, böylece uygulamanızın görünümüne ve tarzına daha iyi uyum sağlar.
Aşağıdaki örnek, test kullanıcısının Firebase Uygulama Dağıtımı 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 şunları yapabilirsiniz: Test cihazının yeni bir yapıya erişimi olup olmadığını kontrol etmek için checkForUpdate()
öğesini çağırın.
Süratli
// 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
})
}
Amaç-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 için Uygulama Dağıtımı referans belgelerine bakın.
4. Adım : Uygulamanızı oluşturun ve test edin
Son olarak, uygulamanızı oluşturun ve yapıyı Firebase konsolunu kullanarak test kullanıcılarına dağıtarak uygulamanızı test edin.
Aşağıdakiler gibi yaygın sorunlarla ilgili yardım için Uygulama Dağıtımı 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