捕获设备上的系统跟踪记录

捕获设备上的系统跟踪记录

运行 9（API 级别 28）或更高版本的设备包括一个名为 . 此应用程序类似于命令行实用程序，但允许您直接从测试设备本身记录轨迹，而无需插入设备并通过 ADB 连接到它。 然后，您可以使用该应用程序与您的开发团队共享这些轨道的结果。

在解决应用程序中与性能相关的错误（例如启动缓慢、转换缓慢或 UI 卡顿）时，记录跟踪特别有用。

记录系统轨迹

通过该应用程序，您可以使用“快速设置”磁贴或应用程序本身的菜单来记录系统轨迹。 以下部分将介绍如何使用这些接口来完成录制过程。

注意：作为开发工作流程的一部分，您可以提交设备上的错误报告。 完成记录系统跟踪后，请务必提交此类错误报告。 这样，错误报告过程本身就不会包含在记录的跟踪中。使用“快速设置”磁贴进行记录

使用“快速设置”磁贴通常更容易完成设备上的系统跟踪过程。

设置瓷砖

图 2. 应用程序中的 Show Quick 磁贴切换

如果您是第一次在测试设备上使用它，或者您没有在设备的快速设置面板（图 1）中看到磁贴，请完成以下设置步骤：

（如果此选项尚未启用）。 打开开发者选项设置屏幕。 在“调试”部分中，选择 . 应用程序打开，显示应用程序菜单。

在应用程序菜单中，启用显示快速设置磁贴，如图2所示。系统会将磁贴添加到快速设置面板中，如图1所示：

图 1. 快速设置面板中的磁贴

注意：默认情况下，图块添加为快速设置面板中的第一个图块。 如果您希望图块出现在不同的位置，请使用此面板的修改模式移动图块。

完成系统跟踪记录的记录

要使用“快速设置”面板记录系统跟踪，请完成以下步骤：

点击标签为“记录跟踪记录”的图块。 磁贴变为启用状态，并显示常驻通知，通知您正在记录跟踪，如图 3 所示：

图 3. 在设备上启动系统跟踪后持久通知

在您的应用程序中执行您希望系统检查的操作。

注意：您可以通过让它在后台运行然后在错误发生后立即停止来记录难以重现的错误。 设备的活动被保存到一个可以容纳 10-30 秒事件的滚动缓冲区中。

完成后，通过点击快速设置窗格中的图块或点击通知来停止跟踪。

出现一条新通知，其中包含消息“trace”。 保存完成后，通知将消失，并出现第三条通知，确认您的跟踪已保存并且您已准备就绪，如图 4 所示：

图 4. 系统使用应用程序菜单保存记录的 后出现的持久化通知

使用应用程序菜单，您可以配置多个与系统跟踪相关的高级设置，并提供用于启动和停止系统跟踪记录的开关。

要使用应用程序菜单记录系统跟踪，请完成以下步骤：

（如果此选项尚未启用）。

打开开发者选项设置屏幕。 在“调试”部分中，选择 . 该应用程序立即打开。

或者，如果您已经拥有，则可以长按磁贴进入应用程序。

确保选中跟踪可调试应用程序以包括在系统跟踪中启用调试的应用程序。

（可选）选择对跟踪进行的系统和传感器调用的类别，并选择每个 CPU 的缓冲区空间（以 KB 为单位）。 选择与您正在测试的用例相对应的类，例如用于测试蓝牙操作的音频或用于堆分配的内存。

注意：这些类别用作应用程序级设置，因此它们也用于 . 此外，这些设置会在设备重启后保留。

图 5. 应用中的 trace 记录开关

（可选）选择长期跟踪以启用对设备存储的持久跟踪。 如果选择此选项，则必须设置最大长期跟踪大小和最大长期跟踪持续时间。

启用记录跟踪记录开关，如图 5 所示。该磁贴将变为启用状态，并会显示一条持久通知，让您知道正在记录跟踪 ( )。

在您的应用程序中执行您希望系统检查的操作。

注意：您可以通过让它在后台运行然后在错误发生后立即停止来记录难以重现的错误。 默认情况下，设备的活动被保存到滚动缓冲区，它可以容纳 10-30 秒的事件。 如果您启用了长期跟踪，您设备的活动将继续保存到设备存储中，直至达到您设置的限制。

完成此操作后，您可以通过停用 Trace 开关来停止跟踪。

出现一条新通知，其中包含消息“trace”。 保存完成后，通知将被取消，并出现第三条通知，确认您的跟踪记录已保存并且您已准备就绪，如图所示。

共享系统跟踪

应用程序可帮助您跨多个不同的工作流程共享系统跟踪结果。 在运行版本 10（API 级别 29）或更高版本的设备上，跟踪文件以 .-trace 文件扩展名保存，并且可以在 . 在旧版本的设备上，跟踪文件以 . 文件扩展名（表示格式）。

分享为消息

允许您与设备上的其他应用程序共享您收集的痕迹。 这允许您通过电子邮件或错误跟踪应用程序将跟踪发送给您的开发团队，而无需将您的设备连接到您的开发机器。

完成系统跟踪记录后，点击设备上显示的通知（请参阅 ）。 将出现一个平台选择器，允许您使用所选的消息传递应用程序共享您的曲目。

通过 Files Geek 应用程序共享

在运行 10（API 级别 29）的设备上，跟踪显示在 Files Geek 应用程序中。 如果需要，您可以通过此应用程序共享痕迹。

使用 ADB 下载报告

如果需要，您还可以使用 ADB 从设备中提取系统跟踪。 将记录trace的设备连接到开发机，在终端窗口运行如下命令：

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

跟踪记录格式之间的转换

您可以将跟踪文件转换为格式。 详情请见。

创建 HTML 报告

共享跟踪时，报告本身位于 .-trace 文件中（在运行版本 10 或更高版本的设备上）或 . 文件（所有其他版本）。

使用或利用跟踪文件来创建 HTML 报告。

基于网络的界面

用于打开跟踪文件并生成报告。

对于文件，单击打开跟踪文件。 对于文件，单击“使用 UI 打开”。 旧界面的外观与报表相同。

命令行

在终端窗口中运行以下命令以从跟踪文件生成 HTML 报告：

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

如果您还没有命令行程序，可以从位于 的项目中下载，或者直接从开源项目中下载。