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

1. 准备工作

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

前提条件

无

学习内容

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

所需条件

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

2. 开始

获取示例代码

从命令行克隆 GitHub 代码库：

导入 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 目录中。文件下载完毕后，您可以点击 Skip，执行控制台中显示的后续步骤（已在 build-android-start 项目中为您完成这些步骤）。

向您的应用添加 google-services 插件

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

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 文件同步。从 Android Studio 工具栏中依次选择 File > 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 ( )。点按日志标识符按钮会将 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 注册令牌，然后点击 test

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