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

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

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

Instance ID использует CocoaPods для установки и управления зависимостями. Откройте окно терминала и перейдите в папку проекта Xcode для вашего приложения. Если вы еще не создали файл Podfile для своего приложения, создайте его сейчас:

pod init

Откройте файл Podfile, созданный для вашего приложения, и добавьте следующее:

pod 'FirebaseInstanceId'

Сохраните файл и запустите:

pod install

Это создаст файл .xcworkspace для вашего приложения. Используйте этот файл для всей дальнейшей разработки вашего приложения.

Сгенерировать токен

Для генерации токенов требуется идентификатор проекта, сгенерированный в консоли разработчиков Google .

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 доступен специальный делегат .