使用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 控制台中的其余设置步骤进行操作,然后单击“创建项目” (如果您使用的是现有 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 插件依赖项和插件本身应该已分别添加到项目和应用程序级别构建文件中。确认以下条目:

构建.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 工具栏中选择“文件”>“将项目与 Gradle 文件同步”

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 工具栏中。点击“日志标识符”按钮会将 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 应用内消息传递可以由各种用户事件触发。测试消息使用应用程序打开事件来触发应用程序内消息。通过以下方式发送测试 FIAM 消息:

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

69f6ea5efff240d1.png

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

24b101edfab47144.png

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

7. 恭喜你

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

进一步阅读

下一步是什么

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

参考文档