iOS 導入

以下範例可協助您在 iOS 用戶端中實作執行個體 ID。 請注意，這些範例使用 GCM 範圍，而您希望 管理 iOS 用戶端權杖 Firebase 雲端通訊。

設定 CocoaPods 依附元件

執行個體 ID 會使用 CocoaPods 來安裝 管理依附元件開啟終端機視窗，然後瀏覽到 應用程式的 Xcode 專案如果您尚未建立 Podfile 現在就建立一個應用程式：

pod init

開啟為應用程式建立的 Podfile，然後新增下列指令：

pod 'FirebaseInstanceId'

儲存檔案並執行：

pod install

系統隨即為應用程式建立 .xcworkspace 檔案。將這個檔案用於所有使用者 開發應用程式的未來發展

產生權杖

產生權杖時，您必須提供 Google Developers Console 產生的專案 ID。

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) {
                      // ...
}];

管理權杖和執行個體 ID

執行個體 ID 可讓您刪除及更新權杖。

刪除權杖和執行個體 ID

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];

您也可以刪除執行個體 ID 本身，這樣當您下次呼叫 getInstance() 會取得新的執行個體 ID：

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

重新整理權杖

執行個體 ID 服務可能會建立或重新產生權杖。發生這種情況時 通知就會傳送如要聆聽這則通知，請在 名為 kFIRInstanceIDTokenRefreshNotification 的通知觀察器。

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

這個觀察器必須在建立權杖前建立，例如 呼叫 [FIRApp configure] 之前。如要擷取最新的權杖， 正在撥打 [[FIRInstanceID instanceID] token]。

請注意，如要觀察雲端通訊的產生權杖， 特定委派代表。