Configurar una aplicación de cliente Firebase Cloud Messaging en plataformas Apple

Para las aplicaciones cliente de Apple, puede recibir notificaciones y cargas útiles de datos de hasta 4000 bytes a través de la interfaz de APN de Firebase Cloud Messaging.

Para escribir su código de cliente en Objective-C o Swift, le recomendamos que utilice la API FIRMessaging . El ejemplo de inicio rápido proporciona código de muestra para ambos idiomas.

Método swizzling en Firebase Cloud Messaging

El SDK de FCM realiza un intercambio de métodos en dos áreas clave: asigna su token de APN al token de registro de FCM y captura datos analíticos durante el manejo de devolución de llamadas de mensajes descendentes . Los desarrolladores que prefieran no usar swizzling pueden desactivarlo agregando el indicador FirebaseAppDelegateProxyEnabled en el archivo Info.plist de la aplicación y estableciéndolo en NO (valor booleano). Las áreas relevantes de las guías proporcionan ejemplos de código, tanto con como sin el método swizzling habilitado.

Agregue Firebase a su proyecto de Apple

Si aún no lo ha hecho, agregue Firebase a su proyecto de Apple .

Cargue su clave de autenticación APNs

Cargue su clave de autenticación de APN en Firebase. Si aún no tiene una clave de autenticación de APN, asegúrese de crear una en el Centro de miembros para desarrolladores de Apple .

1. Dentro de su proyecto en la consola Firebase, seleccione el ícono de ajustes, seleccione Configuración del proyecto y luego seleccione la pestaña Cloud Messaging .

2. En la clave de autenticación de APN en la configuración de la aplicación iOS , haga clic en el botón Cargar .

3. Vaya a la ubicación donde guardó su clave, selecciónela y haga clic en Abrir . Agregue el ID de clave para la clave (disponible en el Centro de miembros para desarrolladores de Apple ) y haga clic en Cargar .

Regístrese para recibir notificaciones remotas

UNUserNotificationCenter.current().delegate = self

let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
UNUserNotificationCenter.current().requestAuthorization(
  options: authOptions,
  completionHandler: { _, _ in }
)

application.registerForRemoteNotifications()
AppDelegate.swift

[UNUserNotificationCenter currentNotificationCenter].delegate = self;
UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert |
    UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
[[UNUserNotificationCenter currentNotificationCenter]
    requestAuthorizationWithOptions:authOptions
    completionHandler:^(BOOL granted, NSError * _Nullable error) {
      // ...
    }];

[application registerForRemoteNotifications];
AppDelegate.m

Acceder al token de registro

De forma predeterminada, el SDK de FCM genera un token de registro para la instancia de la aplicación cliente al iniciar la aplicación. Similar al token del dispositivo APN, este token le permite enviar notificaciones dirigidas a cualquier instancia particular de su aplicación.

De la misma manera que las plataformas de Apple generalmente entregan un token de dispositivo APN al inicio de la aplicación, FCM proporciona un token de registro a través del método de messaging:didReceiveRegistrationToken: FIRMessagingDelegate El SDK de FCM recupera un token nuevo o existente durante el lanzamiento inicial de la aplicación y cada vez que el token se actualiza o invalida. En todos los casos, el SDK de FCM llama messaging:didReceiveRegistrationToken: con un token válido.

El token de registro puede cambiar cuando:

• La aplicación se restaura en un nuevo dispositivo
• El usuario desinstala/reinstala la aplicación
• El usuario borra los datos de la aplicación.

Establecer el delegado de mensajería

Para recibir tokens de registro, implemente el protocolo de delegado de mensajería y establezca la propiedad de delegate de FIRMessaging después de llamar a [FIRApp configure] . Por ejemplo, si el delegado de su aplicación se ajusta al protocolo de delegado de mensajería, puede configurar el delegado en application:didFinishLaunchingWithOptions: para sí mismo.

Messaging.messaging().delegate = self

[FIRMessaging messaging].delegate = self;

Obtener el token de registro actual

Los tokens de registro se entregan mediante el método messaging:didReceiveRegistrationToken: . Este método se llama generalmente una vez por inicio de aplicación con token de registro. Cuando se llama a este método, es el momento ideal para:

• Si el token de registro es nuevo, envíelo a su servidor de aplicaciones.
• Suscriba el token de registro a los temas. Esto es necesario solo para suscripciones nuevas o para situaciones en las que el usuario ha reinstalado la aplicación.

Puede recuperar el token directamente usando token(completion:) . Se proporciona un error no nulo si la recuperación del token falla de alguna manera.

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching FCM registration token: \(error)")
  } else if let token = token {
    print("FCM registration token: \(token)")
    self.fcmRegTokenMessage.text  = "Remote FCM registration token: \(token)"
  }
}

[[FIRMessaging messaging] tokenWithCompletion:^(NSString *token, NSError *error) {
  if (error != nil) {
    NSLog(@"Error getting FCM registration token: %@", error);
  } else {
    NSLog(@"FCM registration token: %@", token);
    self.fcmRegTokenMessage.text = token;
  }
}];

Puede usar este método en cualquier momento para acceder al token en lugar de almacenarlo.

Supervisar la actualización del token

Para recibir una notificación cada vez que se actualice el token, proporcione un delegado que cumpla con el protocolo de delegado de mensajería. El siguiente ejemplo registra el delegado y agrega el método de delegado adecuado:

func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
  print("Firebase registration token: \(String(describing: fcmToken))")

  let dataDict: [String: String] = ["token": fcmToken ?? ""]
  NotificationCenter.default.post(
    name: Notification.Name("FCMToken"),
    object: nil,
    userInfo: dataDict
  )
  // TODO: If necessary send token to application server.
  // Note: This callback is fired at each app startup and whenever a new token is generated.
}
AppDelegate.swift

- (void)messaging:(FIRMessaging *)messaging didReceiveRegistrationToken:(NSString *)fcmToken {
    NSLog(@"FCM registration token: %@", fcmToken);
    // Notify about received token.
    NSDictionary *dataDict = [NSDictionary dictionaryWithObject:fcmToken forKey:@"token"];
    [[NSNotificationCenter defaultCenter] postNotificationName:
     @"FCMToken" object:nil userInfo:dataDict];
    // TODO: If necessary send token to application server.
    // Note: This callback is fired at each app startup and whenever a new token is generated.
}
AppDelegate.m

Como alternativa, puede escuchar una NSNotification denominada kFIRMessagingRegistrationTokenRefreshNotification en lugar de proporcionar un método de delegado. La propiedad del token siempre tiene el valor del token actual.

Swizzling deshabilitado: mapeo de su token APN y token de registro

Si ha deshabilitado el método swizzling o está creando una aplicación SwiftUI, deberá asignar explícitamente su token de APN al token de registro de FCM. Implemente el método application(_:didRegisterForRemoteNotificationsWithDeviceToken:) para recuperar el token de APN y luego configure la propiedad apnsToken de Messaging :

func application(application: UIApplication,
                 didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
  Messaging.messaging().apnsToken = deviceToken
}

// With "FirebaseAppDelegateProxyEnabled": NO
- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [FIRMessaging messaging].APNSToken = deviceToken;
}

Una vez que se genera el token de registro de FCM, puede acceder a él y escuchar los eventos de actualización utilizando los mismos métodos que con swizzling habilitado.

Evitar la inicialización automática

Cuando se genera un token de registro de FCM, la biblioteca carga el identificador y los datos de configuración en Firebase. Si primero desea obtener una suscripción explícita de los usuarios, puede evitar la generación de tokens en el momento de la configuración al deshabilitar FCM. Para hacer esto, agregue un valor de metadatos a su Info.plist (no a su GoogleService-Info.plist ):

FirebaseMessagingAutoInitEnabled = NO

Para volver a habilitar FCM, puede realizar una llamada en tiempo de ejecución:

Messaging.messaging().autoInitEnabled = true

[FIRMessaging messaging].autoInitEnabled = YES;

Este valor persiste a través de los reinicios de la aplicación una vez establecido.

Próximos pasos

Una vez que haya configurado su cliente de Apple, estará listo para agregar el manejo de mensajes y otros comportamientos más avanzados a su aplicación. Consulte estas guías para obtener más información:

• Recibir mensajes en una aplicación de Apple
• Enviar mensajes de tema
• Enviar a grupos de dispositivos