转到控制台

Firebase 应用内消息使用入门

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

准备工作

开始之前,需要在您的环境中设置几项内容:

  • 启用了 Firebase 的应用:如果您尚未将 Firebase 添加到您的 iOS 项目,请先添加。
  • Xcode 9.2 或更高版本: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/InAppMessagingDisplay'
    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 控制台允许您指定一部测试设备来按需显示消息。

该测试设备由 FirebaseInstanceID 确定。要查找测试应用的实例 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 Instance ID YOUR_APP_ID

向您的测试设备发送消息

在测试设备上启动应用并获得应用的实例 ID 后,您可以发送测试消息来试用设置好的 Firebase 应用内消息:

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

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