本快速入門導覽課程說明如何設定 Firebase In-App Messaging 及傳送第一則訊息。
事前準備
如果您尚未安裝並初始化 Flutter 專用的 Firebase SDK,請先完成這項操作。
將 Firebase 應用程式內通訊 SDK 新增至專案
在 Flutter 專案的根目錄中執行下列指令 指令安裝 Firebase 應用程式內通訊外掛程式:
flutter pub add firebase_in_app_messaging
重新建構您的專案:
flutter run
匯入 Firebase 應用程式內通訊外掛程式:
import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
傳送測試訊息
取得應用程式的安裝 ID
為節省電力,Firebase 應用程式內通訊只會從 每天存取一次這可能會導致測試困難 你可以透過 Firebase 控制台指定顯示訊息的測試裝置 隨選。
這種測試裝置是由 FID 決定。 前往控制台,找出測試應用程式的 FID 執行應用程式時的輸出內容
在 Android 上,訊息會如下所示:
I/FIAM.Headless: Starting InAppMessaging runtime with Installation ID YOUR_INSTALLATION_ID
在 iOS 上,使用執行階段指令引數 -FIRDebugEnabled
執行應用程式:
- 在 Xcode 專案開啟的狀態下,依序選取頂端選單列中的「Product」>「Scheme」>「Edit scheme...」。
- 開啟彈出對話方塊的「Arguments」分頁標籤。
- 點選「Arguments Passed On Launch」(啟動時傳遞的引數) 下方的「+ Add items」(新增項目)。
- 輸入「-FIRDebugEnabled」新欄位的值
- 按一下「關閉」,然後執行應用程式。
應用程式開始執行後,請在 Xcode 主控台的記錄檔中尋找以下行:
[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Firebase Installation ID YOUR_INSTALLATION_ID
傳送訊息至測試裝置
在測試裝置啟動應用程式, Firebase 安裝 ID (FID),歡迎試用 Firebase 應用程式內通訊 請傳送測試訊息來完成設定:
- 在 Firebase 控制台中開啟「Messaging」。
- 如果這是您的第一個廣告活動,請按一下「製作您的第一個廣告活動」;
- 選取「Firebase 應用程式內訊息」,然後按一下「建立」。
- 否則,請在「廣告活動」分頁中按一下「新增廣告活動」。
- 選取「應用程式內通訊」。
- 輸入第一則訊息的標題。
- 按一下「Test on your Device」。
- 在以下位置輸入應用程式的 Firebase 安裝 ID: 新增安裝 ID 欄位。
- 按一下「測試」傳送訊息。
Firebase 應用程式內通訊會在您按一下 [測試] 後立即傳送測試訊息。如要查看這則訊息,您必須在測試裝置上關閉應用程式,然後重新開啟。
如要確認裝置是否為測試裝置,請尋找以下任一選項 記錄訊息
Android
I/FIAM.Headless: Setting this device as a test device
iOS
[Firebase/InAppMessaging][I-IAM180017] Seeing test message in fetch response. Turn the current instance into a testing instance.