開始使用 Flutter 的性能監控

本快速入門介紹瞭如何設置 Firebase 性能監控，以幫助您深入了解 Flutter 應用的性能特徵。

在你開始之前

如果您還沒有，請在您的 Flutter 項目中配置和初始化 Firebase 。

第 1 步：將性能監控添加到您的應用程序

1. 在 Flutter 項目的根目錄中，運行以下命令來安裝 Performance Monitoring Flutter 插件：

   flutter pub add firebase_performance
   

2. 在 Flutter 項目的根目錄中，運行以下命令：

   flutterfire configure
   

   運行此命令可確保您的 Flutter 應用程序的 Firebase 配置是最新的，並且對於 Android，將所需的性能監控 Gradle 插件添加到您的應用程序。

3. 完成後，重建您的 Flutter 項目：

   flutter run
   

添加 Performance Monitoring SDK 後，Firebase 會自動開始收集與應用程序生命週期相關的數據（例如應用程序啟動時間），以及HTTP/S 網絡請求的數據。

在 Flutter 上，無法對單個 Flutter 屏幕進行自動屏幕渲染性能監控。單個視圖控制器以原生方式封裝整個 Flutter 應用程序，因此底層原生 Firebase SDK 不會感知屏幕轉換。

注意：當您將性能監控添加到您的應用程序時，遠程配置 SDK 將作為依賴項包含在內。如果您已經使用 Remote Config，您將看不到任何區別。但是，如果您是 Remote Config 的新手，請瀏覽Remote Config 文檔以詳細了解您將能夠在您的應用中訪問的各種功能。

第 2 步：為初始數據顯示生成性能事件

當您成功將 SDK 添加到您的應用程序時，Firebase 開始處理事件。如果您仍在本地開發，請與您的應用交互以生成用於初始數據收集和處理的事件。

注意：性能監控 SDK 在本地批處理事件，然後定期（每 30 秒）或在應用返回前台時將它們發送到 Firebase。因此，應用交互與 Firebase 從您的應用接收事件信息之間存在延遲。

1. 使用模擬器或測試設備繼續開發您的應用程序。

2. 通過在後台和前台之間多次切換您的應用程序、通過跨屏幕導航和/或觸發網絡請求與您的應用程序交互來生成事件。

3. 轉到 Firebase 控制台的性能儀表板。您應該會在幾分鐘內看到初始數據顯示。

   如果您沒有看到初始數據的顯示，請查看故障排除提示。

第 3 步：（可選）查看性能事件的日誌消息

1. 檢查您的日誌消息是否有任何錯誤消息。

   Performance Monitoring 使用以下標籤標記其日誌消息，以便您可以過濾日誌消息：

   • iOS+： Firebase/Performance
   • 安卓： FirebasePerformance

2. 檢查以下類型的日誌，這些日誌表明性能監控正在記錄性能事件：

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

3. 單擊 URL 以在 Firebase 控制台中查看您的數據。數據在儀表板中更新可能需要一些時間。

第 4 步：（可選）為特定代碼添加自定義監控

要監控與應用中特定代碼關聯的性能數據，您可以檢測自定義代碼跟踪。

使用自定義代碼跟踪，您可以測量您的應用程序完成特定任務或一組任務所需的時間，例如加載一組圖像或查詢數據庫。自定義代碼跟踪的默認指標是其持續時間，但您也可以添加自定義指標，例如緩存命中和內存警告。

在您的代碼中，您使用 Performance Monitoring SDK 提供的 API 定義自定義代碼跟踪的開始和結束（並添加任何所需的自定義指標）。

訪問為特定代碼添加監控以了解有關這些功能以及如何將它們添加到您的應用程序的更多信息。

第 5 步：部署您的應用程序然後查看結果

使用模擬器和一個或多個測試設備驗證性能監控後，您可以將應用程序的更新版本部署給用戶。

您可以在 Firebase 控制台的性能儀表板中監控性能數據。

下一步

• 詳細了解性能監控自動收集的數據：

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

• 在 Firebase 控制台中查看、跟踪和過濾您的性能數據。

• 通過檢測自定義代碼跟踪，在您的應用程序中添加對特定任務或工作流的監控。

• 使用屬性來過濾性能數據。