開始使用 Flutter 適用的 Performance Monitoring

本快速入門導覽課程說明如何設定 Firebase 效能監控，協助您深入瞭解 Flutter 應用程式的效能特性。

事前準備

如果您尚未在 Flutter 專案中設定及初始化 Firebase，請先完成這些步驟。

步驟 1：在應用程式中新增 Performance Monitoring

1. 在 Flutter 專案的根目錄中，執行下列指令來安裝 Performance Monitoring Flutter 外掛程式：

   flutter pub add firebase_performance
   

2. 在 Flutter 專案的根目錄中執行下列指令：

   flutterfire configure
   

   執行這項指令可確保 Flutter 應用程式的 Firebase 設定為最新版本，並為 Android 應用程式新增必要的 Performance Monitoring Gradle 外掛程式。

3. 完成後，請重建 Flutter 專案：

   flutter run
   

加入 Performance Monitoring SDK 後，Firebase 就會自動開始收集與應用程式生命週期相關的資料 (例如應用程式啟動時間)，以及 HTTP/S 網路要求的資料。

在 Flutter 中，系統無法針對個別 Flutter 畫面自動監控畫面算繪效能。單一檢視畫面控制器會以原生方式封裝整個 Flutter 應用程式，因此底層的原生 Firebase SDK 不會察覺畫面轉換。

步驟 2：產生效能事件，以顯示初始資料

將 SDK 成功加入應用程式後，Firebase 就會開始處理事件。如果您仍在進行本機開發，請與應用程式互動，產生事件以供初始資料收集和處理。

1. 繼續使用模擬器或測試裝置開發應用程式。

2. 多次在背景和前景之間切換應用程式、在不同畫面之間瀏覽應用程式，以及/或觸發網路要求，即可產生事件。

3. 前往 Firebase 控制台的效能資訊主頁。您應該會在幾分鐘內看到初步資料。

   如果沒有看到初始資料，請參閱疑難排解提示。

步驟 3：(選用) 查看成效事件的記錄訊息

1. 檢查記錄訊息中是否有任何錯誤訊息。

   為方便您篩選記錄訊息，Performance Monitoring 會使用下列標記標記記錄訊息：

   • iOS+：Firebase/Performance
   • Android：FirebasePerformance

2. 檢查下列類型的記錄，確認 Performance Monitoring 正在記錄效能事件：

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

3. 按一下網址，即可在 Firebase 控制台中查看資料。資訊主頁可能需要幾分鐘才會更新資料。

步驟 4：(選用) 為特定程式碼新增自訂監控功能

如要監控應用程式中特定程式碼的相關效能資料，可以檢測自訂程式碼追蹤記錄。

透過自訂程式碼追蹤記錄，您可以評估應用程式完成特定工作或一組工作所需的時間，例如載入一組圖片或查詢資料庫。自訂程式碼追蹤的預設指標是持續時間，但您也可以新增自訂指標，例如快取命中次數和記憶體警告。

在程式碼中，您可以使用 Performance Monitoring SDK 提供的 API，定義自訂程式碼追蹤的開始和結束時間 (並新增任何所需的自訂指標)。

如要進一步瞭解這些功能，以及如何將這些功能新增至應用程式，請參閱「為特定程式碼新增監控功能」。

步驟 5：部署應用程式，然後查看結果

使用模擬器和一或多個測試裝置驗證成效監控功能後，即可向使用者部署更新版應用程式。

您可以在 Firebase 控制台的「效能」資訊主頁中監控效能資料。

後續步驟

• 進一步瞭解 Performance Monitoring 自動收集的資料：

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

• 在 Firebase 控制台中查看、追蹤及篩選效能資料。

• 如要監控應用程式中的特定工作或工作流程，請檢測自訂程式碼追蹤記錄。

• 使用屬性篩選成效資料。