本快速入門說明如何設定 Firebase Performance Monitoring,協助您深入瞭解 Flutter 應用程式的效能特性。
事前準備
如果您尚未在 Flutter 專案中設定及初始化 Firebase,請先完成這些步驟。
步驟 1:在應用程式中加入 Performance Monitoring
在 Flutter 專案的根目錄中執行下列指令,安裝 Performance Monitoring Flutter 外掛程式:
flutter pub add firebase_performance
在 Flutter 專案的根目錄中執行下列指令:
flutterfire configure
執行這項指令可確保 Flutter 應用程式的 Firebase 設定保持最新狀態,而對於 Android 而言,則會在應用程式中加入必要的 Performance Monitoring Gradle 外掛程式。
完成後,請重新建構 Flutter 專案:
flutter run
新增 Performance Monitoring SDK 後,Firebase 就會自動開始收集與應用程式生命週期相關的資料 (例如應用程式啟動時間),以及 HTTP/S 網路要求的資料。
在 Flutter 上,無法針對個別 Flutter 畫面進行自動螢幕轉譯成效監控。單一 View Controller 會原生封裝整個 Flutter 應用程式,因此底層原生 Firebase SDK 不會偵測到畫面轉場。
步驟 2:產生初始資料顯示的效能事件
成功將 SDK 新增至應用程式後,Firebase 就會開始處理事件。如果您仍在本機進行開發,請與應用程式互動,產生事件以便初始收集及處理資料。
繼續使用模擬器或測試裝置開發應用程式。
在背景和前景之間切換應用程式,透過瀏覽各個畫面與應用程式互動,以及/或觸發網路要求,產生事件。
前往 Firebase 控制台的效能資訊主頁。您應該會在幾分鐘內看到初步資料。
如果沒有看到初始資料,請參閱疑難排解提示。
步驟 3:(選用) 查看成效事件的記錄訊息
檢查記錄訊息,瞭解是否有任何錯誤訊息。
Performance Monitoring 會為記錄訊息加上下列標記,方便您篩選記錄訊息:
- iOS+:
Firebase/Performance
- Android:
FirebasePerformance
- iOS+:
請檢查下列記錄類型,確認 Performance Monitoring 是否記錄了效能事件:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
Logging network request trace: URL
按一下網址,即可在 Firebase 控制台中查看資料。資料可能需要幾分鐘的時間才會更新至資訊主頁。
步驟 4:(選用) 為特定程式碼新增自訂監控
如要監控與應用程式中特定程式碼相關聯的成效資料,您可以檢測自訂程式碼追蹤記錄。
您可以透過自訂程式碼追蹤,評估應用程式完成特定工作或一組工作所需的時間,例如載入一組圖片或查詢資料庫。自訂程式碼追蹤記錄的預設指標為其時間長度,但您也可以新增自訂指標,例如快取命中和記憶體警告。
在程式碼中,您可以使用 Performance Monitoring SDK 提供的 API 定義自訂程式碼追蹤的起點和終點 (以及新增任何所需的自訂指標)。
如要進一步瞭解這些功能以及如何將這些功能新增至應用程式,請參閱「為特定程式碼新增監控功能」。
步驟 5:部署應用程式,然後查看結果
使用模擬器和一或多部測試裝置驗證效能監控功能後,您就可以向使用者部署更新版應用程式。
您可以在 Firebase 控制台的「成效」資訊主頁中監控成效資料。
後續步驟
進一步瞭解成效監控自動收集的資料:
- 與應用程式生命週期相關的資料,例如應用程式啟動時間
- 應用程式發出的 HTTP/S 網路要求資料
在 Firebase 控制台中查看、追蹤及篩選效能資料。
檢測自訂程式碼追蹤記錄,為應用程式中的特定工作或工作流程新增監控功能。