Implementación en iOS

Los siguientes ejemplos te ayudarán a implementar el ID de instancia en un cliente de iOS. Ten en cuenta que estos ejemplos usan el alcance de GCM, que usarías para administrar tokens de un cliente de iOS para Firebase Cloud Messaging.

Configura tus dependencias de CocoaPods

Instance ID usa CocoaPods para instalar y administrar dependencias. Abre una ventana de terminal y navega hasta la ubicación del proyecto de Xcode para tu aplicación. Si aún no creaste un Podfile para tu aplicación, créalo ahora:

pod init

Abre el Podfile creado para tu aplicación y agrega lo siguiente:

pod 'FirebaseInstanceId'

Guarda el archivo y ejecuta:

pod install

Esto crea un archivo .xcworkspace para tu aplicación. Úsalo para todo desarrollo futuro en tu aplicación.

Genera un token

Para generar tokens, se requiere un ID del proyecto generado por 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) {
                      // ...
}];

Administra los tokens y los IDs de instancia

Instance ID te permite borrar y actualizar tokens.

Borra los tokens y los IDs de instancia

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

También puedes borrar el ID de instancia, en cuyo caso, la próxima vez que llames a getInstance(), obtendrás un ID de instancia nuevo:

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

Tokens de actualización

El servicio de ID de instancia puede crear o volver a generar tokens. Cuando esto ocurre, se envía una notificación. Puedes escuchar esta notificación si agregas un observador de notificaciones llamado kFIRInstanceIDTokenRefreshNotification.

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

Este observador debe crearse antes de crear el token, por ejemplo, antes de llamar a [FIRApp configure]. Para recuperar el token más reciente, llama a [[FIRInstanceID instanceID] token].

Ten en cuenta que, para observar la generación de tokens para Cloud Messaging, hay un delegado específico disponible.