قم بإعداد تطبيق عميل Firebase Cloud Messaging على أنظمة Apple الأساسية

بالنسبة لتطبيقات عميل Apple، يمكنك تلقي الإشعارات وحمولات البيانات بما يصل إلى 4000 بايت عبر واجهة Firebase Cloud Messaging APNs.

لكتابة رمز العميل الخاص بك في Objective-C أو Swift، نوصي باستخدام FIRMessaging API . يوفر مثال البدء السريع نموذجًا للتعليمات البرمجية لكلتا اللغتين.

الطريقة السريعة في Firebase Cloud Messaging

تقوم FCM SDK بتنفيذ الطريقة في مجالين رئيسيين: تعيين رمز APN الخاص بك إلى رمز تسجيل FCM والتقاط البيانات التحليلية أثناء معالجة رد اتصال الرسائل النهائية . يمكن للمطورين الذين يفضلون عدم استخدام swizzling تعطيله عن طريق إضافة العلامة FirebaseAppDelegateProxyEnabled في ملف Info.plist الخاص بالتطبيق وتعيينه على NO (قيمة منطقية). توفر المناطق ذات الصلة من الأدلة أمثلة على التعليمات البرمجية، سواء مع تمكين طريقة swizzling أو بدونها.

أضف Firebase إلى مشروع Apple الخاص بك

إذا لم تكن قد قمت بذلك بالفعل، فأضف Firebase إلى مشروع Apple الخاص بك .

قم بتحميل مفتاح مصادقة APNs الخاص بك

قم بتحميل مفتاح مصادقة APNs الخاص بك إلى Firebase. إذا لم يكن لديك بالفعل مفتاح مصادقة APNs، فتأكد من إنشاء واحد في مركز أعضاء مطوري Apple .

  1. داخل مشروعك في وحدة تحكم Firebase، حدد رمز الترس، وحدد إعدادات المشروع ، ثم حدد علامة التبويب Cloud Messaging .

  2. في مفتاح مصادقة APNs ضمن تكوين تطبيق iOS ، انقر فوق الزر تحميل .

  3. استعرض وصولاً إلى الموقع الذي حفظت فيه مفتاحك، وحدده، ثم انقر فوق فتح . أضف معرف المفتاح للمفتاح (المتوفر في مركز أعضاء مطوري Apple ) وانقر فوق تحميل .

سجل للحصول على الإخطارات عن بعد

سواء عند بدء التشغيل، أو عند النقطة المطلوبة في تدفق التطبيق، قم بتسجيل تطبيقك للحصول على إشعارات عن بعد. استدعاء registerForRemoteNotifications كما هو موضح:

سويفت


UNUserNotificationCenter.current().delegate = self

let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
UNUserNotificationCenter.current().requestAuthorization(
  options: authOptions,
  completionHandler: { _, _ in }
)

application.registerForRemoteNotifications()

ج موضوعية


[UNUserNotificationCenter currentNotificationCenter].delegate = self;
UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert |
    UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
[[UNUserNotificationCenter currentNotificationCenter]
    requestAuthorizationWithOptions:authOptions
    completionHandler:^(BOOL granted, NSError * _Nullable error) {
      // ...
    }];

[application registerForRemoteNotifications];

الوصول إلى رمز التسجيل

افتراضيًا، تقوم FCM SDK بإنشاء رمز تسجيل مميز لمثيل تطبيق العميل عند تشغيل التطبيق. على غرار رمز جهاز APNs، يتيح لك هذا الرمز المميز إرسال إشعارات مستهدفة إلى أي مثيل معين لتطبيقك.

بنفس الطريقة التي توفر بها منصات Apple عادةً رمزًا مميزًا لجهاز APN عند بدء التطبيق، توفر FCM رمزًا مميزًا للتسجيل عبر طريقة messaging:didReceiveRegistrationToken: FIRMessagingDelegate . تسترد FCM SDK رمزًا مميزًا جديدًا أو موجودًا أثناء التشغيل الأولي للتطبيق وكلما تم تحديث الرمز المميز أو إبطاله. في كافة الحالات، يستدعي FCM SDK messaging:didReceiveRegistrationToken: برمز مميز صالح.

قد يتغير رمز التسجيل عندما:

  • تتم استعادة التطبيق على جهاز جديد
  • يقوم المستخدم بإلغاء تثبيت/إعادة تثبيت التطبيق
  • يقوم المستخدم بمسح بيانات التطبيق.

تعيين مندوب المراسلة

لتلقي رموز التسجيل، قم بتنفيذ بروتوكول مندوب المراسلة وقم بتعيين خاصية delegate FIRMessaging بعد استدعاء [FIRApp configure] . على سبيل المثال، إذا كان مفوض التطبيق الخاص بك يتوافق مع بروتوكول مفوض المراسلة، فيمكنك تعيين المفوض في application:didFinishLaunchingWithOptions: لنفسه.

سويفت

Messaging.messaging().delegate = self

ج موضوعية

[FIRMessaging messaging].delegate = self;

جلب رمز التسجيل الحالي

يتم تسليم رموز التسجيل عبر طريقة messaging:didReceiveRegistrationToken: . يتم استدعاء هذه الطريقة بشكل عام مرة واحدة لكل تطبيق يبدأ برمز التسجيل. عندما يتم استدعاء هذه الطريقة، فهذا هو الوقت المثالي للقيام بما يلي:

  • إذا كان رمز التسجيل جديدًا، فأرسله إلى خادم التطبيق الخاص بك.
  • اشترك في رمز التسجيل للمواضيع. وهذا مطلوب فقط للاشتراكات الجديدة أو للحالات التي أعاد فيها المستخدم تثبيت التطبيق.

يمكنك استرداد الرمز المميز مباشرةً باستخدام token(completion:) . يتم توفير خطأ غير فارغ إذا فشل استرداد الرمز المميز بأي شكل من الأشكال.

سويفت

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching FCM registration token: \(error)")
  } else if let token = token {
    print("FCM registration token: \(token)")
    self.fcmRegTokenMessage.text  = "Remote FCM registration token: \(token)"
  }
}

ج موضوعية

[[FIRMessaging messaging] tokenWithCompletion:^(NSString *token, NSError *error) {
  if (error != nil) {
    NSLog(@"Error getting FCM registration token: %@", error);
  } else {
    NSLog(@"FCM registration token: %@", token);
    self.fcmRegTokenMessage.text = token;
  }
}];

يمكنك استخدام هذه الطريقة في أي وقت للوصول إلى الرمز المميز بدلاً من تخزينه.

مراقبة تحديث الرمز المميز

ليتم إعلامك عند تحديث الرمز المميز، قم بتوفير مندوب يتوافق مع بروتوكول مندوب المراسلة. يقوم المثال التالي بتسجيل المفوض وإضافة أسلوب المفوض المناسب:

سويفت

func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
  print("Firebase registration token: \(String(describing: fcmToken))")

  let dataDict: [String: String] = ["token": fcmToken ?? ""]
  NotificationCenter.default.post(
    name: Notification.Name("FCMToken"),
    object: nil,
    userInfo: dataDict
  )
  // TODO: If necessary send token to application server.
  // Note: This callback is fired at each app startup and whenever a new token is generated.
}

ج موضوعية

- (void)messaging:(FIRMessaging *)messaging didReceiveRegistrationToken:(NSString *)fcmToken {
    NSLog(@"FCM registration token: %@", fcmToken);
    // Notify about received token.
    NSDictionary *dataDict = [NSDictionary dictionaryWithObject:fcmToken forKey:@"token"];
    [[NSNotificationCenter defaultCenter] postNotificationName:
     @"FCMToken" object:nil userInfo:dataDict];
    // TODO: If necessary send token to application server.
    // Note: This callback is fired at each app startup and whenever a new token is generated.
}

وبدلاً من ذلك، يمكنك الاستماع إلى NSNotification المسمى kFIRMessagingRegistrationTokenRefreshNotification بدلاً من توفير طريقة تفويض. تحتوي خاصية الرمز المميز دائمًا على قيمة الرمز المميز الحالية.

تم تعطيل Swizzling: تعيين رمز APN الخاص بك ورمز التسجيل

إذا قمت بتعطيل طريقة swizzling، أو كنت تقوم بإنشاء تطبيق SwiftUI، فستحتاج إلى تعيين رمز APNs المميز الخاص بك بشكل صريح إلى رمز تسجيل FCM. قم بتنفيذ طريقة application(_:didRegisterForRemoteNotificationsWithDeviceToken:) لاسترداد رمز APNs، ثم قم بتعيين خاصية apnsToken الخاصة Messaging :

سويفت

func application(application: UIApplication,
                 didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
  Messaging.messaging().apnsToken = deviceToken
}

ج موضوعية

// With "FirebaseAppDelegateProxyEnabled": NO
- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [FIRMessaging messaging].APNSToken = deviceToken;
}

بعد إنشاء رمز تسجيل FCM، يمكنك الوصول إليه والاستماع إلى أحداث التحديث باستخدام نفس الطرق كما هو الحال مع تمكين swizzling.

منع التهيئة التلقائية

عند إنشاء رمز تسجيل FCM، تقوم المكتبة بتحميل المعرف وبيانات التكوين إلى Firebase. إذا كنت ترغب في الحصول على اشتراك صريح من المستخدمين أولاً، فيمكنك منع إنشاء الرمز المميز في وقت التكوين عن طريق تعطيل FCM. للقيام بذلك، أضف قيمة بيانات التعريف إلى Info.plist (وليس GoogleService-Info.plist الخاص بك):

FirebaseMessagingAutoInitEnabled = NO

لإعادة تمكين FCM، يمكنك إجراء مكالمة وقت التشغيل:

سويفت

Messaging.messaging().autoInitEnabled = true

ج موضوعية

[FIRMessaging messaging].autoInitEnabled = YES;

تستمر هذه القيمة عبر عمليات إعادة تشغيل التطبيق بمجرد تعيينها.

الخطوات التالية

بعد إعداد عميل Apple الخاص بك، تصبح جاهزًا لإضافة معالجة الرسائل وغيرها من السلوكيات الأكثر تقدمًا إلى تطبيقك. راجع هذه الأدلة لمزيد من المعلومات: