Firebase 应用内消息使用入门

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

ios
Android

开始之前

ios

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

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

要开始使用,您的应用需要满足以下两个要求:

  • 启用了 Firebase:如果您尚未将 Firebase 添加到 Android 项目,请先添加。
  • Android SDK 版本为 16 或更高版本:检查您的应用级 build.gradleminSdkVersion 必须至少设置为 16。

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

ios

要开始操作,请添加 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. 编译并运行您的应用。
Android

将 SDK 添加到编译文件中

将应用内消息功能的依赖项添加到您的应用级 build.gradle 中:

// ...
dependencies {
    // ...

    // Add the In-App Messaging depencency:
    implementation 'com.google.firebase:firebase-inappmessaging-display:17.0.0'

    // Check that your Firebase dependency is up-to-date:
    implementation 'com.google.firebase:firebase-core:16.0.1'
}

发送测试消息

获取应用的实例 ID

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

ios

该测试设备由 FirebaseInstanceID 确定。按以下方法查找测试应用的实例 ID:使用运行时命令参数 -FIRDebugEnabled 运行应用,然后在 Xcode 控制台的日志中查找以下行:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Instance ID YOUR_APP_ID
Android

该测试设备由 FirebaseInstanceId 确定。检查 Android Studio 中的 Logcat 以获取以下“信息”级日志,通过这种方法来查找测试应用的实例 ID:

I/FIAM.Headless: Starting InAppMessaging runtime with Instance ID YOUR_APP_ID

向您的测试设备发送消息

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

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

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

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面