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

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

قبل البدء

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

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

1. اختَر مشروعك في الـ Google Cloud console.

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:)App Distribution

   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:) للعرض الجذري لتطبيقك.

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

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 Tester، ما يتيح لك اختيار عرض واجهة مستخدم تسجيل الدخول فقط للمختبِرين الذين لم يسجّلوا الدخول بعد. بعد أن يسجّل المختبِر الدخول، يمكنك بعد ذلك استدعاء 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 Console.

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

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