Firebase 应用内消息使用入门

本快速入门将向您介绍如何设置 Firebase 应用内消息并发送您的第一条消息。

准备工作

开始之前，需要在您的环境中完成若干设置：

  • 启用了 Firebase 的应用：如果您尚未将 Firebase 添加到您的 iOS 项目，请先添加。
  • Xcode 10.3 或更高版本：Firebase 应用内消息需要运行相对较新版本的 Xcode。您可以在 Apple 的 Xcode 网站上找到最新版本的 Xcode。
  • CocoaPods 1.4.0 或更高版本：Firebase 应用内消息使用 CocoaPods 来管理 iOS 上的依赖项。您可以从 CocoaPods 网站安装该工具。

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

如需开始操作，请添加 Firebase 应用内消息 CocoaPods 来将 Firebase In-App Messaging SDK 框架文件添加到您的项目中：

  1. 打开一个新的终端窗口，然后导航到 Xcode 项目的目录。
  2. 打开 Podfile，并添加以下突出显示的行： 
    # Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'YourProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!

# Pods for YourProject
pod 'Firebase'
pod 'Firebase/InAppMessaging'
pod 'Firebase/Analytics'
end
  3. 从终端安装 pod 的依赖项： 
    pod install
  4. 在 Xcode 中打开您的应用的项目： 
    open YOUR-PROJECT.xcworkspace
  5. 在 UIApplicationDelegate 中导入 Firebase 模块（如果您还没有导入的话）：
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  6. 另外，如果您尚未配置 FirebaseApp 共享实例，请执行此操作（通常在应用的 application:didFinishLaunchingWithOptions: 方法中配置）：
    Swift
    // Use Firebase library to configure APIs
FirebaseApp.configure()
    Objective-C
    // Use Firebase library to configure APIs
[FIRApp configure];
  7. 编译并运行您的应用。

发送测试消息

获取应用的安装 ID

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

该测试设备由 Firebase 安装服务提供的 Firebase 安装 ID 确定。如需查找测试应用的安装 ID，请使用运行时命令参数 -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_APP_ID

向您的测试设备发送消息

在测试设备上启动应用并获得 Firebase 安装 ID (FID) 后，您可以通过发送测试消息来试用 Firebase 应用内消息设置：

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

在您点击测试后，Firebase 应用内消息会立即发送测试消息。要查看该消息，请关闭应用，然后在测试设备上重新打开应用。

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

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