自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 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 轉儲至 File，並以 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`