iOS लागू करना

नीचे दिए गए उदाहरण, iOS क्लाइंट में इंस्टेंस आईडी लागू करने में आपकी मदद करेंगे. ध्यान दें कि इन उदाहरणों में GCM दायरे का इस्तेमाल किया गया है. इसका इस्तेमाल आप Firebase क्लाउड से मैसेज के लिए, किसी iOS क्लाइंट के लिए टोकन मैनेज करने के लिए करेंगे.

अपने CocoaPods डिपेंडेंसी सेट अप करें

इंस्टेंस आईडी, डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए CocoaPods का इस्तेमाल करता है. एक टर्मिनल विंडो खोलें और अपने ऐप्लिकेशन के लिए Xcode प्रोजेक्ट की जगह पर नेविगेट करें. अगर आपने अपने ऐप्लिकेशन के लिए पहले से कोई Podfile नहीं बनाई है, तो अभी एक Podfile बनाएं:

pod init

अपने ऐप्लिकेशन के लिए बनाया गया Podfile खोलें और यह डेटा जोड़ें:

pod 'FirebaseInstanceId'

फ़ाइल सेव करें और चलाएं:

pod install

इससे आपके ऐप्लिकेशन के लिए एक .xcworkspace फ़ाइल बन जाएगी. इस फ़ाइल का इस्तेमाल अपने ऐप्लिकेशन को आने वाले समय में डेवलप करने के लिए करें.

टोकन जनरेट करना

टोकन जनरेट करने के लिए, Google Developers Console से जनरेट किया गया प्रोजेक्ट आईडी ज़रूरी है.

NSString *authorizedEntity = PROJECT_ID;
String *scope = kFIRInstanceIDScopeFirebaseMessaging;
NSDictionary *options = @{
  @"apns_token" : <APNS Token data>,
  // 1 if APNS sandbox token else 0
  @"apns_sandbox" : @(1),
};
[[FIRInstanceID instanceID] tokenWithAuthorizedEntity:authorizedEntity
                                                scope:scope
                                              options:options
                                              handler:
                  ^(NSString * _Nullable token, NSError * _Nullable error) {
                      // ...
}];

टोकन और इंस्टेंस आईडी मैनेज करना

इंस्टेंस आईडी की मदद से, टोकन मिटाए और रीफ़्रेश किए जा सकते हैं.

टोकन और इंस्टेंस आईडी मिटाएं

NSString *authorizedEntity = PROJECT_ID; // Project ID
String *scope = kFIRInstanceIDScopeFirebaseMessaging;
FIRInstanceIDDeleteTokenHandler handler = ^void(NSError *error) {
  if (error) {
    // Failed to delete the token. Check error and do an exponential
    // backoff to retry again.
  } else {
    // Successfully deleted the token.
  }
};
[[FIRInstanceID instanceID]
    deleteTokenWithAuthorizedEntity:authorizedEntity
                              scope:scope
                            handler:handler];

आपके पास इंस्टेंस आईडी को भी मिटाने का विकल्प है. ऐसे में, अगली बार getInstance() को कॉल करने पर आपको एक नया इंस्टेंस आईडी मिलेगा:

[FIRInstanceID instanceID] deleteIDWithHandler:^(NSError *error) {
      if error != nil {
        NSLog(@"Error deleting instance ID: %@", error);
      }
    }];

टोकन रीफ़्रेश करें

इंस्टेंस आईडी सेवा, टोकन बना सकती है या उन्हें फिर से जनरेट कर सकती है. ऐसा होने पर, एक सूचना भेजी जाएगी. इस सूचना को सुनने के लिए, kFIRInstanceIDTokenRefreshNotification नाम का सूचनाओं के लिए एक ऑब्ज़र्वर जोड़ें.

[[NSNotificationCenter defaultCenter] addObserver:self
         selector:@selector(tokenRefreshNotification:) 
         name:kFIRInstanceIDTokenRefreshNotification object:nil];

यह ऑब्ज़र्वर, टोकन बनाने से पहले बनाया जाना चाहिए. उदाहरण के लिए, [FIRApp configure] को कॉल करने से पहले. [[FIRInstanceID instanceID] token] पर कॉल करके, सबसे नया टोकन वापस पाया जा सकता है.

ध्यान दें कि क्लाउड से मैसेज के लिए टोकन जनरेट किए जाने के बारे में जानने के लिए, एक खास डेलीगेट उपलब्ध है.