开始使用 Flutter 的性能监控

本快速入门介绍了如何设置 Firebase 性能监控，以帮助您深入了解 Flutter 应用的性能特征。

在你开始之前

如果您还没有，请在 Flutter 项目中配置和初始化 Firebase 。

第 1 步：将性能监控添加到您的应用程序

1. 在 Flutter 项目的根目录中，运行以下命令来安装性能监控 Flutter 插件：

   flutter pub add firebase_performance
   

2. 在 Flutter 项目的根目录中，运行以下命令：

   flutterfire configure
   

   运行此命令可确保您的 Flutter 应用的 Firebase 配置是最新的，并且对于 Android，将所需的性能监控 Gradle 插件添加到您的应用中。

3. 完成后，重新构建您的 Flutter 项目：

   flutter run
   

添加性能监控 SDK 后，Firebase 会自动开始收集与应用生命周期相关的数据（例如应用启动时间），以及HTTP/S 网络请求的数据。

在 Flutter 上，无法对单个 Flutter 屏幕进行自动屏幕渲染性能监控。单个视图控制器原生封装了整个 Flutter 应用程序，因此底层原生 Firebase SDK 不知道屏幕转换。

第 2 步：为初始数据显示生成性能事件

当您成功将 SDK 添加到您的应用时，Firebase 开始处理这些事件。如果您仍在本地开发，请与您的应用交互以生成用于初始数据收集和处理的事件。

1. 继续使用模拟器或测试设备开发您的应用程序。

2. 通过在后台和前台之间多次切换您的应用程序、通过跨屏幕导航与您的应用程序交互和/或触发网络请求来生成事件。

3. 转到 Firebase 控制台的性能信息中心。您应该会在几分钟内看到您的初始数据显示。

   如果您没有看到初始数据的显示，请查看故障排除提示。

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

1. 检查您的日志消息中是否有任何错误消息。

   性能监控使用以下标签标记其日志消息，以便您可以过滤日志消息：

   • iOS+： Firebase/Performance
   • Android： FirebasePerformance

2. 检查以下类型的日志，这些日志表明性能监控正在记录性能事件：

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

3. 单击 URL 以在 Firebase 控制台中查看您的数据。数据在仪表板中更新可能需要一些时间。

第 4 步：（可选）为特定代码添加自定义监控

要监控与应用中特定代码相关的性能数据，您可以检测自定义代码跟踪。

使用自定义代码跟踪，您可以测量应用程序完成特定任务或一组任务需要多长时间，例如加载一组图像或查询您的数据库。自定义代码跟踪的默认指标是其持续时间，但您也可以添加自定义指标，例如缓存命中和内存警告。

在您的代码中，您可以使用性能监控 SDK 提供的 API 定义自定义代码跟踪的开始和结束（并添加任何所需的自定义指标）。

访问为特定代码添加监控以了解有关这些功能以及如何将它们添加到您的应用程序的更多信息。

第 5 步：部署您的应用程序，然后查看结果

使用模拟器和一台或多台测试设备验证性能监控后，您可以将应用程序的更新版本部署给您的用户。

您可以在 Firebase 控制台的性能信息中心监控性能数据。

下一步

• 详细了解性能监控自动收集的数据：

  • 与应用生命周期相关的数据，例如应用启动时间
  • 您的应用发出的HTTP/S 网络请求的数据

• 在 Firebase 控制台中查看、跟踪和过滤您的性能数据。

• 通过检测自定义代码跟踪，为您的应用程序中的特定任务或工作流添加监控。

• 使用属性过滤性能数据。