使用 C++ 設置 Firebase 雲消息傳遞客戶端應用

要使用 C++ 編寫跨平台 Firebase Cloud Messaging 客戶端應用程序，請使用Firebase Cloud Messaging API。 C++ SDK 適用於 Android 和 Apple 平台，每個平台都需要一些額外的設置。

設置 Firebase 和 FCM SDK

訪問設備註冊令牌

初始化 Firebase 雲消息傳遞庫後，會為客戶端應用實例請求註冊令牌。應用程序將通過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將為空。

總之：

Android 上的自定義消息處理

默認情況下，發送到應用程序的通知會傳遞給::firebase::messaging::Listener::OnMessageReceived ，但在某些情況下，您可能希望覆蓋默認行為。要在 Android 上執行此操作，您需要編寫自定義類來擴展com.google.firebase.messaging.cpp.ListenerService以及更新項目的AndroidManifest.xml 。

覆蓋ListenerService方法。

ListenerService是一個 Java 類，它攔截發送到應用程序的傳入消息並將它們路由到 C++ 庫。當應用程序在前台時（或者當應用程序在後台並且它接收到僅數據有效負載時），消息將通過此類提供的回調之一。要將自定義行為添加到消息處理中，您需要擴展 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檔案中有一個AndroidManifest.xml文件，它聲明了 FCM 的默認ListenerService 。此清單通常與項目特定清單合併，這是ListenerService能夠運行的方式。此ListenerService需要替換為自定義偵聽器服務。這是通過刪除默認的ListenerService並添加自定義服務來完成的，這可以通過您的項目AndroidManifest.xml文件中的以下幾行來完成：

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

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

要重新啟用 FCM，您可以進行運行時調用：

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

一旦設置，此值將在應用重新啟動後持續存在。

在 Android 上處理帶有深層鏈接的消息

FCM 允許發送包含應用程序深層鏈接的消息。要接收包含深層鏈接的消息，您必須向處理應用程序深層鏈接的活動添加新的意圖過濾器。意圖過濾器應該捕獲您的域的深層鏈接。如果您的消息不包含深層鏈接，則不需要此配置。在 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-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>

當用戶點擊包含指向您指定的方案和主機的鏈接的通知時，您的應用程序將使用此意圖過濾器啟動 Activity 以處理該鏈接。

下一步

設置客戶端應用程序後，您就可以使用 Firebase 發送下游和主題消息了。要了解更多信息，請參閱快速入門示例中演示的此功能，您可以下載、運行和查看該示例。

要向您的應用添加其他更高級的行為，請參閱從應用服務器發送消息的指南：

• 發送主題消息
• 發送到設備組

請記住，您需要一個服務器實現才能使用這些功能。