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

تتيح لك حِزم 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:) في عرض ملف ‎root الخاص بتطبيقك.

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

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)
})

[[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() للتحقّق مما إذا كان بإمكانه الوصول إلى إصدار جديد.

// 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
  })
}

// 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 أكثر من مرة.