XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

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

---

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

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

另见：

• https://svn.jenkins-ci.org/trunk/hudson/dtkit/dtkit-format/dtkit-junit-model/src/main/resources/com/thalesgroup/dtkit/junit/model/xsd/junit-4.xsd

摘要

公共构造函数
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