開始使用 Firebase 應用程式內通訊

本快速入門導覽課程說明如何設定 Firebase 應用程式內通訊及傳送第一則訊息。

事前準備

開始設定前，請務必將 Firebase 新增至 Apple 專案。

將 Firebase 應用程式內通訊 SDK 新增至專案

使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

  1. 在 Xcode 中保持開啟應用程式專案，然後依序選擇 [檔案] >新增套件。
  2. 在系統提示時，新增 Firebase Apple 平台 SDK 存放區：
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. 選擇應用程式內通訊程式庫。
  4. 在目標建構設定的「Other Linker Flags」部分中新增 -ObjC 標記。
  5. 如要使用應用程式內通訊功能，您必須 啟用 Google Analytics ，然後將 Google Analytics 專用 Firebase SDK 加進應用程式。你可以選取 不是收集廣告識別碼 (IDFA) 或收集廣告識別碼 (IDFA) 的程式庫
  6. 完成後，Xcode 會自動開始解析並下載 複製到背景依附元件

現在，請在應用程式中初始化 SDK：

  1. 將 Firebase 模組匯入 App 結構，或是 UIApplicationDelegate (如果尚未下載)：
    Swift
    import Firebase
    Objective-C
    @import Firebase;
  2. 一併設定 FirebaseApp 共用例項，通常位於 App 的初始化器或應用程式委派的 application(_:didFinishLaunchingWithOptions:) 方法 (如果尚未執行)：
    Swift
    FirebaseApp.configure()
    Objective-C
    [FIRApp configure];
  3. 編譯並執行應用程式。

傳送測試訊息

取得應用程式的安裝 ID

為節省電力，Firebase 應用程式內通訊只會從 每天存取一次這可能會導致測試困難 你可以透過 Firebase 控制台指定顯示訊息的測試裝置 隨選。

這個測試裝置是由 Firebase 安裝服務。如要找出測試版應用程式的安裝 ID，請使用以下指令執行應用程式： 執行階段指令引數 -FIRDebugEnabled：

  1. 開啟 Xcode 專案，然後選取 Product >配置 >編輯配置... 頂端選單列
  2. 開啟彈出對話方塊的「Arguments」分頁標籤。
  3. 在「通過啟動的引數」下方，按一下「+ 新增項目」。
  4. 輸入「-FIRDebugEnabled」新欄位的值
  5. 按一下「關閉」，然後執行應用程式。

應用程式開始執行後，請在 Xcode 主控台的記錄中尋找下列程式碼：

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

傳送訊息至測試裝置

在測試裝置啟動應用程式， Firebase 安裝 ID (FID)，歡迎試用 Firebase 應用程式內通訊 請傳送測試訊息來完成設定：

  1. 在 Firebase 控制台中開啟「Messaging」頁面。
  2. 如果這是您的第一個廣告活動，請按一下「製作您的第一個廣告活動」；
    1. 選取「Firebase 應用程式內訊息」，然後按一下「建立」。
  3. 否則，請在「廣告活動」分頁中按一下「新增廣告活動」。
    1. 選取「應用程式內通訊」。
  4. 輸入第一則訊息的標題。
  5. 按一下「Test on Device」。
  6. 在以下位置輸入應用程式的 Firebase 安裝 ID： 新增安裝 ID 欄位。
  7. 按一下「測試」傳送訊息。

Firebase 應用程式內通訊會在您按一下 [測試] 後立即傳送測試訊息。為了瞭解 訊息，請在測試裝置上關閉該應用程式，然後重新開啟。

如要確認裝置是否為測試裝置，請找出下列項目 記錄訊息：

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