यहां दिए गए उदाहरणों से, आपको 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);
}
}];
रीफ़्रेश टोकन
Instance ID सेवा, टोकन बना सकती है या उन्हें फिर से जनरेट कर सकती है. ऐसा होने पर, आपको सूचना भेजी जाएगी. kFIRInstanceIDTokenRefreshNotification नाम की सूचनाओं के लिए ऑब्ज़र्वर जोड़कर, इस सूचना को सुना जा सकता है.
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(tokenRefreshNotification:)
name:kFIRInstanceIDTokenRefreshNotification object:nil];
इस ऑब्ज़र्वर को टोकन बनाने से पहले बनाना होगा. उदाहरण के लिए, [FIRApp configure] को कॉल करने से पहले. [[FIRInstanceID instanceID] token] को कॉल करके, नया टोकन वापस पाया जा सकता है.
ध्यान दें कि क्लाउड मैसेजिंग के लिए टोकन जनरेट करने की प्रोसेस को मॉनिटर करने के लिए, एक खास डेलिगेट उपलब्ध है.