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

تتيح لك حِزم 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 لIDE Swift وObjective-C.

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

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

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

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