İsteğe bağlı Firebase App Distribution iOS ve Android SDK'ları, uygulamanızın yeni sürümleri kullanıma sunulduğunda test kullanıcılarınıza gösterilecek uygulama içi uyarılar teşekkür ederiz. Bu kılavuzda, App Distribution iOS ve Android SDK'larının nasıl kullanılacağı açıklanmaktadır. kullanın.
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 konsolunda 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 dosyasını açın (veya bir tane oluşturmak için
pod init
komutunu çalıştırın) ve hedef bölümüne aşağıdaki satırı ekleyin:pod 'FirebaseAppDistribution'
Podfile dosyanızın dizininde
pod install
komutunu çalıştırın, ardından.xcworkspace
dosyası oluşturuldu.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 temsilcinizin
application(_:didFinishLaunchingWithOptions:)
yönteminde birFirebaseApp
paylaşılan örnek yapılandırın:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
Değiştirme devre dışıysa
application(_:open:options:)
uygulamanızda açılan tüm 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ı ayarlama konusunda iki yöntem sunar: test kullanıcılarına gösterilecek önceden oluşturulmuş uygulama güncelleme ve oturum açma iletişim kutularıyla birlikte gelen temel uyarı yapılandırması ve kendi kullanıcı arayüzünüzü özelleştirmenize olanak tanıyan gelişmiş uyarı yapılandırması. Biz kullanmaya yeni başlayanlar için ilk olarak temel uyarı yapılandırmasını App Distribution SDK'sı.
Temel yapılandırma
Önceden oluşturulmuş uyarıları etkinleştirme iletişim kutusunu görüntülemek için checkForUpdate
kullanın.
ve yeni bir derlemenin kullanıma sunulup sunulmadığını kontrol etmek için
kullanılabilir. Bu yöntem çağrıldığında aşağıdaki sırayı uygular:
Bir test kullanıcısından Google Hesabı ile App Distribution'de 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 uyarı süresince devam eder. güncellemelerine bakacağız. Uyarılar test cihazında etkin olarak kalır. ya da
signOutTester
yöntemi çağrılana kadar uygulama kaldırılır. Yöntemin referans belgelerini inceleyin (Swift veya Objective-C) konulu videomuzu izleyin.Test kullanıcısının yükleyebileceği yeni sürümleri kontrol eder.
checkForUpdate()
işlevini uygulamanızın herhangi bir yerinde çağırabilirsiniz. Örneğin, uygulamanızın kök görünümündeki onAppear(perform:)
içine checkForUpdate()
ekleyerek test kullanıcılarınızın yeni yayınlanan derlemeleri başlatma sırasında yüklemesini isteyebilirsiniz.
Aşağıdaki örnek, test kullanıcısının uyarıları etkinleştirip etkinleştirmediğini kontrol eder ve yeni bir derlemeye erişimi varsa, derleme yüklenebilir:
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 size daha fazla esneklik sağlar.
Böylece, test kullanıcınızın oturum açma deneyimini özelleştirebilirsiniz.
görünümünü ve tarzını değiştirebilirsiniz.
Aşağıdaki örnekte, test kullanıcısının
Firebase App Distribution test kullanıcısı hesabınız olduğundan,
yalnızca henüz oturum açmamış test kullanıcıları için oturum açma kullanıcı arayüzü. Test kullanıcısı
oturum açtıktan sonra, test kullanıcısının size ait olup olmadığını kontrol etmek için checkForUpdate()
yeni derlemeye
erişebilirsiniz.
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 için App Distribution referans dokümanlarına bakın.
4. Adım: Uygulamanızı oluşturun ve test edin
Son olarak da uygulamanızı derleyin ve derlemeyi dağıtma test kullanıcılarına Firebase konsolunu kullanarak.
Aşağıdakiler gibi sık karşılaşılan sorunlarla ilgili yardım almak için App Distribution Sorun giderme kılavuzu sayfasını ziyaret edin:
- Test kullanıcısı uygulama içi uyarı almıyor
- Test kullanıcısından Google'da birden fazla kez oturum açması isteniyor