iOS लागू करना

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

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

इंस्टेंस आईडी, डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए CocoaPods का इस्तेमाल करता है. टर्मिनल विंडो खोलें और अपने ऐप्लिकेशन के लिए Xcode प्रोजेक्ट की जगह पर जाएं. अगर आपने अपने ऐप्लिकेशन के लिए पहले से कोई 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] को कॉल करके, नया टोकन पाया जा सकता है.

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