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

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

1. 开始之前

在此 Codelab 中,您将了解如何添加与用户互动的能力,无论他们是在前台使用您的应用还是在后台使用您的应用。

206c7ecece550bde.png

先决条件

没有任何

你会学到什么

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

你需要什么

  • 安卓工作室 4.1
  • Android 设备或模拟器

2. 开始

获取示例代码

从命令行克隆 GitHub 存储库:

导入入门应用

在 Android Studio 中,选择codelab-fcm-and-fiam目录( android_studio_folder.png )。这将是在上一步中克隆的那个(文件>打开> .../codelab-fcm-and-fiam)。

您现在应该在 Android Studio 中打开了 FcmAndFiam 项目。如果您看到有关 google-services.json 文件丢失的警告,请不要担心。它将在下一步中添加。

3. 创建 Firebase 控制台项目

将 Firebase 添加到项目中

  1. 转到Firebase 控制台
  2. 选择添加项目
  3. 选择或输入项目名称。
  4. 按照 Firebase 控制台中的其余设置步骤操作,然后点击创建项目(或添加 Firebase,如果您使用的是现有的 Google 项目)。
  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 插件依赖项和插件本身应该已经分别添加到项目和应用程序级构建文件中。确认以下条目:

构建.gradle

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

应用程序/build.gradle

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

添加依赖项

FCM 和 FIAM 需要以下依赖项。这些依赖项应该已经添加到应用级构建文件中。确认添加了以下依赖项:

应用程序/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)
   }
}
  1. 连接您的 Android 设备,然后单击运行( 执行.png ) 在 Android Studio 工具栏中。点击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. 为消息添加标题和正文,然后单击发送测试消息

207ced65f5245ada.png

  1. 添加 FCM 注册令牌,然后点击测试

f3556c6a8a6453fe.png

  1. 观察设备上的显示通知
  2. 点击通知打开应用程序

6.发送测试FIAM消息

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

  1. 确保应用程序在后台(转到主屏幕)
  2. 转到 Firebase 控制台并在左侧导航中选择 In-App Messaging
  3. 选择创建您的第一个广告系列
  4. 选择顶部横幅广告系列并输入消息的标题和正文
  5. 单击设备上的测试

69f6ea5efff240d1.png

  1. 添加安装 ID 并单击测试

24b101edfab47144.png

  1. 重新打开应用
  2. 在应用消息中观察

7. 恭喜

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

进一步阅读

下一步是什么

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

参考文档