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

本頁面由 Cloud Translation API 翻譯而成。

DeviceTraceCollector

public class DeviceTraceCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.DeviceTraceCollector

這個收集器會在測試執行開始時啟動 Perfetto 追蹤記錄，並在結束時記錄追蹤記錄檔。

摘要

公用建構函式
`DeviceTraceCollector()`

公用方法
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` 測試案例結束時的回呼。
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` 測試作業結束時的回呼。
`void`	`onTestStart(DeviceMetricData testData)` 測試案例啟動時的回呼。
`void`	`rebootEnded(ITestDevice device)` 裝置重新啟動後會收到通知。
`void`	`rebootStarted(ITestDevice device)` 裝置開始重新啟動時，會收到通知。
`void`	`setInstrumentationPkgName(String packageName)`

public DeviceTraceCollector ()

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

擲回
`DeviceNotAvailableException`

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

測試案例結束時的回呼。這時應該要進行清理。

參數
`testData`	`DeviceMetricData`：`DeviceMetricData`，其中包含測試案例的資料。與 `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` 期間的物件相同。
`currentTestCaseMetrics`	：傳遞至 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的指標目前對應。

擲回
`DeviceNotAvailableException`

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

測試作業結束時的回呼。這時應該要進行清理。

參數
`runData`	`DeviceMetricData`：保存執行資料的 `DeviceMetricData`。與 `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 期間的物件相同。
`currentRunMetrics`	：傳遞至 `ERROR(/#testRunEnded(long,Map))` 的指標目前對應。

擲回
`DeviceNotAvailableException`

public void onTestStart (DeviceMetricData testData)

測試案例啟動時的回呼。

參數
`testData`	`DeviceMetricData`：保存測試案例資料的 `DeviceMetricData`。

擲回
`DeviceNotAvailableException`

public void rebootEnded (ITestDevice device)

裝置重新啟動後，系統會傳送通知。

注意：接收器應避免在此回呼期間重新啟動。系統會忽略任何重新啟動嘗試。

參數
`device`	`ITestDevice`：重新啟動結束的位置。`ITestDevice`

擲回
`DeviceNotAvailableException`

public void rebootStarted (ITestDevice device)

裝置開始重新啟動時收到通知。

注意：接收器應避免在此回呼期間重新啟動。系統會忽略任何重新啟動嘗試。

參數
`device`	`ITestDevice`：重新啟動的`ITestDevice`位置。

擲回
`DeviceNotAvailableException`

public void setInstrumentationPkgName (String packageName)

參數
`packageName`	`String`