إشعار المختبِرين بشأن الإصدارات الجديدة


تتيح لك حِزم تطوير البرامج (SDK) الاختيارية Firebase App Distribution لنظامَي التشغيل iOS وAndroid عرض تنبيهات داخل التطبيق للمختبِرين عندما تتوفّر إصدارات جديدة من تطبيقك لتثبيتها. يوضّح هذا الدليل كيفية استخدام حِزم تطوير البرامج (SDK) لنظامَي التشغيل iOS وAndroid لإنشاء تنبيهات جديدة بشأن الإصدارات وتخصيصها للمختبِرين.App Distribution

قبل البدء

أضِف Firebase إلى مشروع iOS إذا لم يسبق لك إجراء ذلك.

الخطوة 1: تفعيل واجهة برمجة التطبيقات App Distribution Tester API

  1. اختَر مشروعك في Google Cloudوحدة التحكّم.

  2. ضمن Firebase App Testers API، انقر على تفعيل.

الخطوة 2: إضافة App Distribution إلى تطبيقك

  1. افتح ملف Podfile الذي أنشأته للمشروع (أو شغِّل pod init لإنشاء ملف)، ثم أضِف السطر التالي داخل قسم الهدف:

    pod 'FirebaseAppDistribution'

  2. في دليل ملف podfile، شغِّل pod install، ثم افتح الملف .xcworkspace الذي تم إنشاؤه.

  3. استورِد وحدة Firebase في بنية App أو UIApplicationDelegate:

    Swift

    import FirebaseCore
import FirebaseAppDistribution

    Objective-C

    @import FirebaseCore;
@import FirebaseAppDistribution;

  4. اضبط مثيلاً مشتركًا FirebaseApp في طريقة application(_:didFinishLaunchingWithOptions:) لتفويض تطبيقك:

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];

  5. في حال إيقاف عملية استبدال الرمز، مرِّر أي عناوين 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;
}

  6. أخيرًا، أعِد تجميع تطبيقك.

الخطوة 3: ضبط التنبيهات داخل التطبيق

توفّر حزمة تطوير البرامج (SDK) App Distribution طريقتَين لإعداد تنبيهات الإصدار داخل التطبيق للمختبِرين: إعداد تنبيه أساسي يتضمّن مربّعات حوار مُعدّة مسبقًا لتحديث التطبيق وتسجيل الدخول لعرضها للمختبِرين، وإعداد تنبيه متقدّم يتيح لك تخصيص واجهة المستخدم الخاصة بك. ننصحك أولاً باستخدام إعدادات التنبيه الأساسية إذا كنت جديدًا على حزمة تطوير البرامج (SDK) الخاصة بـ App Distribution.

الإعداد الأساسي

استخدِم checkForUpdate لعرض مربّع حوار مسبق الإنشاء لتفعيل التنبيهات للمختبِرين الذين لم يفعِّلوا التنبيهات بعد، ثم تحقَّق مما إذا كان هناك إصدار جديد متاح. عند استدعاء الطريقة، يتم تنفيذ التسلسل التالي:

  1. تتحقّق هذه الطريقة مما إذا كان أحد المختبِرين قد فعّل التنبيهات من خلال مطالبته بتسجيل الدخول إلى App Distribution باستخدام حسابه على Google.

  2. إذا لم يفعّل المختبِر التنبيهات بعد، سيتم عرض مربّع حوار مُعدّ مسبقًا.

    تفعيل التنبيهات هو عملية تتم لمرة واحدة على الجهاز الاختباري وتستمر مع جميع تحديثات تطبيقك. وتبقى التنبيهات مفعَّلة على الجهاز الاختباري إلى أن يتم إلغاء تثبيت التطبيق أو إلى أن يتم استدعاء الطريقة signOutTester. راجِع مستندات المرجع الخاصة بالطريقة (Swift أو Objective-C) للحصول على مزيد من المعلومات.

  3. البحث عن أحدث الإصدارات المتاحة للمختبِر لتثبيتها

يمكنك استدعاء checkForUpdate() في أي وقت داخل تطبيقك. على سبيل المثال، يمكنك أن تطلب من المختبِرين تثبيت الإصدارات المتاحة حديثًا عند بدء التشغيل من خلال تضمين checkForUpdate() في onAppear(perform:) لعرض الجذر في تطبيقك.

يتحقّق المثال التالي مما إذا كان المختبِر قد فعّل التنبيهات ويمكنه الوصول إلى إصدار جديد، وإذا كان الأمر كذلك، يعرض مربع حوار عند توفّر الإصدار للتثبيت:

Swift

ملاحظة: لا يتوفّر هذا المنتج على أنظمة التشغيل macOS أو Mac Catalyst أو tvOS أو watchOS. 
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

ملاحظة: لا يتوفّر هذا المنتج على أنظمة التشغيل macOS أو Mac Catalyst أو tvOS أو watchOS. 
[[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

ملاحظة: لا يتوفّر هذا المنتج على أنظمة التشغيل macOS أو Mac Catalyst أو tvOS أو watchOS. 
// 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

ملاحظة: لا يتوفّر هذا المنتج على أنظمة التشغيل macOS أو Mac Catalyst أو tvOS أو watchOS. 
// 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 المرجعية الخاصة Swift وObjective-C.

الخطوة 4: إنشاء عملية التنفيذ واختبارها

أخيرًا، أنشئ تطبيقك واختبِر عملية التنفيذ من خلال توزيع الإصدار على المختبِرين باستخدام وحدة تحكّم Firebase.

يُرجى الانتقال إلى App Distribution دليل تحديد المشاكل وحلّها للحصول على مساعدة بشأن المشاكل الشائعة، مثل:

  • عدم تلقّي المختبِر تنبيهات داخل التطبيق
  • يُطلب من المختبِر تسجيل الدخول إلى Google أكثر من مرة