此页面由 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)

报告测试运行结束。FIXME：不能有两个 Map<>具有不同类型的接口我们在这里必须使用 HashMap。

参数
`elapsedTimeMillis`	`long`：设备报告的所用时间（以毫秒为单位）
`runMetrics`	：通过 `Metric` 运行测试运行结束时报告的键值对。

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`：标识测试