開始使用 Flutter 的性能監控

本快速入門介紹瞭如何設置 Firebase 性能監控,以幫助您深入了解 Flutter 應用的性能特徵。

在你開始之前

如果您還沒有,請在 Flutter 項目中配置和初始化 Firebase

第 1 步:將性能監控添加到您的應用程序

  1. 在 Flutter 項目的根目錄中,運行以下命令來安裝性能監控 Flutter 插件:

    flutter pub add firebase_performance
    
  2. 在 Flutter 項目的根目錄中,運行以下命令:

    flutterfire configure
    

    運行此命令可確保您的 Flutter 應用的 Firebase 配置是最新的,並且對於 Android,將所需的性能監控 Gradle 插件添加到您的應用中。

  3. 完成後,重新構建您的 Flutter 項目:

    flutter run
    

添加性能監控 SDK 後,Firebase 會自動開始收集與應用生命週期相關的數據(例如應用啟動時間),以及HTTP/S 網絡請求的數據。

在 Flutter 上,無法對單個 Flutter 屏幕進行自動屏幕渲染性能監控。單個視圖控制器原生封裝了整個 Flutter 應用程序,因此底層原生 Firebase SDK 不知道屏幕轉換。

第 2 步:為初始數據顯示生成性能事件

當您成功將 SDK 添加到您的應用時,Firebase 開始處理這些事件。如果您仍在本地開發,請與您的應用交互以生成用於初始數據收集和處理的事件。

  1. 繼續使用模擬器或測試設備開發您的應用程序。

  2. 通過在後台和前台之間多次切換您的應用程序、通過跨屏幕導航與您的應用程序交互和/或觸發網絡請求來生成事件。

  3. 轉到 Firebase 控制台的性能信息中心。您應該會在幾分鐘內看到您的初始數據顯示。

    如果您沒有看到初始數據的顯示,請查看故障排除提示

第 3 步:(可選)查看性能事件的日誌消息

  1. 檢查您的日誌消息中是否有任何錯誤消息。

    性能監控使用以下標籤標記其日誌消息,以便您可以過濾日誌消息:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance
  2. 檢查以下類型的日誌,這些日誌表明性能監控正在記錄性能事件:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  3. 單擊 URL 以在 Firebase 控制台中查看您的數據。數據在儀表板中更新可能需要一些時間。

第 4 步:(可選)為特定代碼添加自定義監控

要監控與應用中特定代碼相關的性能數據,您可以檢測自定義代碼跟踪

使用自定義代碼跟踪,您可以測量應用程序完成特定任務或一組任務需要多長時間,例如加載一組圖像或查詢您的數據庫。自定義代碼跟踪的默認指標是其持續時間,但您也可以添加自定義指標,例如緩存命中和內存警告。

在您的代碼中,您可以使用性能監控 SDK 提供的 API 定義自定義代碼跟踪的開始和結束(並添加任何所需的自定義指標)。

訪問為特定代碼添加監控以了解有關這些功能以及如何將它們添加到您的應用程序的更多信息。

第 5 步:部署您的應用程序,然後查看結果

使用模擬器和一台或多台測試設備驗證性能監控後,您可以將應用程序的更新版本部署給您的用戶。

您可以在 Firebase 控制台的性能信息中心監控性能數據。

下一步