ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

已知的间接子类 StubTestRunListener、TestRunResult、TestRunToTestInvocationForwarder、XmlTestRunListener StubTestRunListener ITestRunListener 的存根实现 TestRunResult 保存单次测试运行的结果。  TestRunToTestInvocationForwarder 从 ddmlib 转发器 ITestRunListener 到 ITestLifeCycleReceiver。  XmlTestRunListener 以与 Ant 的 XMLJUnitResultFormatter 一致的格式将 JUnit 结果写入 XML 文件。

---

在插桩测试运行期间接收事件通知。

以 org.junit.runner.notification.RunListener 为蓝本

调用顺序如下：

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• [testRunFailed]
• testRunEnded

摘要

公共方法
abstract void	testAssumptionFailure(TestIdentifier test, String trace) 当原子测试标记其假设的条件为 false 时调用
abstract void	testEnded(TestIdentifier test, testMetrics) 报告单个测试用例的执行结束时间。
abstract void	testFailed(TestIdentifier test, String trace) 报告单个测试用例的失败。
abstract void	testIgnored(TestIdentifier test) 当测试不会运行时（通常是因为测试方法使用 org.junit.Ignore 注释）调用。
abstract void	testRunEnded(long elapsedTime, runMetrics) 报告测试运行结束。
abstract void	testRunFailed(String errorMessage) 报告测试运行因严重错误而未能完成。
abstract void	testRunStarted(String runName, int testCount) 报告测试运行的开始。
abstract void	testRunStopped(long elapsedTime) 此方法已弃用。 此回调永远不会被调用。待删除。
abstract void	testStarted(TestIdentifier test) 报告单个测试用例的开始。

公共方法

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

当原子测试标记其假设的条件为 false 时调用

参数
test	TestIdentifier：用于标识测试
trace	String：失败的堆栈轨迹

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

报告单个测试用例的执行结束时间。

如果未调用 testFailed(TestIdentifier, String)，则此测试通过。还会返回测试用例执行期间可能发出的任何键值指标。

参数
test	TestIdentifier：用于标识测试
testMetrics	：android.app.Instrumentation#sendStatus 在执行测试用例期间发出的指标的 ERROR(/Map)。除非您多次发出同一键，否则系统会保留插入顺序。请注意，IInstrumentationResultParser.StatusKeys 中定义的标准键会从此映射中过滤掉。Ddmlib 可能会添加 IInstrumentationResultParser.StatusKeys 中定义的额外测试指标。

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

报告单个测试用例的失败。

将在 testStarted 和 testEnded 之间调用。

参数
test	TestIdentifier：用于标识测试
trace	String：失败的堆栈轨迹

testIgnored

public abstract void testIgnored (TestIdentifier test)

当测试不会运行时（通常是因为测试方法使用 org.junit.Ignore 注释）调用。

参数
test	TestIdentifier：用于标识测试

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

报告测试运行结束。

参数
elapsedTime	long：设备报告的已用时间，以毫秒为单位
runMetrics	：android.app.Instrumentation#addResults 在执行测试用例期间发出的指标的 ERROR(/Map)。除非您多次发出同一键，否则系统会保留插入顺序。请注意，IInstrumentationResultParser.StatusKeys 中定义的标准键会从此映射中过滤掉。Ddmlib 可能会添加 IInstrumentationResultParser.StatusKeys 中定义的额外测试指标。

testRunFailed

public abstract void testRunFailed (String errorMessage)

报告测试运行因出现严重错误而未能完成。

参数
errorMessage	String：描述运行失败原因的 String。

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

报告测试运行的开始。

参数
runName	String：测试运行名称
testCount	int：测试运行中的测试总数

testRunStopped

public abstract void testRunStopped (long elapsedTime)

此方法已弃用。
此回调永远不会被调用。待删除。

报告测试运行因用户请求而在完成前停止。

参数
elapsedTime	long：设备报告的已用时间，以毫秒为单位

testStarted

public abstract void testStarted (TestIdentifier test)

报告单个测试用例的开始。

参数
test	TestIdentifier：用于标识测试