Configurar una aplicación cliente de Firebase Cloud Messaging con C++

Para escribir tu aplicación cliente multiplataforma de Firebase Cloud Messaging con C++, usa la API de Firebase Cloud Messaging . El SDK de C++ funciona para plataformas Android y Apple, y se requiere alguna configuración adicional para cada plataforma.

Configurar Firebase y el SDK de FCM

Acceder al token de registro del dispositivo

Al inicializar la biblioteca de Firebase Cloud Messaging, se solicita un token de registro para la instancia de la aplicación cliente. La aplicación recibirá el token con la devolución de llamada OnTokenReceived , que debe definirse en la clase que implementa firebase::messaging::Listener .

Si desea apuntar a ese dispositivo específico, necesitará acceso a este token.

Nota sobre la entrega de mensajes en Android

Cuando la aplicación no se está ejecutando y un usuario toca una notificación, el mensaje, de forma predeterminada, no se enruta a través de las devoluciones de llamada integradas de FCM. En este caso, las cargas de mensajes se reciben a través de un Intent utilizado para iniciar la aplicación. Para que FCM reenvíe estos mensajes entrantes a la devolución de llamada de la biblioteca C++, debe anular el método onNewIntent en su Actividad y pasar el Intent al MessageForwardingService .

import com.google.firebase.messaging.MessageForwardingService;

class MyActivity extends Activity {
  private static final String TAG = "MyActvity";

  @Override
  protected void onNewIntent(Intent intent) {
    Log.d(TAG, "A message was sent to this app while it was in the background.");
    Intent message = new Intent(this, MessageForwardingService.class);
    message.setAction(MessageForwardingService.ACTION_REMOTE_INTENT);
    message.putExtras(intent);
    message.setData(intent.getData());
    // For older versions of Firebase C++ SDK (< 7.1.0), use `startService`.
    // startService(message);
    MessageForwardingService.enqueueWork(this, message);
  }
}

Los mensajes recibidos mientras la aplicación está en segundo plano tienen el contenido de su campo de notificación utilizado para completar la notificación de la bandeja del sistema, pero el contenido de la notificación no se comunicará a FCM. Es decir, Message::notification será nulo.

En resumen:

Manejo de mensajes personalizado en Android

De forma predeterminada, las notificaciones enviadas a la aplicación se pasan a ::firebase::messaging::Listener::OnMessageReceived , pero en algunos casos es posible que desees anular el comportamiento predeterminado. Para hacer esto en Android necesitarás escribir clases personalizadas que extiendan com.google.firebase.messaging.cpp.ListenerService así como actualizar AndroidManifest.xml de tu proyecto.

Anular los métodos ListenerService .

ListenerService es la clase Java que intercepta los mensajes entrantes enviados a la aplicación y los enruta a la biblioteca C++. Cuando la aplicación está en primer plano (o cuando la aplicación está en segundo plano y recibe una carga útil de solo datos), los mensajes pasarán a través de una de las devoluciones de llamada proporcionadas en esta clase. Para agregar un comportamiento personalizado al manejo de mensajes, deberá extender ListenerService predeterminado de FCM:

import com.google.firebase.messaging.cpp.ListenerService;

class MyListenerService extends ListenerService {

Al anular el método ListenerService.onMessageReceived , puede realizar acciones basadas en el objeto RemoteMessage recibido y obtener los datos del mensaje:

@Override
public void onMessageReceived(RemoteMessage message) {
  Log.d(TAG, "A message has been received.");
  // Do additional logic...
  super.onMessageReceived(message);
}

ListenerService también tiene algunos otros métodos que se utilizan con menos frecuencia. Estos también se pueden anular; para obtener más información, consulte la referencia de FirebaseMessagingService .

@Override
public void onDeletedMessages() {
  Log.d(TAG, "Messages have been deleted on the server.");
  // Do additional logic...
  super.onDeletedMessages();
}

@Override
public void onMessageSent(String messageId) {
  Log.d(TAG, "An outgoing message has been sent.");
  // Do additional logic...
  super.onMessageSent(messageId);
}

@Override
public void onSendError(String messageId, Exception exception) {
  Log.d(TAG, "An outgoing message encountered an error.");
  // Do additional logic...
  super.onSendError(messageId, exception);
}

Actualizar AndroidManifest.xml

Una vez que se hayan escrito las clases personalizadas, deben incluirse en AndroidManifest.xml para que surtan efecto. Asegúrese de que el manifiesto incluya las herramientas de combinación declarando el atributo apropiado dentro de la etiqueta <manifest> , así:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.firebase.messaging.cpp.samples"
    xmlns:tools="http://schemas.android.com/tools">

En el archivo firebase_messaging_cpp.aar hay un archivo AndroidManifest.xml que declara ListenerService predeterminado de FCM. Este manifiesto normalmente se combina con el manifiesto específico del proyecto, que es como se puede ejecutar ListenerService . Este ListenerService debe reemplazarse con el servicio de escucha personalizado. Esto se logra eliminando el ListenerService predeterminado y agregando el servicio personalizado, lo que se puede hacer con las siguientes líneas en el archivo AndroidManifest.xml de su proyecto:

<service android:name="com.google.firebase.messaging.cpp.ListenerService"
         tools:node="remove" />

<service android:name="com.google.firebase.messaging.cpp.samples.MyListenerService"
         android:exported="false">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT"/>
  </intent-filter>
</service>

Las nuevas versiones del SDK de Firebase C++ (7.1.0 en adelante) usan JobIntentService , que requiere modificaciones adicionales en el archivo AndroidManifest.xml .

<service android:name="com.google.firebase.messaging.MessageForwardingService"
     android:permission="android.permission.BIND_JOB_SERVICE"
     android:exported="false" >
</service>

Prevenir la inicialización automática

FCM genera un token de registro para la orientación por dispositivo. Cuando se genera un token, la biblioteca carga el identificador y los datos de configuración en Firebase. Si desea obtener una suscripción explícita antes de usar el token, puede evitar su generación en el momento de la configuración desactivando FCM (y en Android, Analytics). Para hacer esto, agregue un valor de metadatos a su Info.plist (no a su GoogleService-Info.plist ) en plataformas Apple, o a su AndroidManifest.xml en Android:

<?xml version="1.0" encoding="utf-8"?>
<application>
  <meta-data android:name="firebase_messaging_auto_init_enabled"
             android:value="false" />
  <meta-data android:name="firebase_analytics_collection_enabled"
             android:value="false" />
</application>

FirebaseMessagingAutoInitEnabled = NO

Para volver a habilitar FCM, puede realizar una llamada en tiempo de ejecución:

::firebase::messaging::SetTokenRegistrationOnInitEnabled(true);

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

Manejo de mensajes con enlaces profundos en Android

FCM permite enviar mensajes que contengan un enlace profundo a su aplicación. Para recibir mensajes que contengan un vínculo profundo, debe agregar un nuevo filtro de intención a la actividad que maneja vínculos profundos para su aplicación. El filtro de intención debería detectar enlaces profundos de su dominio. Si sus mensajes no contienen un enlace profundo, esta configuración no es necesaria. En AndroidManifest.xml:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="http"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="https"/>
</intent-filter>

También es posible especificar un comodín para que el filtro de intención sea más flexible. Por ejemplo:

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="*.example.com" android:scheme="http"/>
  <data android:host="*.example.com" android:scheme="https"/>
</intent-filter>

Cuando los usuarios tocan una notificación que contiene un enlace al esquema y al host que usted especifica, su aplicación iniciará la actividad con este filtro de intención para manejar el enlace.

Próximos pasos

Después de configurar la aplicación cliente, estará listo para enviar mensajes posteriores y temáticos con Firebase. Para obtener más información, vea esta funcionalidad demostrada en el ejemplo de inicio rápido que puede descargar, ejecutar y revisar.

Para agregar otro comportamiento más avanzado a su aplicación, consulte las guías para enviar mensajes desde un servidor de aplicaciones:

• Enviar mensajes temáticos
• Enviar a grupos de dispositivos

Tenga en cuenta que necesitará una implementación de servidor para utilizar estas funciones.