欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

Firebase In-App Messaging 使用入门

本快速入门将向您介绍如何设置 Firebase In-App Messaging 并发送您的第一条消息。

准备工作

如果尚未安装并初始化适用于 Flutter 的 Firebase SDK,请先完成该过程。

将 Firebase In-App Messaging SDK 添加到您的项目中

  1. 从 Flutter 项目的根目录运行以下命令,安装 Firebase In-App Messaging 插件:

    flutter pub add firebase_in_app_messaging
    
  2. 重新构建您的项目:

    flutter run
    
  3. 导入 Firebase In-App Messaging 插件:

    import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
    

发送测试消息

获取应用的安装 ID

为节省能耗,Firebase In-App Messaging 每天仅从服务器检索一次消息。这可能会使测试难以进行,因此 Firebase 控制台允许您指定一部测试设备来按需显示消息。

该测试设备由 FID 确定。如需查找测试应用的 FID,请在运行应用时检查控制台输出。

在 Android 上,此消息如下所示:

I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID

在 iOS 上,使用运行时命令参数 -FIRDebugEnabled 运行应用:

  1. 打开 Xcode 项目后,从顶部菜单栏中依次选择 Product(产品)> Scheme(方案)> Edit scheme…(修改方案…)
  2. 打开弹出对话框的 Arguments(参数)标签页。
  3. Arguments Passed On Launch(启动参数)下点击 + Add items(+ 添加参数)
  4. 在新创建的字段中输入“-FIRDebugEnabled”。
  5. 点击 Close(关闭),然后运行您的应用。

您的应用开始运行后,在 Xcode 控制台的日志中查找以下行:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID

向您的测试设备发送消息

在测试设备上启动应用并获得 Firebase 安装 ID (FID) 后,您可以发送测试消息来试用 Firebase In-App Messaging 设置:

  1. 在 Firebase 控制台中,打开 In-App Messaging
  2. 点击新建宣传活动
  3. 输入第一条消息的标题
  4. 点击在您的设备上进行测试
  5. 添加安装 ID 字段中输入应用的 Firebase 安装 ID。
  6. 点击测试,发送消息。

在您点击测试后,Firebase In-App Messaging 会立即发送测试消息。如需查看该消息,您需要在测试设备上关闭应用,然后重新打开应用。

如需确认您的设备是否为测试设备,请查找以下日志消息。

Android

I/FIAM.Headless: Setting this device as a test device

iOS

[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.