Apple प्लैटफ़ॉर्म पर Firebase क्लाउड से मैसेज वाला क्लाइंट ऐप्लिकेशन सेट अप करना

Apple क्लाइंट ऐप्लिकेशन के लिए, आपको Firebase Cloud Messaging APNs इंटरफ़ेस पर 4,096 बिट तक की सूचनाएं और डेटा पेलोड मिल सकते हैं.

हमारा सुझाव है कि Objective-C या Swift में अपना क्लाइंट कोड लिखने के लिए, आप FIRMessaging API का इस्तेमाल करें. शुरुआती उदाहरण में, दोनों भाषाओं के लिए सैंपल कोड दिया गया है.

Firebase Cloud Messaging में मेथड स्विज़लिंग

FCM SDK टूल, दो मुख्य क्षेत्रों में तरीका स्विज़ल करता है: FCM रजिस्ट्रेशन टोकन पर अपने APNs टोकन को मैप करना और डाउनस्ट्रीम मैसेज कॉलबैक मैनेज करने के दौरान आंकड़ों का डेटा कैप्चर करना. जो डेवलपर स्विज़लिंग का इस्तेमाल नहीं करना चाहते वे ऐप्लिकेशन की Info.plist फ़ाइल में फ़्लैग FirebaseAppDelegateProxyEnabled जोड़कर और उसे NO (बुलियन वैल्यू) पर सेट करके, इसे बंद कर सकते हैं. गाइड के काम के हिस्सों में, कोड के उदाहरण दिए गए हैं. ये उदाहरण, मेथड स्विज़ल की सुविधा चालू होने और न होने, दोनों स्थितियों के लिए दिए गए हैं.

अपने Apple प्रोजेक्ट में Firebase जोड़ना

अगर आपने पहले से ऐसा नहीं किया है, तो अपने Apple प्रोजेक्ट में Firebase जोड़ें.

APNs की पुष्टि करने वाली कुंजी अपलोड करना

Firebase में APNs की पुष्टि करने वाली कुंजी अपलोड करें. अगर आपके पास पहले से APNs की पुष्टि करने वाली कोई कुंजी नहीं है, तो Apple Developer Member Center में जाकर एक कुंजी बनाएं.

1. Firebase कंसोल में अपने प्रोजेक्ट में, गियर आइकॉन चुनें. इसके बाद, प्रोजेक्ट सेटिंग चुनें और फिर क्लाउड मैसेजिंग टैब चुनें.

2. iOS ऐप्लिकेशन कॉन्फ़िगरेशन में जाकर, APNs की पुष्टि करने वाली कुंजी में, अपलोड करें बटन पर क्लिक करें.

3. उस जगह पर ब्राउज़ करें जहां आपने अपनी पासकोड सेव किया है. इसके बाद, उसे चुनें और खोलें पर क्लिक करें. पासकोड के लिए पासकोड आईडी जोड़ें. यह आईडी, Apple Developer Member Center में उपलब्ध होता है. इसके बाद, अपलोड करें पर क्लिक करें.

रिमोट सूचनाओं के लिए रजिस्टर करना

UNUserNotificationCenter.current().delegate = self

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

application.registerForRemoteNotifications()
AppDelegate.swift

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

[application registerForRemoteNotifications];
AppDelegate.m

रजिस्ट्रेशन टोकन ऐक्सेस करना

डिफ़ॉल्ट रूप से, FCM SDK टूल, ऐप्लिकेशन लॉन्च होने पर क्लाइंट ऐप्लिकेशन इंस्टेंस के लिए रजिस्ट्रेशन टोकन जनरेट करता है. APNs डिवाइस टोकन की तरह ही, इस टोकन की मदद से अपने ऐप्लिकेशन के किसी भी खास इंस्टेंस पर टारगेट की गई सूचनाएं भेजी जा सकती हैं.

जिस तरह Apple के प्लैटफ़ॉर्म आम तौर पर ऐप्लिकेशन के शुरू होने पर APNs डिवाइस टोकन डिलीवर करते हैं उसी तरह, FCM FIRMessagingDelegate के messaging:didReceiveRegistrationToken: तरीके से रजिस्टरेशन टोकन उपलब्ध कराता है. FCM SDK टूल, ऐप्लिकेशन के लॉन्च होने के दौरान नया या मौजूदा टोकन हासिल करता है. साथ ही, टोकन अपडेट होने या अमान्य होने पर भी ऐसा करता है. सभी मामलों में, FCM SDK टूल, मान्य टोकन के साथ messaging:didReceiveRegistrationToken: को कॉल करता है.

रजिस्ट्रेशन टोकन तब बदल सकता है, जब:

• ऐप्लिकेशन को नए डिवाइस पर वापस लाया गया हो
• उपयोगकर्ता ऐप्लिकेशन को अनइंस्टॉल करता है/फिर से इंस्टॉल करता है
• उपयोगकर्ता, ऐप्लिकेशन का डेटा मिटाता है.

मैसेजिंग ऐक्सेस देने के लिए किसी व्यक्ति को चुनना

रजिस्ट्रेशन टोकन पाने के लिए, मैसेजिंग डेलिगेट प्रोटोकॉल लागू करें और [FIRApp configure] को कॉल करने के बाद, FIRMessaging की delegate प्रॉपर्टी सेट करें. उदाहरण के लिए, अगर आपका ऐप्लिकेशन डेलिगेट, मैसेजिंग डेलिगेट प्रोटोकॉल के मुताबिक है, तो डेलिगेट को 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.
}
AppDelegate.swift

- (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.
}
AppDelegate.m

इसके अलावा, किसी डिलीगेट तरीके को देने के बजाय, NSNotification नाम वाले kFIRMessagingRegistrationTokenRefreshNotification इवेंट को सुना जा सकता है. टोकन प्रॉपर्टी में हमेशा टोकन की मौजूदा वैल्यू होती है.

स्विज़लिंग की सुविधा बंद है: अपने APNs टोकन और रजिस्ट्रेशन टोकन को मैप करना

अगर आपने मेथड स्विज़लिंग की सुविधा बंद कर दी है या SwiftUI ऐप्लिकेशन बनाया जा रहा है, तो आपको अपने APNs टोकन को FCM रजिस्ट्रेशन टोकन से साफ़ तौर पर मैप करना होगा. APNs टोकन पाने के लिए, application(_:didRegisterForRemoteNotificationsWithDeviceToken:) तरीका लागू करें. इसके बाद, Messaging की apnsToken प्रॉपर्टी सेट करें:

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 रजिस्ट्रेशन टोकन जनरेट होने के बाद, इसे ऐक्सेस किया जा सकता है और रीफ़्रेश इवेंट को सुनने के लिए, वही तरीके इस्तेमाल किए जा सकते हैं जो स्विज़लिंग की सुविधा चालू होने पर इस्तेमाल किए जाते हैं.

अपने-आप शुरू होने की सुविधा को रोकना

जब कोई FCM रजिस्ट्रेशन टोकन जनरेट होता है, तो लाइब्रेरी, आइडेंटिफ़ायर और कॉन्फ़िगरेशन डेटा को Firebase पर अपलोड करती है. अगर आपको उपयोगकर्ताओं से साफ़ तौर पर ऑप्ट-इन पाना है, तो कॉन्फ़िगर करने के समय टोकन जनरेट होने से रोका जा सकता है. इसके लिए, FCM को बंद करें. ऐसा करने के लिए, अपने Info.plist में मेटाडेटा वैल्यू जोड़ें, न कि अपने GoogleService-Info.plist में:

FirebaseMessagingAutoInitEnabled = NO

FCM को फिर से चालू करने के लिए, रनटाइम कॉल किया जा सकता है:

Messaging.messaging().autoInitEnabled = true

[FIRMessaging messaging].autoInitEnabled = YES;

सेट होने के बाद, यह वैल्यू ऐप्लिकेशन के रीस्टार्ट होने पर भी बनी रहती है.

अगले चरण

Apple क्लाइंट सेट अप करने के बाद, अपने ऐप्लिकेशन में मैसेज मैनेज करने की सुविधा और अन्य बेहतर सुविधाएं जोड़ी जा सकती हैं. ज़्यादा जानकारी के लिए, ये गाइड देखें:

• Apple के ऐप्लिकेशन में मैसेज पाना
• विषय के हिसाब से मैसेज भेजना
• डिवाइस ग्रुप पर भेजना