Configura una app cliente de Firebase Cloud Messaging en Android

A fin de escribir tu app cliente para Android de Firebase Cloud Messaging, usa la API de FirebaseMessaging, y Android Studio 1.4 o una versión más reciente con Gradle. Las instrucciones que se brindan en esta página suponen que llevaste a cabo los pasos para agregar Firebase a tu proyecto de Android.

Los clientes de FCM deben tener dispositivos con Android 4.1 o una versión más reciente que también tenga la app Google Play Store instalada o un emulador que ejecute Android 4.1 con las API de Google. Ten en cuenta que no estás limitado a implementar las apps para Android a través de Google Play Store.

Configura Firebase y el SDK de FCM

1. Si aún no lo hiciste, agrega Firebase a tu proyecto de Android.

2. En Android Studio, agrega la dependencia de FCM al archivo build.gradle de nivel de tu app:

   implementation 'com.google.firebase:firebase-messaging:17.3.4'
   

Edita el manifiesto de tu app

Agrega lo siguiente al manifiesto de tu app:

• Un servicio que extienda FirebaseMessagingService. Esto es obligatorio si deseas tener administrar los mensajes además de recibir notificaciones en apps en segundo plano. Para recibir notificaciones en apps en primer plano, recibir la carga útil de datos y enviar mensajes ascendentes, etc., debes extender este servicio.

<service android:name=".java.MyFirebaseMessagingService">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>
AndroidManifest.xml

• (Opcional) Dentro del componente de la aplicación, elementos de metadatos para configurar el ícono y el color predeterminados de la notificación. Android usa estos valores cada vez que los mensajes entrantes no tienen un ícono ni un color configurado de manera explícita.

<!-- Set custom default icon. This is used when no icon is set for incoming notification messages.
     See README(https://goo.gl/l4GJaQ) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_icon"
    android:resource="@drawable/ic_stat_ic_notification" />
<!-- Set color used with incoming notification messages. This is used when no color is set for the incoming
     notification message. See README(https://goo.gl/6BKBk7) for more. -->
<meta-data
    android:name="com.google.firebase.messaging.default_notification_color"
    android:resource="@color/colorAccent" />
AndroidManifest.xml

• (Opcional) A partir de Android 8.0 (nivel de API 26) y versiones más recientes, los canales de notificación se admiten y se recomiendan. FCM proporciona un canal de notificación predeterminado con configuración básica. Si prefieres crear y usar tu propio canal predeterminado, configura default_notification_channel_id con el ID de tu objeto de canal de notificación, como se muestra en el ejemplo. FCM usará este valor cada vez que los mensajes entrantes no tengan configurado un canal de notificación de manera explícita. Para obtener más información, consulta Administrar canales de notificación.

<meta-data
    android:name="com.google.firebase.messaging.default_notification_channel_id"
    android:value="@string/default_notification_channel_id" />
AndroidManifest.xml

Accede al token de registro de dispositivo

Cuando se inicia tu app por primera vez, el SDK de FCM genera un token de registro para la instancia de la app cliente. Si quieres orientar mensajes a dispositivos individuales o crear grupos de dispositivos, tendrás que extender FirebaseMessagingService y anular onNewToken para acceder a este token.

Esta sección describe cómo recuperar el token y cómo supervisar los cambios que lo afectan. Debido a que el token se puede rotar después del primer inicio, te recomendamos enfáticamente que recuperes el token de registro con la actualización más reciente.

El token de registro puede cambiar en las siguientes situaciones:

• La app borra un ID de instancia.
• 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.

Recupera el token de registro actual

Cuando necesites recuperar el token actual, llama a FirebaseInstanceId.getInstance().getInstanceId():

FirebaseInstanceId.getInstance().getInstanceId()
        .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
            @Override
            public void onComplete(@NonNull Task<InstanceIdResult> task) {
                if (!task.isSuccessful()) {
                    Log.w(TAG, "getInstanceId failed", task.getException());
                    return;
                }

                // Get new Instance ID token
                String token = task.getResult().getToken();

                // Log and toast
                String msg = getString(R.string.msg_token_fmt, token);
                Log.d(TAG, msg);
                Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
            }
        });
MainActivity.java

FirebaseInstanceId.getInstance().instanceId
        .addOnCompleteListener(OnCompleteListener { task ->
            if (!task.isSuccessful) {
                Log.w(TAG, "getInstanceId failed", task.exception)
                return@OnCompleteListener
            }

            // Get new Instance ID token
            val token = task.result?.token

            // Log and toast
            val msg = getString(R.string.msg_token_fmt, token)
            Log.d(TAG, msg)
            Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
        })
MainActivity.kt

Supervisa la generación de tokens

La devolución de llamada de onNewToken se activa cuando se genera un token nuevo.

/**
 * Called if InstanceID token is updated. This may occur if the security of
 * the previous token had been compromised. Note that this is called when the InstanceID token
 * is initially generated so this is where you would retrieve the token.
 */
@Override
public void onNewToken(String token) {
    Log.d(TAG, "Refreshed token: " + token);

    // If you want to send messages to this application instance or
    // manage this apps subscriptions on the server side, send the
    // Instance ID token to your app server.
    sendRegistrationToServer(token);
}
MyFirebaseMessagingService.java

/**
 * Called if InstanceID token is updated. This may occur if the security of
 * the previous token had been compromised. Note that this is called when the InstanceID token
 * is initially generated so this is where you would retrieve the token.
 */
override fun onNewToken(token: String?) {
    Log.d(TAG, "Refreshed token: $token")

    // If you want to send messages to this application instance or
    // manage this apps subscriptions on the server side, send the
    // Instance ID token to your app server.
    sendRegistrationToServer(token)
}
MyFirebaseMessagingService.kt

Después de obtener el token, puedes enviarlo a tu servidor de apps y almacenarlo con tu método preferido. Consulta la referencia de ID de instancia de la API para ver los detalles completos sobre la API.

Verificación de los Servicios de Google Play

Las apps que usan el SDK de los servicios de Play siempre deben revisar el dispositivo para buscar un APK de servicios de Google Play compatible antes de acceder a las funciones de los servicios de Google Play. Se recomienda hacer esto en dos lugares: en el método onCreate() de la actividad principal y en su método onResume(). La verificación de onCreate() garantiza que la app no se pueda usar sin una verificación correcta. La verificación de onResume() garantiza, que si el usuario vuelve a la app en ejecución de alguna otra forma (por ejemplo, con el botón Atrás), la verificación se ejecute de todas formas.

Si el dispositivo no tiene una versión compatible de los Servicios de Google Play, tu app puede llamar a GoogleApiAvailability.makeGooglePlayServicesAvailable() para permitir que los usuarios los descarguen desde la Play Store.

Evita la inicialización automática

Firebase genera un ID de instancia. FCM lo utiliza para obtener un token de registro, y Analytics lo utiliza para recopilar datos. Cuando se genera un ID de instancia, la biblioteca sube el identificador y los datos de configuración a Firebase. Si deseas evitar la autogeneración de ID de instancia, inhabilita la inicialización automática para FCM y Analytics (es necesario inhabilitarla en ambos). Para ello, agrega estos valores de metadatos a AndroidManifest.xml:

<meta-data
    android:name="firebase_messaging_auto_init_enabled"
    android:value="false" />
<meta-data
    android:name="firebase_analytics_collection_enabled"
    android:value="false" />
AndroidManifest.xml

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

FirebaseMessaging.getInstance().setAutoInitEnabled(true);
MainActivity.java

FirebaseMessaging.getInstance().isAutoInitEnabled = true
MainActivity.kt

Próximos pasos

Cuando la app cliente esté configurada, estarás listo para comenzar a enviar mensajes descendentes con el compositor de Notifications. Esta función se presenta en la muestra de inicio rápido, que puedes descargar, ejecutar y revisar.

Para agregar otro comportamiento más avanzado a tu app, puedes declarar un filtro de intent e implementar una actividad para responder a los mensajes entrantes. Para obtener información detallada, consulta las guías que explican cómo enviar mensajes desde un servidor de app.

• Cómo enviar mensajes de tema
• Cómo enviar a grupos de dispositivos
• Cómo enviar mensajes ascendentes

Ten en cuenta que, para aprovechar estas funciones, necesitarás una implementación de servidor y los protocolos del servidor (HTTP o XMPP), o una implementación del SDK de Admin.