iOS 实现

以下示例将帮助您在 iOS 客户端中实现实例 ID。 请注意，这些示例使用 GCM 范围，您将使用该范围 为 iOS 客户端管理令牌， Firebase Cloud Messaging。

设置您的 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]。

请注意，要观察 Cloud Messaging 的令牌生成情况， 可用的特定委托。