自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

CircularAtraceUtil

public class CircularAtraceUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.CircularAtraceUtil

atrace 实用程序主要用于在 Monkey 测试期间确定 ANR 的根本原因。调用 start 命令将开始异步监控循环缓冲区中的标记轨迹。调用 stop 会将缓冲区的内容转储到它返回的 InputStreamSource。如需将其用于上述情况（识别 ANR），必须先在测试开始时实现 start 方法，并在测试结束时立即实现 end 方法。用户可以在此处选择数据的存储和处理方式。大多数情况下，应将 systrace 与 --from-file 选项搭配使用，以生成 HTML 查看器。

摘要

公共构造函数
`CircularAtraceUtil()`

公共方法
`static FileInputStreamSource`	`endTrace(ITestDevice device)` 停止 atrace 并将其异步转储到文件中，然后在 InputStreamSource 中返回该文件。
`static void`	`startTrace(ITestDevice device, tags, int bufferSizeMB)` 使用指定的标记异步启动 atrace。

公共构造函数

CircularAtraceUtil

public CircularAtraceUtil ()

公共方法

endTrace

public static FileInputStreamSource endTrace (ITestDevice device)

停止 atrace 并将其异步转储到文件中，然后在 InputStreamSource 中返回该文件。

参数
`device`	`ITestDevice`

返回
`FileInputStreamSource`	包含 atrace 命令结果的 FileInputStreamSource

抛出
`DeviceNotAvailableException`

startTrace

public static void startTrace (ITestDevice device, 
                 tags, 
                int bufferSizeMB)

使用指定的标记异步启动 atrace。

参数
`device`	`ITestDevice`：要监控其操作的设备
`tags`	：atrace 应监控的标记；默认为“am gfx sched view”
`bufferSizeMB`	`int`：循环缓冲区大小（以 MB 为单位）

抛出
`DeviceNotAvailableException`