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

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

TestResultListener

public abstract class TestResultListener
extends Object implements ITestLifeCycleReceiver

java.lang.Object
↳	com.android.tradefed.result.TestResultListener

已知的直接子類別

ConsoleResultReporter	結果回報器，可將測試結果列印到控制台。
CountingTestResultListener	`TestResultListener`，可追蹤 `TestStatus` 的測試總數
PassingTestFileReporter	將通過測試的測試案例清單儲存至測試檔案的 `ITestInvocationListener`

針對只在乎個別測試結果的實作者，簡化 ITestLifecycleListener。

它會將各種生命週期事件篩選為 testResult 方法。

這並非執行緒安全，特別是假設 ITestLifecycleListener 事件會依序收到。

摘要

公用建構函式
`TestResultListener()`

公用方法
`final void`	`testAssumptionFailure(TestDescription test, String trace)` 當原子測試標記假設條件為 false 時，系統會呼叫此方法
`final void`	`testEnded(TestDescription test, testMetrics)` 回報個別測試案例的執行結束時間。
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)` `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的替代方案，可直接指定結束時間。
`final void`	`testFailed(TestDescription test, String trace)` 回報個別測試案例的失敗情形。
`final void`	`testIgnored(TestDescription test)` 當測試不會執行時，系統會呼叫此方法，通常是因為測試方法已標記為 org.junit.Ignore。
`abstract void`	`testResult(TestDescription test, TestResult result)`
`void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` 回報測試執行結束。
`void`	`testSkipped(TestDescription test, SkipReason reason)` 當測試遭到略過，且未因通常預期的原因而執行時，系統會呼叫此方法。
`final void`	`testStarted(TestDescription test, long startTime)` `testStarted(com.android.tradefed.result.TestDescription)` 的替代方案，我們也會指定測試開始時間，並搭配 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` 進行精確評估。
`final void`	`testStarted(TestDescription test)` 回報個別測試案例的開始時間。

public TestResultListener ()

public final void testAssumptionFailure (TestDescription test, 
                String trace)

當原子測試標記假設條件為 false 時，系統會呼叫此方法

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

public final void testEnded (TestDescription test, 
                 testMetrics)

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

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

參數
`test`	`TestDescription`：用於識別測試
`testMetrics`	：傳送指標的 `ERROR(/Map)`

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

參數
`test`	`TestDescription`：用於識別測試
`endTime`	`long`：測試結束的時間，透過 `System.currentTimeMillis()` 測量
`testMetrics`	：傳送指標的 `ERROR(/Map)`

public final void testFailed (TestDescription test, 
                String trace)

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

會在 testStarted 和 testEnded 之間呼叫。

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

public final void testIgnored (TestDescription test)

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

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

public abstract void testResult (TestDescription test, 
                TestResult result)

參數
`test`	`TestDescription`
`result`	`TestResult`

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

回報測試執行結束。

參數
`elapsedTimeMillis`	`long`：裝置回報的經過時間，以毫秒為單位
`runMetrics`	：測試執行結束時回報的鍵/值組合

public void testSkipped (TestDescription test, 
                SkipReason reason)

當測試遭到略過，且未因通常預期的原因而執行時，系統會呼叫此方法。系統會嘗試重試這些測試，以便取得正確的執行結果。

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

public final void testStarted (TestDescription test, 
                long startTime)

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

public final void testStarted (TestDescription test)

回報個別測試案例的開始時間。較舊的介面，應盡可能使用 testStarted(com.android.tradefed.result.TestDescription)。

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