開始使用 Flutter 適用的 Performance Monitoring

本快速入門導覽課程說明如何設定 Firebase Performance Monitoring，以便 即可深入瞭解 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 螢幕的設定單一 View Controller 會原生封裝整個 Flutter 應用程式，因此底層原生 Firebase SDK 不會偵測到畫面轉場。

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

成功將 SDK 加進您的 應用程式。如果您仍在本機開發，可與應用程式互動來產生 收集及處理初次資料收集和處理的事件

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

2. 在背景和前景之間切換應用程式，透過瀏覽各個畫面與應用程式互動，以及/或觸發網路要求，產生事件。

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

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

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

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

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

   • iOS+：Firebase/Performance
   • Android：FirebasePerformance

2. 查看下列類型的記錄，瞭解效能監控功能是否為 記錄效能事件：

   • 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 控制台的成效資料

• 您可以透過下列方式，針對應用程式中的特定工作或工作流程新增監控功能： 檢測自訂程式碼追蹤記錄。

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