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

تتيح لك حزم تطوير البرامج (SDK) الاختيارية لنظامَي التشغيل Firebase App Distribution و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. إذا تم إيقاف ميزة swizzling، عليك تمرير أي عناوين URL مفتوحة إلى App Distribution حزمة 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) في 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، حتى تتمكّن من اختيار عرض واجهة المستخدم لتسجيل الدخول فقط للمختبِرين الذين لم يسجّلوا الدخول بعد. بعد تسجيل المختبِر الدخول، يمكنك الاتصال بـ 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 أكثر من مرة