SDK iOS dan Android Firebase App Distribution opsional memungkinkan Anda menampilkan pemberitahuan dalam aplikasi kepada penguji saat versi baru aplikasi Anda tersedia untuk dipasang. Panduan ini menjelaskan cara menggunakan App Distribution iOS dan Android SDK untuk membuat dan menyesuaikan lansiran build baru untuk penguji Anda.
Sebelum kamu memulai
Jika Anda belum melakukannya, tambahkan Firebase ke proyek iOS Anda .
Langkah 1 : Aktifkan API Penguji Distribusi Aplikasi
Pilih proyek Anda di Google Cloud Console .
Di bawah Firebase App Testers API , klik Enable .
Langkah 2 : Tambahkan Distribusi Aplikasi ke aplikasi Anda
Buka Podfile yang Anda buat untuk proyek (atau jalankan
pod init
untuk membuatnya), lalu tambahkan baris berikut di dalam bagian target:pod 'FirebaseAppDistribution'
Di direktori podfile Anda, jalankan
pod install
, lalu buka file.xcworkspace
yang dibuat.Impor modul Firebase di
App
struct atauUIApplicationDelegate
:Cepat
import FirebaseCore import FirebaseAppDistribution
Objective-C
@import FirebaseCore; @import FirebaseAppDistribution;
Konfigurasikan instance bersama
FirebaseApp
dalam metodeapplication(_:didFinishLaunchingWithOptions:)
delegasi aplikasi Anda:Cepat
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
Jika swizzling dinonaktifkan, teruskan URL apa pun yang dibuka ke App Distribution SDK dalam penerapan
application(_:open:options:)
Anda:Cepat
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; }
Terakhir, kompilasi ulang aplikasi Anda.
Langkah 3 : Konfigurasikan lansiran dalam aplikasi
App Distribution SDK menyediakan dua cara menyiapkan lansiran build dalam aplikasi untuk penguji Anda: konfigurasi lansiran dasar, yang dilengkapi dengan pembaruan aplikasi bawaan dan dialog masuk untuk ditampilkan kepada penguji, dan konfigurasi lansiran lanjutan, yang memungkinkan Anda untuk menyesuaikan antarmuka pengguna Anda sendiri. Sebaiknya gunakan konfigurasi lansiran dasar terlebih dahulu jika Anda baru mengenal App Distribution SDK.
Konfigurasi dasar
Gunakan checkForUpdate
untuk menampilkan dialog peringatan pengaktifan bawaan kepada penguji yang belum mengaktifkan peringatan, lalu periksa apakah bangunan baru tersedia. Saat dipanggil, metode memberlakukan urutan berikut:
Memeriksa apakah penguji telah mengaktifkan peringatan dengan meminta mereka masuk ke App Distribution dengan akun Google mereka.
Jika penguji belum mengaktifkan peringatan, tampilkan dialog bawaan.
Mengaktifkan lansiran adalah proses satu kali pada perangkat uji dan terus berlanjut selama pembaruan aplikasi Anda. Lansiran tetap diaktifkan di perangkat pengujian hingga aplikasi dihapus instalannya, atau hingga metode
signOutTester
dipanggil. Lihat dokumentasi referensi metode ( Swift atau Objective-C ) untuk informasi lebih lanjut.Memeriksa build yang baru tersedia untuk diinstal oleh penguji.
Anda dapat memanggil checkForUpdate()
kapan saja di aplikasi Anda. Misalnya, Anda dapat meminta penguji untuk menginstal build baru yang tersedia saat memulai dengan menyertakan checkForUpdate()
di onAppear(perform:)
tampilan root aplikasi Anda.
Contoh berikut memeriksa apakah penguji telah mengaktifkan peringatan dan memiliki akses ke build baru, dan jika ya, menampilkan dialog saat build tersedia untuk diinstal:
Cepat
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];
}
}];
Konfigurasi lanjutan
Metode signInTester()
dan isTesterSignedIn
memberi Anda lebih banyak fleksibilitas untuk menyesuaikan pengalaman masuk penguji, sehingga bisa lebih cocok dengan tampilan dan nuansa aplikasi Anda.
Contoh berikut memeriksa apakah penguji telah masuk ke akun penguji Firebase App Distribution, sehingga Anda dapat memilih untuk menampilkan UI masuk hanya untuk penguji yang belum masuk. Setelah penguji masuk, Anda dapat panggil checkForUpdate()
untuk memeriksa apakah penguji memiliki akses ke build baru.
Cepat
// 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
}];
}
Untuk informasi tentang metode tambahan, termasuk signOutTester()
, lihat dokumentasi referensi App Distribution untuk Swift dan Objective-C .
Langkah 4 : Buat dan uji implementasi Anda
Terakhir, build aplikasi Anda dan uji implementasi Anda dengan mendistribusikan build ke penguji menggunakan konsol Firebase.
Kunjungi panduan Pemecahan Masalah App Distribution untuk mendapatkan bantuan terkait masalah umum, seperti:
- Penguji tidak menerima lansiran dalam aplikasi
- Penguji diminta masuk ke Google lebih dari sekali