准备工作
开始之前,需要在您的环境中设置几项内容:
- 启用了 Firebase 的应用:如果您尚未将 Firebase 添加到您的 iOS 项目,请先添加。
- Xcode 11.0 或更高版本:Firebase In-App Messaging 需要运行相对较新版本的 Xcode。您可以在 Apple 的 Xcode 网站上找到最新版本的 Xcode。
- CocoaPods 1.4.0 或更高版本:Firebase In-App Messaging 使用 CocoaPods 来管理 iOS 上的依赖项。您可以从 CocoaPods 网站安装该工具。
将 Firebase In-App Messaging SDK 添加到您的项目中
要开始操作,请添加 Firebase In-App Messaging CocoaPods 来将 Firebase In-App Messaging SDK 框架文件添加到您的项目中:
- 打开一个新的终端窗口,然后导航到 Xcode 项目的目录。
- 打开 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
- 从终端安装 pod 的依赖项:
pod install
- 在 Xcode 中打开您的应用的项目:
open YOUR-PROJECT.xcworkspace
- 在
UIApplicationDelegate
中导入 Firebase 模块(如果您还没有导入的话):Swift
import Firebase
Objective-C
@import Firebase;
- 另外,如果您尚未配置
FirebaseApp
共享实例,请执行此操作(通常在应用的application:didFinishLaunchingWithOptions:
方法中配置):Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- 编译并运行您的应用。
发送测试消息
获取应用的安装 ID
为节省能耗,Firebase In-App Messaging 每天仅从服务器检索一次消息。这可能会使测试难以进行,因此 Firebase 控制台允许您指定一部测试设备来按需显示消息。
该测试设备由 Firebase 安装服务提供的 Firebase 安装 ID 确定。如需查找测试应用的安装 ID,请使用运行时命令参数 -FIRDebugEnabled
运行该应用:
- 打开 Xcode 项目后,从顶部菜单栏中依次选择 Product> Scheme> Edit scheme...。
- 打开弹出对话框的 Arguments 选项卡。
- 在 Arguments Passed On Launch 下点击 + Add items。
- 在新创建的字段中输入“-FIRDebugEnabled”。
- 点击 Close,然后运行您的应用。
您的应用开始运行后,在 Xcode 控制台的日志中查找以下行:
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_APP_ID
向您的测试设备发送消息
在测试设备上启动应用并获得 Firebase 安装 ID (FID) 后,您可以通过发送测试消息来试用 Firebase In-App Messaging 设置:
- 在 Firebase 控制台中,打开 In-App Messaging。
- 之后,点击新建活动。
- 为第一条消息输入标题。
- 点击在您的设备上进行测试
- 在添加安装 ID 字段中输入应用的 Firebase 安装 ID。
- 点击测试以发送消息。
在您点击测试后,Firebase In-App Messaging 会立即发送测试消息。要查看该消息,请关闭应用,然后在测试设备上重新打开应用。
如需确认您的设备是否为测试设备,请查找以下日志消息:
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.