Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

開始使用 Firebase 應用內消息

本快速入門向您展示瞭如何設置 Firebase 應用內消息傳遞並發送您的第一條消息。

在你開始之前

在開始之前,您需要在您的環境中設置一些東西:

  • 啟用 Firebase 的應用:如果您還沒有,請將 Firebase 添加到您的 iOS 項目
  • Xcode 12.2 或更高版本: Firebase 應用內消息傳遞需要相對較新的 Xcode 版本才能運行。您可以在Apple 的 Xcode 站點上找到最新的 Xcode 版本。
  • CocoaPods 1.4.0 或更高版本: Firebase 應用內消息傳遞使用 CocoaPods 來管理 iOS 上的依賴項。您可以從CocoaPods 站點安裝它。

將 Firebase 應用內消息傳遞 SDK 添加到您的項目

首先,通過添加 Firebase In-App Messaging 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 模塊,如果您還沒有:
    迅速
    import Firebase
    目標-C
    @import Firebase;
  6. 還要配置FirebaseApp共享實例,通常在您應用的application:didFinishLaunchingWithOptions:方法中,如果您還沒有:
    迅速
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    目標-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. 打開彈出對話框的參數選項卡。
  3. 單擊“啟動時傳遞的參數”下的“ + 添加項目”。
  4. 在新創建的字段中輸入“-FIRDebugEnabled”。
  5. 單擊Close ,然後運行您的應用程序。

一旦您的應用程序開始運行,請在 Xcode 控制台的日誌中查找以下行:

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

向您的測試設備發送消息

在測試設備上啟動應用並獲得其 Firebase 安裝 ID (FID) 後,您可以通過發送測試消息來試用 Firebase 應用內消息設置:

  1. 在 Firebase 控制台中,打開應用內消息
  2. 點擊新廣告系列
  3. 為您的第一條消息輸入標題
  4. 在您的設備上單擊測試
  5. 添加安裝 ID字段中輸入您應用的 Firebase 安裝 ID。
  6. 單擊測試以發送消息。

一旦您點擊Test , Firebase 應用內消息傳遞就會發送您的測試消息。要查看該消息,您需要關閉,然後在測試設備上重新打開該應用程序。

要確認您的設備是否為測試設備,請查看以下日誌消息:

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