本快速入门介绍了如何在移动和 Web 客户端应用中设置 Firebase Cloud Messaging，以便您能够可靠地发送消息。对于服务器环境，请参阅您的服务器环境和 FCM。

使用 C++ 设置 Firebase Cloud Messaging 客户端应用

如需使用 C++ 编写跨平台 Firebase Cloud Messagingg 客户端应用，请使用 Firebase Cloud Messaging API。C++ SDK 适用于 Android 和 Apple 平台，但需要针对各个平台进行一些额外设置。

设置 Firebase 和 FCM SDK

获取设备注册令牌

初始化 Firebase Cloud Messaging 库时，将为客户端应用实例请求一个注册令牌。应用将通过 OnTokenReceived 回调函数接收令牌，该回调函数应在实现 firebase::messaging::Listener 的类中进行定义。

如果您希望定位该特定设备，就需要获取此令牌。

关于 Android 上的消息传递的注意事项

当应用没有运行而用户点按通知时，默认情况下消息不会通过 FCM 的内置回调进行传递。在这种情况下，消息载荷是通过用于启动应用的 Intent 接收的。如需使 FCM 将这些传入的消息转发到 C++ 库回调，您需要替换 Activity 中的 onNewIntent 方法，并将 Intent 传递给 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);
  }
}

当应用在后台时，用户设备接收到的消息会将其通知字段的内容用于填充系统任务栏通知，但该通知内容并不会传输给 FCM。也就是说，Message::notification 将为空。

总结：

应用状态	通知	数据	两者
前台	OnMessageReceived	OnMessageReceived	OnMessageReceived
后台	系统任务栏	OnMessageReceived	通知：系统任务栏 数据：intent 的 extras 属性。

Android 上的自定义消息处理

默认情况下，发送到应用的通知均传递到 ::firebase::messaging::Listener::OnMessageReceived，但在某些情况下，您可能需要替换默认行为。如需在 Android 上执行此操作，您需要编写用于扩展 com.google.firebase.messaging.cpp.ListenerService 的自定义类，并更新项目的 AndroidManifest.xml。

替换 ListenerService 方法

ListenerService 是用于拦截发送到应用的消息并将它们传递到 C++ 库的 Java 类。当应用处于前台时（或者当应用在后台并收到仅含数据的载荷时），消息将通过此类提供的其中一个回调传递。如需向消息处理添加自定义行为，您需要扩展 FCM 的默认 ListenerService：

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

class MyListenerService extends ListenerService {

通过重写 ListenerService.onMessageReceived 方法，您可以根据收到的 RemoteMessage 对象执行操作并获取消息数据：

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

ListenerService 还有其他一些不太常用的方法。这些方法也可以重写，如需了解详情，请参阅 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);
}

更新 AndroidManifest.xml

编写的自定义类必须包含在 AndroidManifest.xml 中才能生效。通过在 <manifest> 标记中声明适当的特性，确保清单文件包含合并工具，如下所示：

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

在 firebase_messaging_cpp.aar 归档中，有一个声明 FCM 默认 ListenerService 的 AndroidManifest.xml 文件。此清单文件通常与项目特有的清单文件合并，这样 ListenerService 才能够正常运行。此 ListenerService 需要替换为自定义监听器服务。为此，您可以在项目的 AndroidManifest.xml 文件中添加以下几行代码，以移除默认的 ListenerService 并添加自定义服务：

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

新版本的 Firebase C++ SDK（7.1.0 及更高版本）使用 JobIntentService，这需要在 AndroidManifest.xml 文件中进行额外修改。

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

防止自动初始化

FCM 会生成一个用于设备定位的注册令牌。生成令牌时，库会将标识符和配置数据上传到 Firebase。如果您希望在使用令牌之前能够明确地自行选择，则可以通过在配置时停用 FCM（如果是 Android，则还要停用 Analytics）来防止生成该令牌。为此，请向 Apple 平台上的 Info.plist（而不是 GoogleService-Info.plist）或 Android 上的 AndroidManifest.xml 中添加一个元数据值：

如需重新启用 FCM，您可以执行运行时调用：

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

此值一经设置便会持久保存，不受应用重启的影响。

在 Android 上处理包含深层链接的消息

FCM 允许将包含深层链接的消息发送到您的应用中。如需接收包含深层链接的消息，您必须在为应用处理深层链接的 activity 中添加一个新的 intent 过滤器，该 intent 过滤器应能捕获您的网域的深层链接。如果您的消息不包含深层链接，则不需要此配置。在 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>

您也可以指定通配符以使 intent 过滤器更加灵活。例如：

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

当用户点按的通知包含指向您指定的架构和主机的链接时，您的应用将会启动含此 intent 过滤器的 Activity 来处理该链接。

后续步骤

客户端应用设置完成后，您就可以开始接收消息或向用户发送消息：

• 发送主题消息
• 向设备组发送消息