Performance Monitoring 使用入门 (Flutter)

本快速入门介绍了如何设置 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/HTTPS 网络请求的数据。

在 Flutter 上,不能针对个别 Flutter 屏幕自动进行屏幕渲染性能监控。单个视图控制器以原生方式封装整个 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 步:部署应用并查看结果

使用模拟器和一个或多个测试设备验证 Performance Monitoring 之后,您可以将应用的更新版本部署给用户。

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

后续步骤