開始使用 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 新增至應用程式後,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 控制台的「成效」資訊主頁中監控成效資料。

後續步驟