本快速入門介紹瞭如何設置 Firebase 性能監控,以幫助您深入了解 Flutter 應用的性能特徵。
在你開始之前
如果您還沒有準備好,請在 Flutter 項目中配置並初始化 Firebase 。
第 1 步:將性能監控添加到您的應用程序
在 Flutter 項目的根目錄中,運行以下命令來安裝性能監控 Flutter 插件:
flutter pub add firebase_performance
從 Flutter 項目的根目錄運行以下命令:
flutterfire configure
運行此命令可確保您的 Flutter 應用程序的 Firebase 配置是最新的,並且對於 Android,會將所需的性能監控 Gradle 插件添加到您的應用程序。
完成後,重建您的 Flutter 項目:
flutter run
添加性能監控 SDK 後,Firebase 會自動開始收集與應用生命週期相關的數據(例如應用啟動時間)以及HTTP/S 網絡請求的數據。
在 Flutter 上,無法對單個 Flutter 屏幕進行自動屏幕渲染性能監控。單個視圖控制器原生封裝了整個 Flutter 應用程序,因此底層原生 Firebase SDK 無法感知屏幕轉換。
步驟 2 :生成初始數據顯示的性能事件
當您成功將 SDK 添加到您的應用時,Firebase 開始處理事件。如果您仍在本地開發,請與您的應用程序交互以生成用於初始數據收集和處理的事件。
繼續使用模擬器或測試設備開發您的應用程序。
通過在後台和前台之間多次切換應用程序、通過跨屏幕導航與應用程序交互和/或觸發網絡請求來生成事件。
轉到 Firebase 控制台的性能儀表板。您應該會在幾分鐘內看到初始數據顯示。
如果您沒有看到初始數據的顯示,請查看故障排除提示。
步驟 3 :(可選)查看性能事件的日誌消息
檢查日誌消息中是否有任何錯誤消息。
性能監控使用以下標籤標記其日誌消息,以便您可以過濾日誌消息:
- iOS+:
Firebase/Performance
- Android:
FirebasePerformance
- iOS+:
檢查以下類型的日誌,這些日誌表明性能監控正在記錄性能事件:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
單擊 URL 可在 Firebase 控制台中查看您的數據。儀表板中的數據更新可能需要一些時間。
步驟 4 :(可選)為特定代碼添加自定義監控
要監控與應用程序中特定代碼相關的性能數據,您可以檢測自定義代碼跟踪。
通過自定義代碼跟踪,您可以測量應用程序完成特定任務或一組任務(例如加載一組圖像或查詢數據庫)所需的時間。自定義代碼跟踪的默認指標是其持續時間,但您也可以添加自定義指標,例如緩存命中和內存警告。
在代碼中,您可以使用性能監控 SDK 提供的 API 定義自定義代碼跟踪的開始和結束(並添加任何所需的自定義指標)。
請訪問添加特定代碼的監控以了解有關這些功能以及如何將它們添加到您的應用程序的更多信息。
第 5 步:部署您的應用程序然後查看結果
使用模擬器和一台或多台測試設備驗證性能監控後,您可以向用戶部署應用程序的更新版本。
您可以在 Firebase 控制台的性能儀表板中監控性能數據。
下一步
了解有關性能監控自動收集的數據的更多信息:
- 與應用生命週期相關的數據,例如應用啟動時間
- 您的應用發出的HTTP/S 網絡請求的數據
在 Firebase 控制台中查看、跟踪和過濾您的性能數據。
通過檢測自定義代碼跟踪來添加對應用程序中特定任務或工作流程的監控。