تتيح لك حِزم تطوير البرامج (SDK) الاختيارية لنظامَي التشغيل iOS وAndroid من "Firebase App Distribution" عرض إرسال تنبيهات داخل التطبيق إلى المختبِرين عند توفُّر إصدارات جديدة من تطبيقك التثبيت. يوضِّح هذا الدليل كيفية استخدام حِزم تطوير البرامج (SDK) لنظامي التشغيل iOS وAndroid من App Distribution. لإنشاء تنبيهات إصدار جديد وتخصيصها للمختبِرين.
قبل البدء
أضِف Firebase إلى مشروع iOS إذا لم يسبق لك إجراء ذلك.
الخطوة 1: تفعيل App Distribution Tester API
اختَر مشروعك في وحدة تحكّم Google Cloud.
ضمن Firebase App Testers API، انقر على تفعيل.
الخطوة 2: إضافة App Distribution إلى تطبيقك
افتح ملف Podfile الذي أنشأته للمشروع (أو شغِّل
pod init
لإنشاء واحد)، ثم أضف السطر التالي داخل القسم المستهدف:pod 'FirebaseAppDistribution'
في دليل ملف podfile، نفِّذ
pod install
، ثم افتح تم إنشاء ملف.xcworkspace
.استورِد وحدة Firebase في بنية
App
أوUIApplicationDelegate
:Swift
import FirebaseCore import FirebaseAppDistribution
Objective-C
@import FirebaseCore; @import FirebaseAppDistribution;
ضبط المثيل المشترك "
FirebaseApp
" في حساب مفوَّض تطبيقك طريقةapplication(_:didFinishLaunchingWithOptions:)
:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
إذا كان التبديل متوقفًا، يُرجى تمرير أي عناوين URL مفتوحة إلى حزمة تطوير البرامج (SDK) لنظام التشغيل App Distribution. عملية تنفيذ
application(_:open:options:)
: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; }
أخيرًا، أعد تجميع تطبيقك.
الخطوة 3: ضبط التنبيهات داخل التطبيق
توفّر حزمة تطوير البرامج (SDK) "App Distribution" طريقتَين لإعداد تنبيهات الإصدار داخل التطبيق لما يلي: للمختبرين: تهيئة أساسية للتنبيه تأتي مع تحديث تطبيق مُعَد مسبقًا ومربّعات حوار تسجيل الدخول لعرضها للمختبِرين، وتنبيه متقدم على جهازك، والتي تسمح لك بتخصيص واجهة المستخدم الخاصة بك. أر ننصحك به أولاً باستخدام إعدادات التنبيه الأساسية إذا كنت مستخدِمًا جديدًا حزمة تطوير البرامج (SDK) App Distribution
الإعداد الأساسي
استخدام checkForUpdate
لعرض مربّع حوار سابق الإعداد لتفعيل التنبيهات
المختبِرين الذين لم يفعّلوا التنبيهات بعد، ثم يتحققوا مما إذا كان الإصدار الجديد
المتوفرة. عند استدعائها، تؤدي الطريقة التسلسل التالي:
للتحقّق مما إذا كان المختبِر قد فعَّل التنبيهات من خلال مطالبته بتسجيل الدخول App Distribution باستخدام حساب Google.
إذا لم يفعّل المختبِر التنبيهات حتى الآن، سيتم عرض مربع حوار مُعد مسبقًا.
يُرجى العلم أنّ تفعيل التنبيهات هو عملية تتم لمرة واحدة على الجهاز الاختباري ويستمر تنفيذها على مستوى لتحديثات تطبيقك. ستظل التنبيهات مفعَّلة على جهاز الاختبار حتى إمّا أنّه تم إلغاء تثبيت التطبيق، أو إلى أن يتم استدعاء طريقة
signOutTester
. الاطّلاع على المستندات المرجعية للطريقة (سويفت أو الهدف-ج) لمزيد من المعلومات.يتم البحث عن الإصدارات المتاحة حديثًا ليثبّتها المختبِر.
يمكنك استدعاء checkForUpdate()
في أي وقت من تطبيقك. على سبيل المثال،
يمكنك مطالبة المختبِرين بتثبيت الإصدارات المتاحة حديثًا عند بدء التشغيل من خلال
بما في ذلك checkForUpdate()
في onAppear(perform:)
من جذر التطبيق
مشاهدة.
يتحقّق المثال التالي مما إذا كان المختبِر قد فعَّل التنبيهات أم لا. ويتمكن من الوصول إلى إصدار جديد، وفي هذه الحالة، يتم عرض حوار عندما إصدار متاح للتثبيت:
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];
}
}];
الإعدادات المتقدّمة
تمنحك الطريقتان signInTester()
وisTesterSignedIn
مزيدًا من المرونة
تخصيص تجربة تسجيل الدخول للمختبِرين لكي تتطابق بشكل أفضل مع
شكل التطبيق ومظهره.
يتحقّق المثال التالي مما إذا سبق للمختبِر تسجيل الدخول إلى حسابه
حساب مختبِر على Firebase App Distribution، وبالتالي يمكنك اختيار عرض
واجهة مستخدم تسجيل الدخول للمختبِرين الذين لم يسجّلوا الدخول بعد. بعد أن يصبح لدى المختبر
بعد تسجيل الدخول، يمكنك الاتصال بـ "checkForUpdate()
" لمعرفة ما إذا كان المختبِر
الوصول إلى إصدار جديد.
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()
،
راجع الوثائق المرجعية لـ App Distribution
سويفت
والهدف-ج.
الخطوة 4: إنشاء عملية التنفيذ واختبارها
وأخيرًا، أنشِئ تطبيقك واختبِر عملية التنفيذ من خلال في توزيع البنية للمختبِرين الذين يستخدمون وحدة تحكُّم Firebase.
انتقل إلى App Distribution دليل تحديد المشاكل وحلّها للحصول على المساعدة بشأن المشاكل الشائعة، مثل:
- المختبِر لا يتلقّى تنبيهات داخل التطبيق
- يُطلب من المختبِر تسجيل الدخول إلى Google أكثر من مرة.