Enviar un mensaje de prueba a una aplicación de Apple en segundo plano

Para comenzar con FCM, desarrolle el caso de uso más simple: enviar un mensaje de notificación de prueba desde el redactor de notificaciones a un dispositivo de desarrollo cuando la aplicación está en segundo plano en el dispositivo. Esta página enumera todos los pasos para lograr esto, desde la configuración hasta la verificación; puede cubrir los pasos que ya completó si ha configurado una aplicación cliente de Apple para FCM.

Agrega Firebase a tu proyecto de Apple

Esta sección cubre las tareas que puede haber completado si ya habilitó otras funciones de Firebase para su aplicación. Específicamente para FCM, deberá cargar su clave de autenticación de APN y registrarse para recibir notificaciones remotas .

Requisitos previos

  • Instale lo siguiente:

    • Xcode 14.1 o posterior
  • Asegúrese de que su proyecto cumpla con estos requisitos:

    • Su proyecto debe estar orientado a estas versiones de plataforma o posteriores:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • relojOS 6
  • Configure un dispositivo Apple físico para ejecutar su aplicación y complete estas tareas:

    • Obtenga una clave de autenticación de notificaciones push de Apple para su cuenta de desarrollador de Apple .
    • Habilite las notificaciones push en XCode en Aplicación > Capacidades .

Si aún no tienes un proyecto de Xcode y solo quieres probar un producto de Firebase, puedes descargar uno de nuestros ejemplos de inicio rápido .

Crear un proyecto de Firebase

Antes de poder agregar Firebase a su aplicación Apple, debe crear un proyecto de Firebase para conectarse a su aplicación. Visita Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase.

Registra tu aplicación con Firebase

Para usar Firebase en su aplicación de Apple, debe registrar su aplicación con su proyecto de Firebase. Registrar su aplicación a menudo se denomina "agregar" su aplicación a su proyecto.

  1. Vaya a la consola de Firebase .

  2. En el centro de la página de descripción general del proyecto, haga clic en el ícono de iOS+ para iniciar el flujo de trabajo de configuración.

    Si ya agregó una aplicación a su proyecto de Firebase, haga clic en Agregar aplicación para mostrar las opciones de la plataforma.

  3. Ingrese el ID del paquete de su aplicación en el campo ID del paquete .

  4. (Opcional) Ingrese otra información de la aplicación: apodo de la aplicación y ID de la App Store .

  5. Haga clic en Registrar aplicación .

Agregar un archivo de configuración de Firebase

  1. Haga clic en Descargar GoogleService-Info.plist para obtener el archivo de configuración de su plataforma Firebase Apple ( GoogleService-Info.plist ).

  2. Mueva su archivo de configuración a la raíz de su proyecto Xcode. Si se le solicita, seleccione agregar el archivo de configuración a todos los destinos.

Si tienes varios ID de paquete en tu proyecto, debes asociar cada ID de paquete con una aplicación registrada en Firebase console para que cada aplicación pueda tener su propio archivo GoogleService-Info.plist .

Agregue SDK de Firebase a su aplicación

Utilice Swift Package Manager para instalar y administrar las dependencias de Firebase.

  1. En Xcode, con el proyecto de su aplicación abierto, navegue hasta Archivo > Agregar paquetes .
  2. Cuando se le solicite, agregue el repositorio SDK de las plataformas Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Elija la biblioteca Firebase Cloud Messaging.
  5. Agregue el indicador -ObjC a la sección Otros indicadores del vinculador de la configuración de compilación de su objetivo.
  6. Para una experiencia óptima con Firebase Cloud Messaging, recomendamos habilitar Google Analytics en su proyecto de Firebase y agregar el SDK de Firebase para Google Analytics a su aplicación. Puede seleccionar la biblioteca sin colección IDFA o con colección IDFA.
  7. Cuando termine, Xcode comenzará automáticamente a resolver y descargar sus dependencias en segundo plano.

Cargue su clave de autenticación de APN

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 desarrolladores de Apple .

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

  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. Busque la ubicación donde guardó su clave, selecciónela y haga clic en Abrir . Agregue el ID de la clave (disponible en el Centro de miembros desarrolladores de Apple ) y haga clic en Cargar .

Inicializa Firebase en tu aplicación

Deberá agregar el código de inicialización de Firebase a su aplicación. Importe el módulo Firebase y configure una instancia compartida como se muestra:

  1. Importe el módulo FirebaseCore en su UIApplicationDelegate , así como cualquier otro módulo de Firebase que utilice el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:

    Interfaz de usuario rápida

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    C objetivo

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure una instancia compartida FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de su aplicación:

    Interfaz de usuario rápida

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Rápido

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    C objetivo

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Si está utilizando SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura App mediante UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . También debes desactivar el cambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .

    Interfaz de usuario rápida

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          

Regístrese para recibir notificaciones remotas

Ya sea al inicio o en el punto deseado del flujo de su aplicación, registre su aplicación para recibir notificaciones remotas. Llame registerForRemoteNotifications como se muestra:

Rápido


UNUserNotificationCenter.current().delegate = self

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

application.registerForRemoteNotifications()

C objetivo


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

[application registerForRemoteNotifications];

Accede al token de registro

Para enviar un mensaje a un dispositivo específico, necesita conocer el token de registro de ese dispositivo. Debido a que necesitará ingresar el token en un campo en el redactor de notificaciones para completar este tutorial, asegúrese de copiar el token o almacenarlo de forma segura después de recuperarlo.

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 de dispositivo APN, este token le permite enviar notificaciones específicas a cualquier instancia particular de su aplicación.

De la misma manera que las plataformas Apple normalmente entregan un token de dispositivo APN al iniciar la aplicación, FCM proporciona un token de registro a través del método messaging:didReceiveRegistrationToken: de FIRMessagingDelegate . El SDK de FCM recupera un token nuevo o existente durante el inicio 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 podrá 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.

Configurar el delegado de mensajería

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

Rápido

Messaging.messaging().delegate = self

C objetivo

[FIRMessaging messaging].delegate = self;

Obteniendo 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 el 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.
  • Suscribe el token de registro a los temas. Esto solo es necesario 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 falló de alguna manera.

Rápido

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)"
  }
}

C objetivo

[[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 utilizar 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 al delegado y agrega el método de delegado adecuado:

Rápido

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.
}

C objetivo

- (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.
}

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

Enviar un mensaje de notificación

  1. Instale y ejecute la aplicación en el dispositivo de destino. En dispositivos Apple, deberás aceptar la solicitud de permiso para recibir notificaciones remotas.

  2. Asegúrese de que la aplicación esté en segundo plano en el dispositivo.

  3. En Firebase console, abre la página de Mensajería .

  4. Si este es su primer mensaje, seleccione Crear su primera campaña .

    1. Seleccione Mensajes de notificación de Firebase y seleccione Crear .
  5. De lo contrario, en la pestaña Campañas , seleccione Nueva campaña y luego Notificaciones .

  6. Ingrese el texto del mensaje. Todos los demás campos son opcionales.

  7. Seleccione Enviar mensaje de prueba en el panel derecho.

  8. En el campo etiquetado Agregar un token de registro de FCM , ingrese el token de registro que obtuvo en una sección anterior de esta guía.

  9. Seleccione Prueba .

Después de seleccionar Probar , el dispositivo cliente objetivo (con la aplicación en segundo plano) debería recibir la notificación.

Para obtener información sobre la entrega de mensajes a su aplicación, consulte el panel de informes de FCM , que registra la cantidad de mensajes enviados y abiertos en dispositivos Apple y Android, junto con datos de "impresiones" (notificaciones vistas por los usuarios) para aplicaciones de Android.

Próximos pasos

Para ir más allá de los mensajes de notificación y agregar otro comportamiento más avanzado a su aplicación, consulte: