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 控制台的效能儀表板中監控效能資料。

下一步

• 了解有關效能監控自動收集的資料的更多資訊：

  • 與應用生命週期相關的數據，例如應用程式啟動時間
  • 您的應用程式發出的HTTP/S 網路請求的數據

• 在 Firebase 控制台中檢視、追蹤和篩選您的效能資料。

• 透過偵測自訂程式碼追蹤來新增對應用程式中特定任務或工作流程的監控。

• 使用屬性來過濾效能資料。