自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

CircularAtraceUtil

public class CircularAtraceUtil
extends Object

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

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

摘要

公共构造函数
`CircularAtraceUtil()`

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

公共构造函数

CircularAtraceUtil

public CircularAtraceUtil ()

公共方法

endTrace

public static FileInputStreamSource endTrace (ITestDevice device)

异步停止 atrace 并将其转储到文件中，该文件以 InputStreamSource 形式返回。

参数
`device`	`ITestDevice`

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

抛出
`DeviceNotAvailableException`
`IllegalStateException`

startTrace

public static void startTrace (ITestDevice device, 
                List<String> tags, 
                int bufferSizeMB)

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

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

抛出
`DeviceNotAvailableException`
`IllegalStateException`