使用 FCM 和 FIAM 向用户发送消息

1. 准备工作

在此 Codelab 中，您将学习如何添加与用户互动的能力，无论用户是在前台使用您的应用还是在后台使用您的应用。

前提条件

无

学习内容

• 将 Firebase 添加到您的 Android 应用
• 添加 FCM 和 FIAM 依赖项
• 向您的应用发送测试 FCM 消息
• 向您的应用发送测试 FIAM 消息

所需条件

• Android Studio 4.1
• Android 设备或模拟器

2. 开始

获取示例代码

从命令行克隆 GitHub 代码库：

$ git clone https://github.com/FirebaseExtended/codelab-fcm-and-fiam

导入 starter 应用

在 Android Studio 中，选择 codelab-fcm-and-fiam 目录 ()。该目录就是在上一步中克隆的目录（依次选择 File > Open > .../codelab-fcm-and-fiam）。

现在，您应当在 Android Studio 中打开 FcmAndFiam 项目。如果您看到有关 google-services.json 文件缺失的警告，请不要担心。我们将在下一步中添加该信息。

3. 创建 Firebase 控制台项目

将 Firebase 添加到项目

1. 前往 Firebase 控制台。
2. 选择添加项目。
3. 选择或输入项目名称。
4. 在 Firebase 控制台中完成剩下的设置步骤，然后点击创建项目（如果您使用的是现有 Google 项目，则点击“添加 Firebase”）。
5. 在新项目的概览屏幕中，点击 Android 图标以启动设置工作流。
6. 输入此 Codelab 的软件包名称：com.google.firebase.codelab.fcmandfiam

将 google-services.json 文件添加到您的应用中

添加软件包名称后，点击注册应用，然后下载 google-services.json 以获取 Firebase Android 配置文件，然后将 google-services.json 文件复制到项目的 app 目录中。下载文件后，您可以点击跳过，以跳过控制台中显示的后续步骤（这些步骤已在 build-android-start 项目中为您完成）。

将 google-services 插件添加到您的应用

google-services 插件使用 google-services.json 文件对您的应用进行配置以使用 Firebase。google-services 插件依赖项和插件本身应已分别添加到项目级和应用级 build 文件中。确认以下条目：

build.gradle

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

app/build.gradle

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

添加依赖项

FCM 和 FIAM 需要以下依赖项。这些依赖项应已添加到应用级 build 文件中。确认已添加以下依赖项：

app/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'
}

将您的项目与 Gradle 文件同步

为确保您的应用拥有所有依赖项，此时您应该将项目与 Gradle 文件同步。选择文件 >Sync Project with Gradle Files 菜单。

4. 日志标识符

Firebase Cloud Messaging 和 Firebase In App Messaging 均使用标识符向应用发送消息。FCM 使用注册令牌，而 FIAM 使用安装 ID。

1. 在 MainActivity.kt 中，将 TODO 替换为以下代码，以记录发送消息所需的标识符：

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

2. 连接您的 Android 设备，然后点击 Android Studio 工具栏中的 Run ( )。点按 Log Identifiers（日志标识符）按钮会将 FCM 注册令牌和 Firebase 安装 ID 记录到 logcat 中。输出应如下所示：

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

5. 发送测试 FCM 消息

FCM 消息可以通过 Firebase 控制台和 FCM REST API 发送。在此 Codelab 中，我们将撰写 FCM 通知消息并将其发送到我们的设备。通知消息是指显示在系统通知区域的消息。通过以下方式发送测试 FCM 消息：

1. 确保应用在后台运行（转到主屏幕）
2. 前往 Firebase 控制台，然后在左侧导航栏中选择 Cloud Messaging
3. 选择发送第一条消息
4. 为消息添加标题和正文，然后点击发送测试消息

5. 添加 FCM 注册令牌，然后点击测试

6. 观察设备上的显示通知
7. 点按通知即可打开应用

6. 发送测试 FIAM 消息

Firebase In-App Messaging 可以通过各种用户事件触发。测试消息使用应用打开事件来触发应用内消息。通过以下方式发送测试 FIAM 消息：

1. 确保应用在后台运行（前往主屏幕）
2. 前往 Firebase 控制台，然后在左侧导航栏中选择“In-App Messaging”
3. 选择制作首个广告系列
4. 选择顶部横幅广告系列，然后输入消息的标题和正文
5. 点击在设备上测试

6. 添加安装 ID，然后点击测试

7. 重新打开应用
8. 观察应用内消息

7. 恭喜

恭喜，您已成功发送 FCM 和 FIAM 消息。现在，您已了解如何与用户互动，无论他们是在前台使用您的应用还是在后台使用您的应用。

深入阅读

• Firebase Cloud Messaging 文档
• Firebase In-App Messaging 文档

后续操作

• 在您自己的 Android 应用中向用户发送消息。

参考文档

• Firebase Cloud Messaging
• Firebase In-App Messaging