XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

java.lang.Object
   ↳ com.android.ddmlib.testrunner.XmlTestRunListener

以与 Ant 的 XMLJUnitResultFormatter 一致的格式将 JUnit 结果写入 XML 文件。

为每次测试运行创建单独的 XML 文件。

摘要

公共构造函数

XmlTestRunListener()

公共方法

void addSystemError(String systemError)

添加了系统错误消息。

TestRunResult getRunResult()

返回 TestRunResult

String getSystemError()

返回要写入 XML 文件中“system-err”元素的系统错误消息。

void setHostName(String hostName)
void setReportDir(File file)

设置要使用的报告文件。

void testAssumptionFailure(TestIdentifier test, String trace)

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

void testEnded(TestIdentifier test, testMetrics)

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

void testFailed(TestIdentifier test, String trace)

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

void testIgnored(TestIdentifier test)

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

void testRunEnded(long elapsedTime, runMetrics)

报告测试运行结束。

void testRunFailed(String errorMessage)

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

void testRunStarted(String runName, int numTests)

报告测试运行的开始。

void testRunStopped(long elapsedTime)

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

void testStarted(TestIdentifier test)

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

受保护的方法

getPropertiesAttributes()

以键值对的形式获取要纳入测试报告中的属性。

File getResultFile(File reportDir)

创建将用于创建报告的 ERROR(/File)。

String getTestName(TestIdentifier testId)
String getTestSuiteName()

公共构造函数

XmlTestRunListener

public XmlTestRunListener ()

公共方法

addSystemError

public void addSystemError (String systemError)

添加了系统错误消息。

参数
systemError String

getRunResult

public TestRunResult getRunResult ()

返回 TestRunResult

返回
TestRunResult 测试运行结果。

getSystemError

public String getSystemError ()

返回要写入 XML 文件中“system-err”元素的系统错误消息。如果此方法返回空字符串，则不会创建相应元素。

返回
String

setHostName

public void setHostName (String hostName)

参数
hostName String

setReportDir

public void setReportDir (File file)

设置要使用的报告文件。

参数
file File

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public void testEnded (TestIdentifier test, 
                 testMetrics)

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

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

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

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

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

将在 testStarted 和 testEnded 之间调用。

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

testIgnored

public void testIgnored (TestIdentifier test)

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

参数
test TestIdentifier：用于标识测试

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

报告测试运行结束。

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int numTests)

报告测试运行的开始。

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

testStarted

public void testStarted (TestIdentifier test)

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

参数
test TestIdentifier：用于标识测试

受保护的方法

getPropertiesAttributes

protected  getPropertiesAttributes ()

以键值对的形式获取要纳入测试报告中的属性。

返回

getResultFile

protected File getResultFile (File reportDir)

创建将用于创建报告的 ERROR(/File)。

参数
reportDir File：报告的根目录。
返回
File 文件
抛出
IOException

getTestName

protected String getTestName (TestIdentifier testId)

参数
testId TestIdentifier

返回
String

getTestSuiteName

protected String getTestSuiteName ()

返回
String