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

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

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

已知間接子類別

AtraceCollector、AtraceRunMetricCollector、BaseDeviceMetricCollector、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothHciSnoopLogCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector、CountTestCasesCollector、DebugHostLogOnFailureCollector、DeviceTraceCollector、FilePullerDeviceMetricCollector、FilePullerLogCollector 和其他 13 個。

AtraceCollector	`IMetricCollector` 會在測試期間執行 atrace，並收集結果並記錄至叫用作業。
AtraceRunMetricCollector	從測試裝置的特定目錄下收集所有測試目錄的追蹤記錄，記錄測試目錄，並對測試目錄下方的追蹤記錄檔案進行後置處理，然後匯總指標。
BaseDeviceMetricCollector	`IMetricCollector` 的基本實作項目，可在 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 和 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` 上開始及停止收集。
BluetoothConnectionLatencyCollector	收集器會將預先定義的 statsd 持續時間指標設定推送至裝置，並收集每個設定檔的藍牙連線時間。
BluetoothConnectionStateCollector	這個收集器會收集 BluetoothConnectionStateChanged 指標，並記錄每個設定檔的連線狀態編號。
BluetoothHciSnoopLogCollector	收集器，可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集每項測試的記錄。
BugreportzOnFailureCollector	在測試案例失敗時收集錯誤報告。
BugreportzOnTestCaseFailureCollector	在執行期間收集測試案例失敗的錯誤報告。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Clang 涵蓋率測量資料，並將其記錄為測試構件。
CodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Java 和原生涵蓋率評估結果，並將其記錄為測試構件。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
DebugHostLogOnFailureCollector	當測試案例失敗時，這個收集器會收集並記錄主機端記錄。
DeviceTraceCollector	在測試執行開始時啟動 Perfetto 追蹤，並在結束時記錄追蹤檔案的收集器。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` 會監聽來自裝置的評估指標鍵，並將這些指標以檔案形式從裝置中提取。
FilePullerLogCollector	裝置端回報的檔案記錄器。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 gcov 涵蓋率測量結果，並將其記錄為測試構件。
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` 會從 debugfs 和裝置中提取 gcov 核心涵蓋率測量值，然後將這些值記錄為測試構件。
HostStatsdMetricCollector	`IMetricCollector` 會使用 StatsD 公用程式指令，從主機端收集 StatsD 指標。
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Java 涵蓋率評估結果，並將其記錄為測試構件。
LogcatOnFailureCollector	收集器，可在測試案例失敗時擷取並記錄 Logcat。
LogcatTimingMetricCollector	指標收集器，可在一次或多次重複測試期間，使用指定的規則運算式，從 logcat 行剖析事件的開始和結束信號，收集時間資訊 (例如使用者切換時間)。
ModuleLogcatCollector	Logcat 收集器的版本，但適用於模組。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作項目，可從裝置中提取 Perfetto 檔案，並收集相關指標。
RebootReasonCollector	收集器會在測試執行期間收集裝置重新啟動情形，並依據原因和計數回報。
RuntimeRestartCollector	收集器會在測試執行期間收集執行階段重新啟動 (系統伺服器當機) 的時間戳記 (如有)。
ScreenshotOnFailureCollector	在測試案例失敗時，會擷取並記錄螢幕截圖的收集器。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作項目，可從裝置中提取 showmap 檔案，並收集相關指標。
TraceCmdCollector	`IMetricCollector` 會在測試期間使用 trace-cmd 收集追蹤記錄，並將這些記錄記錄到叫用作業中。

在回報測試結果時，系統會將此介面新增為修飾符，以便收集相符的指標。

即使此介面會延伸 ITestInvocationListener，也無法用於。設定檢查會拒絕這類內容。必須做為「metrics_collector」使用。

收集器不應保留內部狀態，因為收集器可能會在多個位置重複使用。如果真的需要使用內部狀態，請在 init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) 上清除。

摘要

公用方法
`default boolean`	`captureModuleLevel()` 收集器是否適用於模組層級擷取，以及是否應初始化。
`abstract`	`getBuildInfos()` 傳回可在叫用中使用的建構資訊清單。
`abstract`	`getDevices()` 傳回可在喚起動作中使用的裝置清單。
`abstract ITestInvocationListener`	`getInvocationListener()` 傳回原始的 `ITestInvocationListener`，我們會將結果轉寄至該處。
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` 使用目前的內容和轉送結果的位置，初始化收集器。
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` 當測試案例因假設失敗而失敗時的回呼。
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` 測試案例結束時的回呼。
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` 測試案例結束時的回呼。
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` 測試案例失敗時的回呼。
`default void`	`onTestModuleEnded()` 可擷取模組結束事件。
`default void`	`onTestModuleStarted()` 可擷取模組啟動事件。
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` 測試結束時的回呼。
`abstract void`	`onTestRunStart(DeviceMetricData runData)` 開始執行測試時的回呼。
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` 開始執行測試時的回呼。
`abstract void`	`onTestStart(DeviceMetricData testData)` 測試案例啟動時的回呼。

公用方法

captureModuleLevel

public boolean captureModuleLevel ()

收集器是否適用於模組層級擷取，以及是否應初始化。

傳回
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

傳回可在叫用中使用的建構資訊清單。

傳回

getDevices

public abstract  getDevices ()

傳回喚起動作中可用的裝置清單。

傳回

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

傳回原始的 ITestInvocationListener，我們會將結果轉寄至該處。

傳回
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

使用目前的內容和轉送結果的位置，初始化收集器。每個例項只會呼叫一次，且收集器應會更新其內部內容和事件監聽器。在測試執行期間，系統一律不會呼叫初始化。

除非您知道自己在做什麼，否則請勿覆寫。

參數
`context`	`IInvocationContext`：正在進行叫用作業的 `IInvocationContext`。
`listener`	`ITestInvocationListener`：放置結果的 `ITestInvocationListener`。

傳回
`ITestInvocationListener`	新的事件監聽器會包裝原始事件監聽器。

擲回
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

當測試案例因假設失敗而失敗時的回呼。

參數
`testData`	`DeviceMetricData`：保留測試案例資料的 `DeviceMetricData`。
`test`	`TestDescription`：進行中的測試案例 `TestDescription`。

擲回
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

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

參數
`testData`	`DeviceMetricData`：保留測試案例資料的 `DeviceMetricData`。會是 `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` 期間的相同物件。
`currentTestCaseMetrics`	：傳遞至 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的目前指標對應項目。
`test`	`TestDescription`：進行中的測試案例 `TestDescription`。

擲回
`DeviceNotAvailableException`

onTestEnd

public abstract 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`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

測試案例失敗時的回呼。

參數
`testData`	`DeviceMetricData`：保留測試案例資料的 `DeviceMetricData`。
`test`	`TestDescription`：進行中的測試案例 `TestDescription`。

擲回
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

可擷取模組結束事件。

擲回
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

可擷取模組啟動事件。

擲回
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

測試結束時的回呼。這時應該要清理了。

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

擲回
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

開始測試時的回呼。

參數
`runData`	`DeviceMetricData`：儲存執行作業資料的 `DeviceMetricData`。

擲回
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

開始測試時的回呼。

參數
`runData`	`DeviceMetricData`：儲存執行作業資料的 `DeviceMetricData`。
`testCount`	`int`：這個測試執行作業中的測試案例數量。

擲回
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

測試案例啟動時的回呼。

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

擲回
`DeviceNotAvailableException`