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


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

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

Swift

ملاحظة: لا يتوفّر هذا المنتج على أجهزة macOS أو Mac Catalyst أو tvOS أو watchOS. 
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)
})

Objective-C

ملاحظة: لا يتوفّر هذا المنتج على أجهزة macOS أو Mac Catalyst أو tvOS أو watchOS. 
[[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() للتحقّق مما إذا كان المختبِر لديه إذن بالوصول إلى إصدار جديد.

Swift

ملاحظة: لا يتوفّر هذا المنتج على أجهزة macOS أو Mac Catalyst أو tvOS أو watchOS. 
// 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
  })
}

Objective-C

ملاحظة: لا يتوفّر هذا المنتج على أجهزة macOS أو Mac Catalyst أو tvOS أو watchOS. 
// 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 أكثر من مرة