為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

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

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

已知的直接子類別

AtraceCollector	`IMetricCollector`：在測試期間執行追蹤，並收集結果和記錄到呼叫中。
BugreportzOnFailureCollector	測試案例失敗時，收集 bugreportz。
BugreportzOnTestCaseFailureCollector	在執行測試案例時，如果發生失敗情形，請收集錯誤報告。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Clang 涵蓋範圍測量結果，並將其記錄為測試構件。
CodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Java 和原生涵蓋範圍測量結果，並將其記錄為測試構件。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
DebugHostLogOnFailureCollector	收集器會在測試案例失敗時收集並記錄主機端記錄。
DeviceTraceCollector	這個收集器會在測試執行開始時啟動 Perfetto 追蹤記錄，並在結束時記錄追蹤記錄檔。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector`，可監聽裝置傳來的指標金鑰，並從裝置中擷取這些金鑰做為檔案。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 gcov 涵蓋範圍測量結果，並將其記錄為測試構件。
GcovKernelCodeCoverageCollector	這項工具會從 debugfs 和裝置中提取 gcov 核心涵蓋範圍測量結果，然後將這些結果記錄為測試構件。`BaseDeviceMetricCollector`
HostStatsdMetricCollector	`IMetricCollector`：使用 statsd 公用程式指令從主機端收集 statsd 指標。
JavaCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Java 涵蓋範圍測量結果，並將其記錄為測試構件。
LogcatOnFailureCollector	收集器：在測試案例或測試執行失敗時擷取並記錄 logcat。
LogcatTimingMetricCollector	指標收集器，可使用指定的 regex 模式剖析 logcat 行中的事件開始和結束信號，在一次或多次重複測試期間，從 logcat 收集時間資訊 (例如使用者切換時間)。
ModulePerfettoCollector	這個收集器會在測試模組啟動/結束時和裝置重新啟動時，啟動 perfetto 追蹤。
RebootReasonCollector	收集測試執行期間裝置重新啟動的次數，並依據原因和次數回報。
RuntimeRestartCollector	收集器，用於收集測試執行期間的執行階段重新啟動時間戳記 (系統伺服器當機)，如有。
ScreenRecordOnFailureCollector	收集器會在測試案例失敗時擷取並記錄螢幕錄影。
ScreenshotOnFailureCollector	收集器，會在測試案例失敗時擷取並記錄螢幕截圖。

已知間接子類別

AtraceRunMetricCollector、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothHciSnoopLogCollector、FilePullerLogCollector、ModuleLogcatCollector、PerfettoFilePullerCollector、PerfettoPullerMetricCollector、ShowmapPullerMetricCollector、TraceCmdCollector

AtraceRunMetricCollector	從測試裝置收集指定目錄下所有測試目錄的追蹤記錄、記錄測試目錄，並後續處理測試目錄下的追蹤記錄檔案，以及匯總指標。
BluetoothConnectionLatencyCollector	收集器會將預先定義的 statsd 持續時間指標設定推送至裝置，並收集每個設定檔的藍牙連線持續時間。
BluetoothConnectionStateCollector	這個收集器會收集 BluetoothConnectionStateChanged 指標，並記錄每個設定檔的連線狀態編號。
BluetoothHciSnoopLogCollector	收集器，用於在 DUT 上啟用藍牙 HCI 窺探記錄，並收集各項測試的記錄。
FilePullerLogCollector	記錄裝置端回報的檔案。
ModuleLogcatCollector	Logcat 收集器版本，但適用於模組。
PerfettoFilePullerCollector	收集器會從裝置提取 Perfetto 追蹤記錄檔案，並視需要壓縮檔案，然後將檔案新增至測試記錄。
PerfettoPullerMetricCollector	這個類別已淘汰。請改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作，可從裝置中提取 showmap 檔案，並從中收集指標。
TraceCmdCollector	`IMetricCollector`：使用 trace-cmd 在測試期間收集追蹤記錄，並將記錄寫入呼叫。

IMetricCollector 的基本實作，可讓您在 onTestRunStart(DeviceMetricData) 和 onTestRunEnd(DeviceMetricData,Map) 上開始及停止收集資料。

摘要

常數
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

公用建構函式
`BaseDeviceMetricCollector()`

公用方法
`boolean`	`doesModuleContainFailure()` 如果目前模組包含任何測試案例或測試執行失敗，則傳回 true。
`void`	`enableDefaultMetricCollection()` 允許收集器啟用預設指標收集功能。
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`final List<IBuildInfo>`	`getBuildInfos()` 傳回可供呼叫使用的建構資訊清單。
`final List<ITestDevice>`	`getDevices()` 傳回呼叫中可用的裝置清單。
`File`	`getFileFromTestArtifacts(String fileName)` 從測試構件或模組構件擷取檔案，並在對應中快取檔案，以供後續呼叫。
`final ITestInvocationListener`	`getInvocationListener()` 傳回轉送結果的原始 `ITestInvocationListener`。
`String`	`getModuleName()`
`IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`final List<ITestDevice>`	`getRealDevices()` 從 `getDevices()` 清單傳回所有非虛設常式裝置。
`String`	`getRunName()` 傳回觸發收集器的測試執行 `mRunName` 名稱。
`String`	`getTestName()` 傳回觸發收集器的測試名稱 `mTestName`。
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` 使用目前環境初始化收集器，並指定轉送結果的位置。
`final void`	`invocationEnded(long elapsedTime)` 回報是否因某種錯誤狀況而終止呼叫 (無論是否成功)。
`final void`	`invocationFailed(FailureDescription failure)` Reports an incomplete invocation due to some error condition.
`final void`	`invocationFailed(Throwable cause)` Reports an incomplete invocation due to some error condition.
`void`	`invocationSkipped(SkipReason reason)` 回報已略過的叫用
`final void`	`invocationStarted(IInvocationContext context)` 轉送的叫用事件監聽器
`boolean`	`isDefaultMetricCollectionEnabled()` 收集器是否正在收集指標，做為預設指標收集作業的一部分。
`final boolean`	`isDisabled()` 如果整個物件都已停用 (略過設定和終止)，則傳回 True。
`boolean`	`isDisabledReceiver()` `IDeviceActionReceiver` 是否已停用。
`final void`	`logAssociation(String dataName, LogFile logFile)` Do not use inside metric collector implementation.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` 測試案例因假設失敗而失敗時的回呼。
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` 測試案例結束時的回呼。
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` 測試案例結束時的回呼。
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` 測試案例失敗時的回呼。
`void`	`onTestModuleEnded()` 允許擷取模組結束事件。
`void`	`onTestModuleStarted()` 允許擷取模組啟動事件。
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` 測試作業結束時的回呼。
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` 測試執行失敗事件的回呼
`void`	`onTestRunStart(DeviceMetricData runData)` 測試執行開始時的回呼。
`void`	`onTestStart(DeviceMetricData testData)` 測試案例啟動時的回呼。
`void`	`rebootEnded(ITestDevice device)` 裝置重新啟動後會收到通知。
`void`	`rebootStarted(ITestDevice device)` 裝置開始重新啟動時收到通知。
`void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` 設定收集器應收集記錄的層級，無論是否發生失敗。
`final void`	`setDisable(boolean isDisabled)` 設定是否應停用物件。
`void`	`setDisableReceiver(boolean isDisabled)` 設定是否應停用 `IDeviceActionReceiver`。
`final void`	`setLogSaver(ILogSaver logSaver)` Do not use inside metric collector implementation.
`void`	`setModuleContainsFailure()` 設定模組是否有任何失敗 (測試案例、測試執行)。
`void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Sets the level at which the collector should collect logs during failures.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` 當原子測試標記假設為 false 的條件時，系統會呼叫這個函式
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` 當原子測試標記假設為 false 的條件時，系統會呼叫這個函式
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` `testEnded(TestDescription,Map)` 的替代方案，可直接指定結束時間。
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` 回報個別測試案例的執行結束時間。
`final void`	`testFailed(TestDescription test, FailureDescription failure)` 回報個別測試案例的失敗情形。
`final void`	`testFailed(TestDescription test, String trace)` 回報個別測試案例的失敗情形。
`final void`	`testIgnored(TestDescription test)` 當測試不會執行時呼叫，通常是因為測試方法以 org.junit.Ignore 註解標註。
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` 提供測試呼叫的相關記錄或偵錯資料。
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Do not use inside metric collector implementation.
`final void`	`testModuleEnded()` 回報模組執行作業的結束時間。
`final void`	`testModuleStarted(IInvocationContext moduleContext)` 回報模組的執行開始時間。
`final void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Reports end of test run.
`final void`	`testRunFailed(FailureDescription failure)` 由於 `FailureDescription` 所述的錯誤，報表測試執行作業無法完成。
`final void`	`testRunFailed(String errorMessage)` 發生嚴重錯誤，因此無法完成報表測試執行。
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` 回報測試執行的開始。
`final void`	`testRunStarted(String runName, int testCount)` 測試執行回呼
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` 回報測試執行的開始。
`final void`	`testRunStopped(long elapsedTime)` 由於使用者要求，報表測試執行作業在完成前停止。
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Called when a test is skipped and did not execute for a reason that is not usually expected.
`final void`	`testStarted(TestDescription test, long startTime)` `testStarted(TestDescription)` 的替代方案，我們也會指定測試開始時間，並搭配 `testEnded(TestDescription,long,Map)` 進行準確的評估。
`final void`	`testStarted(TestDescription test)` 測試案例回呼

常數

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

常數值： "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

常數值： "test-case-include-group"

公用建構函式

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

公用方法

doesModuleContainFailure

public boolean doesModuleContainFailure ()

如果目前模組包含任何測試案例或測試執行失敗，則傳回 true。

傳回
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

允許收集器啟用預設指標收集功能。啟用預設指標收集功能後，收集器應只在指定的收集層級收集資料。

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

傳回
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

傳回可供呼叫使用的建構資訊清單。

傳回
`List<IBuildInfo>`

getDevices

public final List<ITestDevice> getDevices ()

傳回呼叫中可用的裝置清單。

傳回
`List<ITestDevice>`

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

從測試構件或模組構件擷取檔案，並在對應中快取檔案，以供後續呼叫。

參數
`fileName`	`String`：要在構件中查閱的檔案名稱。

傳回
`File`	測試構件或模組構件中的檔案。如果找不到檔案，則傳回 null。

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

傳回要轉送結果的原始 ITestInvocationListener。

傳回
`ITestInvocationListener`

getModuleName

public String getModuleName ()

傳回
`String`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

傳回
`IMetricCollector.MetricCollectionLevel`

getRealDevices

public final List<ITestDevice> getRealDevices ()

從 getDevices() 清單傳回所有非虛設裝置。

傳回
`List<ITestDevice>`

getRunName

public String getRunName ()

傳回觸發收集器的測試執行 mRunName 名稱。

傳回
`String`	mRunName，目前的測試執行名稱。

getTestName

public String getTestName ()

傳回觸發收集器的測試 mTestName 名稱。

傳回
`String`	mTestName，目前的測試名稱。

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

使用目前環境初始化收集器，並指定轉送結果的位置。每個執行個體只會呼叫一次，收集器應更新其內部環境和接聽程式。在測試執行期間，系統一律不會呼叫 Init，而是會先呼叫。

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

參數
`context`	`IInvocationContext`：正在進行的呼叫的 `IInvocationContext`。
`listener`	`ITestInvocationListener`：要放置結果的 `ITestInvocationListener`。

傳回
`ITestInvocationListener`	新監聽器包裝原始監聽器。

擲回
`DeviceNotAvailableException`

invocationEnded

public final void invocationEnded (long elapsedTime)

回報是否因某種錯誤情況而終止呼叫 (無論是否成功)。

TradeFederation 架構會自動呼叫。

參數
`elapsedTime`	`long`：以毫秒為單位的呼叫經過時間

invocationFailed

public final void invocationFailed (FailureDescription failure)

由於發生某些錯誤情況，因此回報不完整的叫用。

TradeFederation 架構會自動呼叫。

參數
`failure`	`FailureDescription`：說明失敗原因的 `FailureDescription`

invocationFailed

public final void invocationFailed (Throwable cause)

由於發生某些錯誤情況，因此回報不完整的叫用。

TradeFederation 架構會自動呼叫。

參數
`cause`	`Throwable`：`Throwable` 失敗的原因

invocationSkipped

public void invocationSkipped (SkipReason reason)

將叫用回報為已略過

參數
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

轉送的叫用事件監聽器

參數
`context`	`IInvocationContext`：叫用相關資訊

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

收集器是否正在收集指標，做為預設指標收集作業的一部分。

傳回
`boolean`

isDisabled

public final boolean isDisabled ()

如果整個物件都已停用 (略過設定和終止)，則傳回 True。否則傳回「false」。

傳回
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver 是否已停用。

傳回
`boolean`	如果已停用，則傳回 true，否則傳回 false。

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

請勿在指標收集器實作中使用。這屬於純轉寄。

參數
`dataName`	`String`：資料名稱
`logFile`	`LogFile`：先前記錄的 `LogFile`，應與測試案例建立關聯。

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

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

擲回
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

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

參數
`testData`	`DeviceMetricData`：保存測試案例資料的 `DeviceMetricData`。與 `onTestStart(DeviceMetricData)` 期間的物件相同。
`currentTestCaseMetrics`	`Map`：傳遞至 `testEnded(TestDescription,Map)` 的指標目前對應。

擲回
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

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

參數
`testData`	`DeviceMetricData`：保存測試案例資料的 `DeviceMetricData`。與 `onTestStart(DeviceMetricData)` 期間的物件相同。
`currentTestCaseMetrics`	`Map`：傳遞至 `testEnded(TestDescription,Map)` 的指標目前對應。
`test`	`TestDescription`：進行中測試案例的 `TestDescription`。

擲回
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

測試案例失敗時的回呼。

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

擲回
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

允許擷取模組結束事件。

擲回
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

允許擷取模組啟動事件。

擲回
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

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

參數
`runData`	`DeviceMetricData`：`DeviceMetricData`，其中包含執行作業的資料。與 `onTestRunStart(DeviceMetricData)` 期間的物件相同。
`currentRunMetrics`	`Map`：傳遞至 `testRunEnded(long,Map)` 的指標目前對應。

擲回
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

testRunFailed 事件的回呼

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

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

測試執行開始時的回呼。

參數
`runData`	`DeviceMetricData`：`DeviceMetricData`，其中包含執行作業的資料。

擲回
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

測試案例啟動時的回呼。

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

擲回
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

在裝置重新啟動後收到通知。

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

參數
`device`	`ITestDevice`：重新啟動作業的結束時間。`ITestDevice`

擲回
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

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

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

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

擲回
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

設定收集器應收集記錄的層級，無論是否發生故障。

如果層級為 NULL，系統就不會收集資料。

參數
`level`	`IMetricCollector.MetricCollectionLevel`：收集記錄的 `MetricCollectionLevel`。

setDisable

public final void setDisable (boolean isDisabled)

設定是否應停用物件。如果設為「Disabled」，表示應略過設定和拆除步驟。可用於在預設建構函式中，預設停用物件。

參數
`isDisabled`	`boolean`：物件應處於的狀態。

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

設定是否應停用 IDeviceActionReceiver。停用後，裝置不會註冊接收裝置動作事件。

參數
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

請勿在指標收集器實作中使用。這屬於純轉寄。

參數
`logSaver`	`ILogSaver`：`ILogSaver`

setModuleContainsFailure

public void setModuleContainsFailure ()

設定模組是否有任何失敗 (測試案例、測試執行)。

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

設定收集器在發生失敗時應收集記錄的層級。

如果層級為 NULL，系統就不會收集資料。

參數
`level`	`IMetricCollector.MetricCollectionLevel`：收集記錄的 `MetricCollectionLevel`。

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

當原子測試標記假設為 false 的條件時呼叫

參數
`test`	`TestDescription`：識別測試
`trace`	`String`：失敗的堆疊追蹤

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

當原子測試標記假設為 false 的條件時呼叫

參數
`test`	`TestDescription`：識別測試
`failure`	`FailureDescription`：說明失敗情形和相關情境的 `FailureDescription`。

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

testEnded(TestDescription,Map) 的替代方案，可直接指定結束時間。搭配 testStarted(TestDescription,long) 使用，可準確測量。

參數
`test`	`TestDescription`：識別測試
`endTime`	`long`：測試結束時間，透過 `System.currentTimeMillis()` 測量
`testMetrics`	`HashMap`：發出的指標 `Map`

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

回報個別測試案例的執行結束時間。

如果未叫用 testFailed(TestDescription, FailureDescription)，這項測試就會通過。也會傳回測試案例執行期間可能發出的任何鍵/值指標。

參數
`test`	`TestDescription`：識別測試
`testMetrics`	`HashMap`：發出的指標 `Map`

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

回報個別測試案例的失敗情形。

會在 testStarted 和 testEnded 之間呼叫。

參數
`test`	`TestDescription`：識別測試
`failure`	`FailureDescription`：說明失敗情形和相關情境的 `FailureDescription`。

testFailed

public final void testFailed (TestDescription test, 
                String trace)

回報個別測試案例的失敗情形。

會在 testStarted 和 testEnded 之間呼叫。

參數
`test`	`TestDescription`：識別測試
`trace`	`String`：失敗的堆疊追蹤

testIgnored

public final void testIgnored (TestDescription test)

當測試不會執行時呼叫，通常是因為測試方法以 org.junit.Ignore 註解標註。

參數
`test`	`TestDescription`：識別測試

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

提供測試呼叫的相關記錄或偵錯資料。

必須在 ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) 或 ERROR(/ITestInvocationListener#invocationEnded(long)) 之前呼叫

TradeFederation 架構會自動呼叫這個方法，提供主機記錄和裝置 logcat (如適用)。

參數
`dataName`	`String`：資料的`String`說明名稱，例如「device_logcat」。注意：dataName 在每次呼叫時可能不具唯一性，也就是說，實作者必須能夠處理具有相同 dataName 的多項呼叫。
`dataType`	`LogDataType`：資料的 `LogDataType`
`dataStream`	`InputStreamSource`：資料的 `InputStreamSource`。實作者應呼叫 createInputStream 開始讀取資料，並確保在完成時關閉產生的 InputStream。呼叫端應確保資料來源持續存在且可存取，直到 testLog 方法完成為止。

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

請勿在指標收集器實作中使用。這屬於純轉寄。

參數
`dataName`	`String`：資料的`String`說明名稱，例如「device_logcat」。注意：dataName 在每次呼叫時可能不具唯一性，也就是說，實作者必須能夠處理具有相同 dataName 的多項呼叫。
`dataType`	`LogDataType`：資料的 `LogDataType`
`dataStream`	`InputStreamSource`：資料的 `InputStreamSource`。實作者應呼叫 createInputStream 開始讀取資料，並確保在完成時關閉產生的 InputStream。
`logFile`	`LogFile`：包含已儲存檔案中繼資料的 `LogFile`。

testModuleEnded

public final void testModuleEnded ()

回報模組執行作業的結束時間。

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

回報模組的執行開始時間。這個回呼與 testModuleEnded() 相關聯，且在序列中為選用項目。只有在使用模組的執行期間，才會使用這個標記：以套件為基礎的執行器。

參數
`moduleContext`	`IInvocationContext`：模組的 `IInvocationContext`。

testRunEnded

public final void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

測試執行結束時會回報。FIXME：我們無法使用不同型別的兩個 Map<> 介面，因此必須在此使用 HashMap。

參數
`elapsedTime`	`long`：裝置回報的經過時間 (以毫秒為單位)
`runMetrics`	`HashMap`：在測試執行結束時，使用 `Metric` 報告的鍵/值組合。

testRunFailed

public final void testRunFailed (FailureDescription failure)

由於 FailureDescription 所述的錯誤，報表測試執行作業無法完成。

參數
`failure`	`FailureDescription`：說明失敗情形和相關情境的 `FailureDescription`。

testRunFailed

public final void testRunFailed (String errorMessage)

發生嚴重錯誤，因此無法完成報表測試執行作業。

參數
`errorMessage`	`String`：`String`，說明執行失敗的原因。

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

回報測試執行的開始時間。

參數
`runName`	`String`：測試執行名稱
`testCount`	`int`：測試執行作業中的測試總數
`attemptNumber`	`int`：訂單號碼，用於識別多次執行的相同 runName 的不同嘗試。attemptNumber 是以 0 為索引，每次執行新作業時都應遞增。舉例來說，如果測試精細重試 3 次，則在相同 runName 下應有 4 次執行作業，且 attemptNumber 為 0 到 3。

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

測試執行回呼

參數
`runName`	`String`：測試執行名稱
`testCount`	`int`：測試執行作業中的測試總數

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

回報測試執行的開始時間。

參數
`runName`	`String`：測試執行名稱
`testCount`	`int`：測試執行作業中的測試總數
`attemptNumber`	`int`：訂單號碼，用於識別多次執行的相同 runName 的不同嘗試。attemptNumber 是以 0 為索引，每次執行新作業時都應遞增。舉例來說，如果測試精細重試 3 次，則在相同 runName 下應有 4 次執行，且 attemptNumber 為 0 到 3。
`startTime`	`long`：跑步開始時間，透過 `System.currentTimeMillis()` 測量

testRunStopped

public final void testRunStopped (long elapsedTime)

由於使用者要求，報表測試執行作業在完成前停止。

TODO：目前未使用，考慮移除

參數
`elapsedTime`	`long`：裝置回報的經過時間 (以毫秒為單位)

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Called when a test is skipped and did not execute for a reason that is not usually expected. 系統會嘗試重試這些測試，以確保正常執行。

參數
`test`	`TestDescription`：識別測試
`reason`	`SkipReason`：`SkipReason`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

testStarted(TestDescription) 的替代方案，我們也會指定測試開始時間，並搭配 testEnded(TestDescription,long,Map) 進行準確的評估。

參數
`test`	`TestDescription`：識別測試
`startTime`	`long`：測試開始時間，透過 `System.currentTimeMillis()` 測量

testStarted

public final void testStarted (TestDescription test)

測試案例回呼

參數
`test`	`TestDescription`：識別測試