Comienza a usar mensajes desde la app de Firebase

En esta guía de inicio rápido, verás cómo configurar mensajes desde la app de Firebase y enviar tu primer mensaje.

Antes de comenzar

Antes de comenzar, debes configurar lo siguiente en el entorno:

  • Una app con Firebase habilitado: Si todavía no lo hiciste, agrega Firebase a tu proyecto de iOS.
  • Xcode 10.3 o versión superior: mensajes desde la app de Firebase requiere una versión relativamente reciente de Xcode para ejecutarse. Puedes encontrar la versión más reciente de Xcode en el sitio de Xcode de Apple.
  • CocoaPods 1.4.0 o una versión superior: mensajes desde la app de Firebase usa CocoaPods para administrar las dependencias en iOS. Puedes instalarlo desde el sitio de CocoaPods.

Agrega el SDK de mensajes desde la app de Firebase a tu proyecto

Para comenzar, agrega los archivos del framework del SDK de mensajes desde la app de Firebase. Para ello, agrega el CocoaPods de mensajes desde la app con estos pasos:

  1. Abre una nueva ventana de terminal y navega hasta el directorio del proyecto de Xcode.
  2. Abre tu Podfile y agrega las líneas destacadas:
    # Uncomment the next line to define a global platform for your project
    # platform :ios, '9.0'
    
    target 'YourProject' do
    # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
    use_frameworks!
    
    # Pods for YourProject
    pod 'Firebase'
    pod 'Firebase/InAppMessaging'
    pod 'Firebase/Analytics'
    end
  3. Desde tu terminal, instala las dependencias del pod:
    pod install
  4. Abre el proyecto de tu app en Xcode:
    open YOUR-PROJECT.xcworkspace
  5. Importa el módulo de Firebase en tu UIApplicationDelegate, si aún no lo has hecho:
    Swift
    import Firebase
    Objective‑C
    @import Firebase;
  6. Además, si no lo has hecho, 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];
  7. Compila y ejecuta tu app.

Envía un mensaje de prueba

Obtén el ID de instalación de tu app

Para conservar la potencia, mensajes desde la app de Firebase solo recupera los mensajes desde el servidor una vez al día. Esta acción puede dificultar las pruebas, de manera que Firebase console te permite especificar un dispositivo de prueba que muestra mensajes a pedido.

Ese dispositivo de prueba se determina mediante un ID de instalación que proporciona el servicio de instalaciones de Firebase. Para encontrar el ID de instalación de tu app de prueba, ejecuta la app con el argumento del comando del entorno de ejecución -FIRDebugEnabled:

  1. Con el proyecto de Xcode abierto, selecciona Producto > Esquema > Editar esquema en la barra de menú superior.
  2. Abre la pestaña Argumentos en el cuadro de diálogo emergente.
  3. Haz clic en + Agregar artículos en Argumentos pasados al inicio.
  4. Escribe “-FIRDebugEnabled” en el campo que acabas de crear.
  5. Haz clic en Cerrar y ejecuta la app.

Cuando la app se abra, busca la siguiente línea en los registros de la consola de Xcode:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_APP_ID

Envía un mensaje a tu dispositivo de prueba

Una vez que hayas iniciado tu app en el dispositivo de prueba y tengas su ID de instalación de Firebase (FID), puedes probar la configuración de mensajes desde la app de Firebase enviando un mensaje de prueba:

  1. En Firebase console, abre mensajes desde la app.
  2. Una vez allí, haz clic en Campaña nueva.
  3. Ingresa un Título para tu primer mensaje.
  4. Haz clic en Probar en tu dispositivo.
  5. Ingresa el ID de instalación de Firebase de tu app en el campo Agregar un ID de instalación.
  6. Haz clic en Probar para enviar el mensaje.

Mensajes desde la app de Firebase envía el mensaje de prueba apenas haces clic en Probar. Para verlo, cierra y vuelve a abrir la app en el dispositivo de prueba.

Para confirmar si el dispositivo es de prueba, busca el siguiente mensaje de registro:

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.