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


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

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

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

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

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 سويفت والهدف-ج.

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

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

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

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