Configura una app cliente de Firebase Cloud Messaging en iOS

Para apps cliente iOS, puedes implementar Firebase Cloud Messaging de dos formas complementarias:

Recibir mensajes push básicos de hasta 4 KB en la interfaz de APNS de Firebase Cloud Messaging
Enviar mensajes ascendentes o recibir cargas de datos descendentes de hasta 4 KB en apps ubicadas en primer plano

Para escribir tu código de cliente en Objective-C o Swift, te recomendamos que uses la API de FIRMessaging. En el ejemplo de inicio rápido, se proporciona código de muestra para ambos lenguajes.

Referencias de método en Firebase Cloud Messaging

El SDK de FCM ejecuta la referencia de métodos en dos áreas clave: la asignación de tu token de APNS al token de registro de FCM y la captura de los datos de estadísticas durante el manejo de la devolución de llamada de los mensajes descendentes. Los programadores que prefieren no usar las referencias, pueden inhabilitarlas. Para ello, se debe agregar la marca FirebaseAppDelegateProxyEnabled en el archivo Info.plist de la app y configurarla en NO (valor booleano). Las áreas relevantes de las guías proporcionan ejemplos de código con las referencias de métodos inhabilitadas y habilitadas.

Agrega Firebase a tu proyecto de iOS

Es posible que hayas completado tareas que aparecen en esta sección si ya habilitaste otras funciones de Firebase para tu app. En el caso de FCM, deberás subir tu clave de autenticación de APNS y registrarte para habilitar las notificaciones remotas.

Requisitos previos

Instala Xcode 10.1 o una versión más reciente.
Instala CocoaPods 1.4.0 o una versión más reciente.
Abre tu proyecto en Xcode.
- Tu proyecto debe orientarse a iOS 8 o una versión más reciente.
- Los proyectos Swift deben usar la versión 3.0 o una más reciente.
Configura un dispositivo iOS físico o un simulador para ejecutar la app.
- Para Cloud Messaging, necesitarás los siguientes elementos:
  - Un dispositivo iOS físico
  - Una clave de autenticación de notificaciones push de Apple para tu cuenta de desarrollador de Apple
  - En Xcode, habilita las notificaciones push en App > Capabilities
- En todos los demás productos de Firebase, puedes usar un dispositivo iOS físico o un simulador.
Accede a Firebase con tu Cuenta de Google.

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

Crea un proyecto de Firebase

A fin de poder agregar Firebase a tu app para iOS, debes crear un proyecto de Firebase y conectarlo a la app. Consulta Información sobre los proyectos de Firebase para obtener detalles acerca del tema.

Crea un proyecto de Firebase

En Firebase console, haz clic en Agregar proyecto y, luego, selecciona o ingresa el Nombre del proyecto.

Si ya tienes un proyecto de Google Cloud Platform (GCP) existente, puedes seleccionarlo del menú desplegable para agregar recursos de Firebase al proyecto.
Si creaste un proyecto nuevo, puedes editar el ID del proyecto (opcional).

Firebase asignará de manera automática un ID único a tu proyecto de Firebase. Consulta la Información sobre los proyectos de Firebase para obtener detalles sobre cómo usa Firebase el ID del proyecto.

Una vez que Firebase aprovisione los recursos para tu proyecto, no podrás cambiar su ID.
Para usar un identificador específico, debes editar el ID del proyecto durante este paso de la configuración.
Haz clic en Continuar.

Configura Google Analytics para tu proyecto (opcional). Esto te permitirá tener una experiencia óptima con cualquiera de los siguientes productos de Firebase:

Selecciona una cuenta de Google Analytics existente o crea una nueva cuando se te solicite.
Si eliges crear una cuenta nueva, selecciona la ubicación de tus informes de Analytics. Luego, acepta la configuración de uso compartido de datos y las condiciones de Google Analytics para tu proyecto.

Haz clic en Crear proyecto (o Agregar Firebase, si usas un proyecto de GCP existente).

Firebase aprovisiona los recursos para tu proyecto de forma automática. Cuando finalice, verás la página de descripción general del proyecto en Firebase console.

Registra tu app en Firebase

Cuando tengas un proyecto de Firebase, podrás agregarle tu app para iOS.

Visita Información sobre los proyectos de Firebase a fin de obtener detalles sobre las recomendaciones y consideraciones para agregar apps a un proyecto de Firebase, incluido cómo manejar diversas variantes de compilación.

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

Si ya agregaste una app a tu proyecto de Firebase, haz clic en Agregar app para que se muestren las opciones de la plataforma.
Ingresa el ID del paquete de la app en el campo ID del paquete de iOS.

Asegúrate de ingresar el ID que usa tu app realmente. No puedes agregar ni modificar este valor después de registrar tu app en el proyecto de Firebase.
- Para encontrar el ID del paquete, abre tu app en Xcode y accede a la pestaña General en el directorio Runner de nivel superior. El valor del campo Bundle Identifier (Identificador de paquete) es el ID del paquete de iOS (por ejemplo, com.yourcompany.yourproject).
Ingresa otra información de la app si el flujo de trabajo de configuración lo solicita (opcional).
- Sobrenombre de la app: Es un identificador interno y conveniente que solo tú puedes ver en Firebase console.
- ID de App Store: Firebase Dynamic Links lo usa para redireccionar a los usuarios a tu página de App Store, y Google Analytics lo usa a fin de importar eventos de conversión a Google Ads. Si tu app aún no tiene ID de App Store, puedes agregarlo más adelante en la Configuración del proyecto.
Haz clic en Registrar app.

Agrega un archivo de configuración de Firebase

Haz clic en Descargar GoogleService-Info.plist a fin de obtener el archivo de configuración de Firebase para iOS (GoogleService-Info.plist).
- Puedes volver a descargar el archivo de configuración de Firebase para iOS cuando quieras.
- Asegúrate de no se hayan agregado caracteres adicionales, como (2), al nombre del archivo de configuración.
Traslada el archivo de configuración al directorio raíz de tu proyecto de Xcode. Si se te solicita, selecciona la opción para agregar el archivo de configuración a todos los destinos.

Si tienes varios ID de paquete en tu proyecto, debes asociar cada uno con una app registrada en Firebase console a fin de que cada app tenga su propio archivo GoogleService-Info.plist.

Agrega los SDK de Firebase a tu app

Te recomendamos que uses CocoaPods para instalar las bibliotecas de Firebase. Si prefieres no usarlo, puedes integrar los marcos de trabajo del SDK directamente.

Ten en cuenta que, si usas una de las muestras de inicio rápido, estas ya contienen el proyecto de Xcode y el Podfile (con pods), pero, de todas formas, debes agregar tu archivo de configuración de Firebase y, luego, instalar los pods.

Puedes agregar cualquiera de los productos de Firebase admitidos a tu app para iOS.

Crea un Podfile si aún no tienes uno:
```
cd your-project-directory
```
```
pod init
```
En tu Podfile, agrega los pods de Firebase que deseas usar en tu app.

Para obtener una experiencia óptima con Firebase Cloud Messaging, recomendamos habilitar Google Analytics en tu proyecto. Debes agregar el SDK de Firebase para Google Analytics a tu app al momento de configurar Google Analytics.
Si Analytics está habilitado
```
# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'

# Add the pod for Firebase Cloud Messaging
pod 'Firebase/Messaging'
```
Si Analytics está inhabilitado
```
# Add the pod for Firebase Cloud Messaging
pod 'Firebase/Messaging'
```
Instala los pods y abre el archivo .xcworkspace para ver el proyecto en Xcode. Puedes hacerlo con los siguientes comandos:
```
pod install
```
```
open your-project.xcworkspace
```

Sube tu clave de autenticación de APNS

Sube la clave de autenticación del APNS a Firebase. Si aún no tienes una, consulta Configura APNS con FCM.

Dentro del proyecto en Firebase console, selecciona el ícono de ajustes, elige Configuración del proyecto y, luego, la pestaña Cloud Messaging.
En Clave de autenticación de APNS, en Configuración de app para iOS, haz clic en el botón Subir.
Busca la ubicación en la que guardaste la clave, selecciónala y haz clic en Abrir. Agrega el ID de clave correspondiente (disponible en Certificados, identificadores y perfiles en el Centro de miembros desarrolladores de Apple) y haz clic en Subir.

Inicializa Firebase en tu app

Debes agregar el código de inicialización de Firebase a tu aplicación. Importa el módulo de Firebase y configura una instancia compartida de la siguiente manera:

Importa el módulo de Firebase en tu UIApplicationDelegate:
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de tu app:
Swift
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Objective-C
```
// Use Firebase library to configure APIs
[FIRApp configure];
```

Regístrate para habilitar las notificaciones remotas

Durante el inicio o en el punto que desees del flujo de tu aplicación, registra tu app para habilitar las notificaciones remotas. Llama a registerForRemoteNotifications de la siguiente manera:

Swift

if #available(iOS 10.0, *) {
  // For iOS 10 display notification (sent via APNS)
  UNUserNotificationCenter.current().delegate = self

  let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
  UNUserNotificationCenter.current().requestAuthorization(
    options: authOptions,
    completionHandler: {_, _ in })
} else {
  let settings: UIUserNotificationSettings =
  UIUserNotificationSettings(types: [.alert, .badge, .sound], categories: nil)
  application.registerUserNotificationSettings(settings)
}

application.registerForRemoteNotifications()
AppDelegate.swift

Objective-C

if ([UNUserNotificationCenter class] != nil) {
  // iOS 10 or later
  // For iOS 10 display notification (sent via APNS)
  [UNUserNotificationCenter currentNotificationCenter].delegate = self;
  UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert |
      UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
  [[UNUserNotificationCenter currentNotificationCenter]
      requestAuthorizationWithOptions:authOptions
      completionHandler:^(BOOL granted, NSError * _Nullable error) {
        // ...
      }];
} else {
  // iOS 10 notifications aren't available; fall back to iOS 8-9 notifications.
  UIUserNotificationType allNotificationTypes =
  (UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge);
  UIUserNotificationSettings *settings =
  [UIUserNotificationSettings settingsForTypes:allNotificationTypes categories:nil];
  [application registerUserNotificationSettings:settings];
}

[application registerForRemoteNotifications];AppDelegate.m

Para los dispositivos que ejecutan iOS 10 o una versión más reciente, debes asignar la propiedad delegate de UNUserNotificationCenter y la propiedad delegate de FIRMessaging. Por ejemplo, en una app para iOS, asígnalas en los métodos applicationWillFinishLaunchingWithOptions: o applicationDidFinishLaunchingWithOptions: del delegado de la app.

Accede al token de registro

De forma predeterminada, el SDK de FCM genera un token de registro para la instancia de app del cliente en el inicio de tu app. Al igual que el token de dispositivo de APNS, este token te permite enviar notificaciones orientadas a cualquier instancia específica de tu app.

De la misma manera que iOS suele enviar un token de dispositivo APNS en el inicio de la app, FCM proporciona un token de registro a través del método FIRMessagingDelegate de messaging:didReceiveRegistrationToken:. El SDK de FCM recupera un token nuevo o uno existente durante el lanzamiento inicial de la app y cada vez que el token se actualiza o se invalida. En todos los casos, el SDK de FCM llama a messaging:didReceiveRegistrationToken: con un token válido.

El token de registro puede cambiar en las siguientes situaciones:

La app se restablece en un dispositivo nuevo.
El usuario desinstala y vuelve a instalar la app.
El usuario borra los datos de la app.

Configura el delegado de mensajería

Para recibir tokens de registro, implementa el protocolo de delegado de mensajería y configura la propiedad FIRMessaging de delegate después de llamar a [FIRApp configure]. Por ejemplo, si el delegado de tu aplicación sigue el protocolo de delegado de mensajería, puedes configurarlo en el mismo método application:didFinishLaunchingWithOptions:.

Swift

Messaging.messaging().delegate = self

Objective-C

[FIRMessaging messaging].delegate = self;

Cómo recuperar el token de registro actual

Los tokens de registro se envían a través del método messaging:didReceiveRegistrationToken:. Por lo general, se llama a este método una sola vez cuando se inicia la app con un token de registro. Cuando se lo llama, es el momento ideal para lo siguiente:

Enviarlo al servidor de tu aplicación (si el token de registro es nuevo)
Suscribir el token de registro a temas (esto solo es necesario para las suscripciones nuevas o para los casos en que el usuario volvió a instalar la app)

Para recuperar este token directamente, usa instanceIDWithHandler:. Esta devolución de llamada proporciona un InstanceIDResult, que contiene el token. Si la recuperación de InstanceID falla de cualquier manera, se genera un error que no es nulo.

Swift

InstanceID.instanceID().instanceID { (result, error) in
  if let error = error {
    print("Error fetching remote instance ID: \(error)")
  } else if let result = result {
    print("Remote instance ID token: \(result.token)")
    self.instanceIDTokenMessage.text  = "Remote InstanceID token: \(result.token)"
  }
}

Objective-C

[[FIRInstanceID instanceID] instanceIDWithHandler:^(FIRInstanceIDResult * _Nullable result,
                                                    NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"Error fetching remote instance ID: %@", error);
  } else {
    NSLog(@"Remote instance ID token: %@", result.token);
    NSString* message =
      [NSString stringWithFormat:@"Remote InstanceID token: %@", result.token];
    self.instanceIDTokenMessage.text = message;
  }
}];

Por lo general, el token está disponible de manera local, por lo que este método no abre una conexión de red. Puedes usarlo en cualquier momento para acceder al token en lugar de almacenarlo.

Evita llamar a .getToken(authorizedEntity,scope) a menos que sea necesario habilitar varios remitentes. En su lugar, usa instanceIDWithHandler:.

Supervisa la actualización de tokens

Para recibir notificaciones cada vez que el token se actualice, proporciona un delegado conforme al protocolo de delegado de mensajería. El siguiente ejemplo registra el delegado y agrega el método de delegado apropiado:

Swift

func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String) {
  print("Firebase registration token: \(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

Objective-C

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

De manera alternativa, puedes escuchar para detectar una NSNotification llamada kFIRMessagingRegistrationTokenRefreshNotification en lugar de proporcionar un método de delegado. La propiedad del token siempre tiene el valor actual del token.

Referencias inhabilitadas: asignación de tu token de APNS y de registro

Si inhabilitaste las referencias de métodos, deberás asignar explícitamente tu token de APNS al token de registro de FCM. Anula los métodos didRegisterForRemoteNotificationsWithDeviceToken para recuperar el token del APNS y, luego, configura la propiedad FIRMessaging de APNSToken:

Swift

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

Objective-C

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

Después de que se genere el token de registro de FCM, puedes acceder al token y escuchar eventos actualizados usando los mismos métodos que con las referencias habilitadas.

Importa tokens de APNS de usuarios existentes

Si tienes una base de usuarios existentes que deseas incorporar a la app de cliente de FCM, usa la API batchImport que proporciona el ID de instancia. Con esta API, puedes importar en masa los tokens de APNS de iOS existentes a FCM y asignarlos a tokens de registros nuevos y válidos.

Evita la inicialización automática

FCM genera un ID de instancia, que se utiliza como token de registro dentro de FCM. Cuando se genera un ID de instancia, la biblioteca sube el identificador y los datos de configuración a Firebase.Si deseas obtener una habilitación explícita antes de usar un ID de instancia, puedes evitar que se genere en el momento de la configuración si inhabilitas FCM. Para hacerlo, agrega un valor de metadatos a tu Info.plist (no a GoogleService-Info.plist):

FirebaseMessagingAutoInitEnabled = NO

Para volver a habilitar FCM, realiza una llamada de tiempo de ejecución:

Swift

Messaging.messaging().autoInitEnabled = true

Objective-C

[FIRMessaging messaging].autoInitEnabled = YES;

Este valor persiste en todos los reinicios de la aplicación una vez establecido.

Próximos pasos

Una vez que hayas configurado tu cliente iOS, puedes agregar el control de los mensajes y otro comportamiento más avanzado a tu app. Consulta estas guías para obtener más información:

Configura una app cliente de Firebase Cloud Messaging en iOS

Referencias de método en Firebase Cloud Messaging

Agrega Firebase a tu proyecto de iOS

Requisitos previos

Crea un proyecto de Firebase

Registra tu app en Firebase

Agrega un archivo de configuración de Firebase

Agrega los SDK de Firebase a tu app

Si Analytics está habilitado

Si Analytics está inhabilitado

Sube tu clave de autenticación de APNS

Inicializa Firebase en tu app

Swift

Objective-C

Swift

Objective-C

Regístrate para habilitar las notificaciones remotas

Swift

Objective-C

Accede al token de registro

Configura el delegado de mensajería

Swift

Objective-C

Cómo recuperar el token de registro actual

Swift

Objective-C

Supervisa la actualización de tokens

Swift

Objective-C

Referencias inhabilitadas: asignación de tu token de APNS y de registro

Swift

Objective-C

Importa tokens de APNS de usuarios existentes

Evita la inicialización automática

Swift

Objective-C

Próximos pasos