Para comenzar con FCM, cree el caso de uso más simple: envíe 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 configuró una aplicación de cliente de Apple para FCM.
Agregue Firebase a su proyecto de Apple
Esta sección cubre las tareas que puede haber completado si ya habilitó otras funciones de Firebase para su aplicación. Para FCM específicamente, deberá cargar su clave de autenticación de APN y registrarse para recibir notificaciones remotas .
requisitos previos
Instale lo siguiente:
- Xcode 13.3.1 o posterior
Asegúrate de que tu proyecto cumpla con estos requisitos:
- Su proyecto debe apuntar a estas versiones de plataforma o posteriores:
- iOS 11
- mac OS 10.13
- tvOS 12
- reloj OS 6
- Su proyecto debe apuntar a estas versiones de plataforma o posteriores:
Configure un dispositivo Apple físico para ejecutar su aplicación y complete estas tareas:
- Obtenga una clave de autenticación de notificación push de Apple para su cuenta de desarrollador de Apple .
- Habilite las notificaciones automáticas en XCode en Aplicación > Capacidades .
- Inicie sesión en Firebase con su cuenta de Google.
Si aún no tiene un proyecto de Xcode y solo quiere probar un producto de Firebase, puede descargar uno de nuestros ejemplos de inicio rápido .
Crear un proyecto de Firebase
Antes de que pueda agregar Firebase a su aplicación de Apple, debe crear un proyecto de Firebase para conectarse a su aplicación. Visite 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.
Ve a la consola de Firebase .
En el centro de la página de descripción general del proyecto, haga clic en el icono 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.
Ingrese el ID del paquete de su aplicación en el campo ID del paquete .
Un ID de paquete identifica de forma única una aplicación en el ecosistema de Apple.
Encuentre su ID de paquete: abra su proyecto en Xcode, seleccione la aplicación de nivel superior en el navegador de proyectos, luego seleccione la pestaña General .
El valor del campo Identificador de paquete es el ID del paquete (por ejemplo,
com.yourcompany.yourproject
).Tenga en cuenta que el valor del ID del paquete distingue entre mayúsculas y minúsculas y no se puede cambiar para esta aplicación de Firebase después de que se haya registrado con su proyecto de Firebase.
(Opcional) Ingrese otra información de la aplicación: apodo de la aplicación e ID de la tienda de aplicaciones.
Apodo de la aplicación : un identificador de conveniencia interno que solo es visible para usted en la consola de Firebase
Id. de App Store : Utilizado por Firebase Dynamic Links para redirigir a los usuarios a su página de App Store y por Google Analytics para importar eventos de conversión a Google Ads . Si su aplicación aún no tiene una ID de App Store, puede agregar la ID más adelante en la configuración de su proyecto .
Haga clic en Registrar aplicación .
Agregar un archivo de configuración de Firebase
Haga clic en Descargar GoogleService-Info.plist para obtener el archivo de configuración de su plataforma Firebase Apple (
GoogleService-Info.plist
).El archivo de configuración de Firebase contiene identificadores únicos, pero no secretos, para su proyecto. Para obtener más información sobre este archivo de configuración, visite Comprender los proyectos de Firebase .
Puede volver a descargar su archivo de configuración de Firebase en cualquier momento.
Asegúrese de que el nombre del archivo de configuración no tenga caracteres adicionales, como
(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 tiene varios ID de paquete en su proyecto, debe asociar cada ID de paquete con una aplicación registrada en la consola de Firebase para que cada aplicación pueda tener su propio archivo GoogleService-Info.plist
.
Agregue los SDK de Firebase a su aplicación
Use Swift Package Manager para instalar y administrar las dependencias de Firebase.
- En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
- Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:
- Elija la biblioteca Firebase Cloud Messaging.
- Para una experiencia óptima con Firebase Cloud Messaging, recomendamos habilitar Google Analytics en su proyecto de Firebase y agregar Firebase SDK para Google Analytics a su aplicación. Puede seleccionar la biblioteca sin colección IDFA o con colección IDFA.
- Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.
https://github.com/firebase/firebase-ios-sdk
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 .
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 .
En la clave de autenticación de APN en la configuración de la aplicación iOS , haga clic en el botón Cargar .
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 .
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:
- Importe el módulo
FirebaseCore
en suUIApplicationDelegate
, así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rápido
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
C objetivo
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure una instancia compartida de
FirebaseApp
en el métodoapplication(_:didFinishLaunchingWithOptions:)
del delegado de su aplicación:SwiftUI
// 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];
- Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de
App
a travésUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .SwiftUI
@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 en el flujo de su aplicación, registre su aplicación para recibir notificaciones remotas. Llame aregisterForRemoteNotifications
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];
Acceder al token de registro
Para enviar un mensaje a un dispositivo específico, debe conocer el token de registro de ese dispositivo. Debido a que deberá ingresar el token en un campo en el editor 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 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.
Rápido
Messaging.messaging().delegate = self
C objetivo
[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.
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 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:
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. }
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.
Enviar un mensaje de notificación
Instale y ejecute la aplicación en el dispositivo de destino. En los dispositivos Apple, deberá aceptar la solicitud de permiso para recibir notificaciones remotas.
Asegúrese de que la aplicación esté en segundo plano en el dispositivo.
En Firebase console, abra la página Mensajería .
Si este es su primer mensaje, seleccione Crear su primera campaña .
- Seleccione Mensajes de notificación de Firebase y seleccione Crear .
De lo contrario, en la pestaña Campañas , seleccione Nueva campaña y luego Notificaciones .
Introduzca el texto del mensaje. Todos los demás campos son opcionales.
Seleccione Enviar mensaje de prueba en el panel derecho.
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.
Seleccione Prueba .
Después de seleccionar Probar , el dispositivo cliente de destino (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: