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

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

قبل البدء

أضِف 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) لتوزيع التطبيقات في عملية تنفيذ 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) لتوزيع التطبيقات طريقتَين لإعداد تنبيهات الإصدار داخل التطبيق للمختبِرين، وهما: ضبط أساسي للتنبيه يتضمّن تحديثًا مُسبَقًا للتطبيق ومربّعات حوار لتسجيل الدخول لعرضها للمختبِرين، وإعدادًا متقدّم للتنبيه يتيح لك تخصيص واجهة المستخدم الخاصة بك. وننصحك أولاً باستخدام إعدادات التنبيه الأساسية إذا كنت مستخدمًا جديدًا لحزمة تطوير البرامج "SDK" لتوزيع التطبيقات.

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

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

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

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

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

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

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

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

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"، وبالتالي يمكنك اختيار عرض واجهة المستخدم التي تم تسجيل الدخول إليها فقط للمختبِرين الذين لم يسجّلوا الدخول بعد. بعد أن يسجّل المختبِر الدخول، يمكنك الاتصال بـ 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()، يمكنك الاطّلاع على المستندات المرجعية الخاصة بـ "توزيع التطبيقات" لكل من Swift وObjective-C.

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

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

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

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