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

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

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

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

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

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

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

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 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()، يُرجى الاطّلاع على الوثائق المرجعية لتوزيع التطبيقات Swift والهدف-ج.

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

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

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

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