Esta página se ha traducido con Cloud Translation API.

Utilice FCM y FIAM para enviar mensajes a los usuarios

1. Antes de comenzar

En este codelab, aprenderá cómo agregar la capacidad de interactuar con los usuarios, ya sea que estén usando su aplicación en primer plano o en segundo plano.

Requisitos previos

Ninguno

lo que aprenderás

Agrega Firebase a tu aplicación de Android
Agregar dependencias FCM y FIAM
Envíe un mensaje FCM de prueba a su aplicación
Envía mensaje FIAM de prueba a tu aplicación

Lo que necesitarás

Estudio Android 4.1
Dispositivo Android o emulador

2. Empieza

Obtenga el código de muestra

Clona el repositorio de GitHub desde la línea de comando:

Importar la aplicación de inicio

Desde Android Studio, seleccione el directorio codelab-fcm-and-fiam ( ). Sería el clonado en el paso anterior ( Archivo > Abrir > .../codelab-fcm-and-fiam).

Ahora deberías tener el proyecto FcmAndFiam abierto en Android Studio. Si ve una advertencia sobre la falta de un archivo google-services.json, no se preocupe. Se agregará en el siguiente paso.

3. Crear proyecto de consola Firebase

Agregar Firebase al proyecto

Vaya a la consola de Firebase .
Seleccione Agregar proyecto .
Seleccione o ingrese un nombre de proyecto.
Siga los pasos de configuración restantes en Firebase console, luego haga clic en Crear proyecto (o Agregar Firebase, si está utilizando un proyecto de Google existente).
Desde la pantalla de descripción general de su nuevo proyecto, haga clic en el ícono de Android para iniciar el flujo de trabajo de configuración.
Ingrese el nombre del paquete del codelab: com.google.firebase.codelab.fcmandfiam

Agregue el archivo google-services.json a su aplicación

Después de agregar el nombre del paquete, haga clic en Registrar aplicación y luego en Descargar google-services.json para obtener su archivo de configuración de Firebase Android y luego copie el archivo google-services.json en el directorio de la app en su proyecto. Después de descargar el archivo, puede hacer clic en Omitir para ver los siguientes pasos que se muestran en la consola (ya se realizaron en el proyecto build-android-start).

Agregue el complemento de servicios de Google a su aplicación

El complemento de servicios de Google utiliza el archivo google-services.json para configurar su aplicación para que use Firebase. La dependencia del complemento de servicios de Google y el complemento en sí ya deberían agregarse a los archivos de compilación a nivel de proyecto y aplicación, respectivamente. Confirme las siguientes entradas:

construir.gradle

buildscript {
  ...
  dependencies {
    ...
    classpath 'com.google.gms:google-services:4.3.8'
  }
}

aplicación/build.gradle

plugins {
  ...
  id: 'com.google.gms.google-services'
}

Agregar dependencias

FCM y FIAM requieren las siguientes dependencias. Estas dependencias ya deberían agregarse al archivo de compilación a nivel de aplicación. Confirme que se agreguen las siguientes dependencias:

aplicación/build.gradle

dependencies {
  ...
  implementation platform('com.google.firebase:firebase-bom:28.4.2')
  implementation 'com.google.firebase:firebase-analytics'
  implementation 'com.google.firebase:firebase-messaging'
  implementation 'com.google.firebase:firebase-inappmessaging-display'
}

Sincroniza tu proyecto con archivos gradle

Para asegurarse de que todas las dependencias estén disponibles para su aplicación, debe sincronizar su proyecto con los archivos gradle en este punto. Seleccione Archivo > Sincronizar proyecto con archivos Gradle en la barra de herramientas de Android Studio.

4. Identificadores de registro

Firebase Cloud Messaging y Firebase In App Messaging utilizan identificadores para enviar mensajes a aplicaciones. FCM usa un token de registro y FIAM usa una ID de instalación.

En MainActivity.kt reemplace TODO con el siguiente código para registrar los identificadores necesarios para enviar mensajes:

FirebaseMessaging.getInstance().token.addOnCompleteListener { regTokenTask ->
   if (regTokenTask.isSuccessful) {
       Log.d(TAG, "FCM registration token: ${regTokenTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve registration token",
           regTokenTask.exception)
   }
}
FirebaseInstallations.getInstance().id.addOnCompleteListener { installationIdTask ->
   if (installationIdTask.isSuccessful) {
       Log.d(TAG, "Firebase Installations ID: ${installationIdTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve installations ID",
           installationIdTask.exception)
   }
}

Conecte su dispositivo Android y haga clic en Ejecutar ( )en la barra de herramientas de Android Studio. Al tocar el botón Registrar identificadores , se registrará el token de registro de FCM y el ID de instalación de Firebase en logcat. La salida debería verse así:

D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. Enviar mensaje FCM de prueba

Los mensajes de FCM se pueden enviar tanto desde Firebase console como desde la API REST de FCM. En este codelab redactaremos un mensaje de notificación de FCM y lo enviaremos a nuestro dispositivo. Los mensajes de notificación son aquellos que se muestran en el área de notificación del sistema. Envíe un mensaje FCM de prueba mediante:

Asegúrese de que la aplicación esté en segundo plano (vaya a la pantalla de inicio)
Vaya a Firebase console y seleccione Cloud Messaging en la navegación izquierda
Seleccione Enviar su primer mensaje
Agregue un título y un cuerpo para el mensaje, luego haga clic en Enviar mensaje de prueba.

Agregue el token de registro de FCM y luego haga clic en probar

Observar la notificación en pantalla en el dispositivo
Al tocar la notificación se abre la aplicación.

6. Enviar mensaje FIAM de prueba

Firebase In App Messaging se puede activar como resultado de una variedad de eventos de usuario. El mensaje de prueba utiliza el evento de apertura de la aplicación para activar el mensaje en la aplicación. Envíe un mensaje FIAM de prueba por:

Asegúrese de que la aplicación esté en segundo plano (vaya a la pantalla de inicio)
Vaya a Firebase console y seleccione Mensajería dentro de la aplicación en la navegación izquierda
Selecciona Crea tu primera campaña.
Seleccione la campaña de banner principal e ingrese el título y el cuerpo del mensaje.
Haga clic en Probar en el dispositivo

Agregue ID de instalaciones y haga clic en Probar

Reabrir aplicación
Observar en el mensaje de la aplicación

7. Felicitaciones

Felicitaciones, ha enviado correctamente mensajes FCM y FIAM. Ahora sabe cómo interactuar con sus usuarios, ya sea que estén usando su aplicación en primer plano o en segundo plano.

Otras lecturas

Que sigue

Envía mensajes a los usuarios en tu propia aplicación de Android.