ITestRunListener
public
interface
ITestRunListener
| com.android.ddmlib.testrunner.ITestRunListener |
在插桩测试运行期间接收事件通知。
以 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,
报告单个测试用例的执行结束时间。 |
abstract
void
|
testFailed(TestIdentifier test, String trace)
报告单个测试用例的失败。 |
abstract
void
|
testIgnored(TestIdentifier test)
当测试不会运行时（通常是因为测试方法使用 org.junit.Ignore 注释）调用。 |
abstract
void
|
testRunEnded(long elapsedTime,
报告测试运行结束。 |
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：用于标识测试 |