Flutter 中文文档：性能分析

性能移动应用对于用户来说相当重要，用户希望应用程序有流畅的滚动和优雅的动画，不愿看到卡顿和掉帧现象。我们如何确保我们的应用程序在各种设备上不会受到卡顿的影响？

以下两种方式可供选择：首先，我们可以在不同的设备对应用程序进行手动测试。这种方式适用于较小的应用程序，但随着应用程序扩展性的提升，它将变得更加繁琐。另外，我们可以运行集成测试，执行特定任务并记录性能时间轴。然后，我们可以检验结果，以确定是否需要对我们应用程序的特定部分进行改善。

在本文中，我们将学习如何在执行特定任务时编写记录性能时间轴的测试，并将结果的摘要保存到本地文件中。

步骤

1. 编写一个滚动列表的测试项目

2. 记录应用程序的性能

3. 将结果保存到磁盘

4. 运行测试

5. 检查结果

1. 编写一个滚动列表的测试项目

在这一章节，我们将记录当滚动列表条目时应用程序的性能。为了专注于性能分析，这一小节在  的基础上进行。

请按照基础章节的指南新建一个应用程序，配置应用程序，然后，编写一个测试程序。最终，确保应用程序按预期运行。

2. 记录应用程序的性能

然后，我们需要再应用程序的列表滚动的时候记录它的性能。使用 FlutterDriver 类中的 traceAction() 方法实现这项功能。

这种方式运行提供的方法，并将应用程序性能的详细信息记录在 Timeline 中。在这个示例中，我们提供一个方法，用以滚动列表的条目并确保指定条目是否被显示出来。当方法执行完成的时候，traceAction 会返回一个 Timeline。

// Record a performance timeline as the app scrolls through the list of items.
final timeline = await driver.traceAction(() async {
  await driver.scrollUntilVisible(
    listFinder,
    itemFinder,
    dyScroll: -300.0,
  );

  expect(await driver.getText(itemFinder), 'Item 50');
});

3. 将结果保存到磁盘

我们已经获取了一个性能时间轴，我们需要一种方式来对它进行检验， Timeline 对象提供所有已发生事件的相关详细信息，但它不提供快捷方式查看结果。

因此，我们可以将 Timeline 转换成 TimelineSummary， TimelineSummary 通过执行两个任务可以使我们更容易的检查结果：

（1）将一个 json 文件写入磁盘，它包含了 Timeline 中包含的数据的摘要。此摘要包括掉帧数量，最慢构建时间等的信息。

（2）它可以将完整的  Timeline  以 json 文件的形式存储在磁盘上，可以使用 Chrome 浏览器的追踪工具打开此文件。追踪工具在这里:  chrome://tracing 。

// Convert the Timeline into a TimelineSummary that's easier to read and
// understand.
final summary = new TimelineSummary.summarize(timeline);

// Then, save the summary to disk.
summary.writeSummaryToFile('scrolling_summary', pretty: true);

// Optionally, write the entire timeline to disk in a json format. This
// file can be opened in the Chrome browser's tracing tools found by
// navigating to chrome://tracing.
summary.writeTimelineToFile('scrolling_timeline', pretty: true);

4. 运行测试

在我们为了捕获一个性能 Timeline 配置了测试代码，并且将结果的摘要保存在了磁盘上，我们可以使用以下命令运行测试代码：

flutter drive --target=test_driver/app.dart

5. 检查结果

在测试代码运行成功以后，在项目根目录下的 build 文件夹里包含以下两个文件：

（1）scrolling_summary.timeline_summary.json 包含摘要。可以使用任何文本编辑器打开它并查看其中包含的信息。通过更高级的设置，我们可以在每次测试时保存摘要并创建一个结果图。

（2）scrolling_timeline.timeline.json 包含完整的时间轴数据。使用 Chorme 浏览器的追踪工具打开这个文件。追踪工具在这里： chrome://tracing。追踪工具提供了一个便捷的用户界面，用以检测时间轴数据并发现其中导致性能问题的源头。

摘要的示例

{
  "average_frame_build_time_millis": 4.2592592592592595,
  "worst_frame_build_time_millis": 21.0,
  "missed_frame_build_budget_count": 2,
  "average_frame_rasterizer_time_millis": 5.518518518518518,
  "worst_frame_rasterizer_time_millis": 51.0,
  "missed_frame_rasterizer_budget_count": 10,
  "frame_count": 54,
  "frame_build_times": [
    6874,
    5019,
    3638
  ],
  "frame_rasterizer_times": [
    51955,
    8468,
    3129
  ]
}

完整样例

import 'package:flutter_driver/flutter_driver.dart';
import 'package:test/test.dart';

void main() {
  group('Scrollable App', () {
    FlutterDriver driver;

    setUpAll(() async {
      driver = await FlutterDriver.connect();
    });

    tearDownAll(() async {
      if (driver != null) {
        driver.close();
      }
    });

    test('verifies the list contains a specific item', () async {
      final listFinder = find.byValueKey('long_list');
      final itemFinder = find.byValueKey('item_50_text');

      // Record a performance profile as the app scrolls through
      // the list of items.
      final timeline = await driver.traceAction(() async {
        await driver.scrollUntilVisible(
          listFinder,
          itemFinder,
          dyScroll: -300.0,
        );

        expect(await driver.getText(itemFinder), 'Item 50');
      });

      // Convert the Timeline into a TimelineSummary that's easier to
      // read and understand.
      final summary = new TimelineSummary.summarize(timeline);

      // Then, save the summary to disk.
      summary.writeSummaryToFile('scrolling_summary', pretty: true);

      // Optionally, write the entire timeline to disk in a json format.
      // This file can be opened in the Chrome browser's tracing tools
      // found by navigating to chrome://tracing.
      summary.writeTimelineToFile('scrolling_timeline', pretty: true);
    });
  });
}