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

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

IMetricCollector

public interface IMetricCollector
implements ILogSaverListener, IDisableable

com.android.tradefed.device.metric.IMetricCollector

已知間接子類別

BaseDeviceMetricCollector	`IMetricCollector` 的基本實作項目，可在 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 和 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` 上開始及停止收集。
BugreportzOnFailureCollector	在測試案例失敗時收集錯誤報告。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Clang 涵蓋率測量資料，並將其記錄為測試構件。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
DebugHostLogOnFailureCollector	收集器，可在發生測試案例失敗時，收集及記錄主機端記錄檔。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` 會監聽來自裝置的評估指標鍵，並將這些指標以檔案形式從裝置中提取。
FilePullerLogCollector	裝置端回報的檔案記錄器。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 gcov 涵蓋率測量結果，並將這些結果記錄為測試構件。
JavaCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Java 涵蓋率評估結果，並將其記錄為測試構件。
LogcatOnFailureCollector	收集器，可在測試案例失敗時擷取並記錄 Logcat。
ScreenshotOnFailureCollector	在測試案例失敗時，會擷取並記錄螢幕截圖的收集器。

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

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

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

摘要

公用方法
`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)` 測試案例結束時的回呼。
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` 測試案例結束時的回呼。
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` 測試案例失敗時的回呼。
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` 測試結束時的回呼。
`abstract void`	`onTestRunStart(DeviceMetricData runData)` 開始執行測試時的回呼。
`abstract void`	`onTestStart(DeviceMetricData testData)` 測試案例啟動時的回呼。

public abstract  getBuildInfos ()

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

傳回

public abstract  getDevices ()

傳回可在喚起作業中使用的裝置清單。

傳回

public abstract ITestInvocationListener getInvocationListener ()

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

傳回
`ITestInvocationListener`

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

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

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

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

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

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

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

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

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

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

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

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

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

測試案例失敗時的回呼。

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

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

public abstract void onTestRunStart (DeviceMetricData runData)

開始測試時的回呼。

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

public abstract void onTestStart (DeviceMetricData testData)

測試案例啟動時的回呼。

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