iOS-реализация

Следующие примеры помогут вам реализовать идентификатор экземпляра в клиенте iOS. Обратите внимание, что в этих примерах используется область действия GCM, которую вы используете для управления токенами в клиенте iOS для Firebase Cloud Messaging .

Настройте зависимости CocoaPods

Instance ID использует 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] .

Обратите внимание, что для наблюдения за генерацией токенов для Cloud Messaging доступен специальный делегат .