Tradefed 的配置遵循 XML 结构来描述要运行的测试和要完成的准备/设置步骤。
理论上,可以在 XML 中为单个命令定义所有内容。但在实践中,拥有基本模板 XML 文件并使用额外的命令行参数自定义它们更为实用。
结构
<configuration description="<description of the configuration>">
<!-- A build provider that takes local device information -->
<build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />
<!-- Some target preparation, disabled by default -->
<target_preparer class="com.android.tradefed.targetprep.PreloadedClassesPreparer">
<option name="disable" value="true" />
</target_preparer>
<!-- One test running some unit tests -->
<test class="com.android.tradefed.testtype.HostTest">
<option name="class" value="com.android.tradefed.build.BuildInfoTest" />
</test>
<!-- [OPTIONAL] -->
<logger class="com.android.tradefed.log.FileLogger">
<option name="log-level" value="VERBOSE" />
<option name="log-level-display" value="VERBOSE" />
</logger>
<!-- [OPTIONAL] -->
<log_saver class="com.android.tradefed.result.FileSystemLogSaver" />
<!-- As many reporters as we want -->
<result_reporter class="com.android.tradefed.result.ConsoleResultReporter" />
<result_reporter class="com.android.tradefed.result.suite.SuiteResultReporter" />
<result_reporter class="com.android.tradefed.result.MetricsXMLResultReporter"/>
</configuration>
整个 Tradefed XML 由<configuration>
标记分隔。 Tradefed objects
在它们自己的标签中定义,例如: build_provider
、 target_preparer
、 test
等。它们各自的用途在架构部分中有更详细的描述。
每个对象都有一个与定义在class=
中的对象相关联的 Java 类,该对象在运行时解析;因此只要包含该类的 JAR 文件在运行时位于 Tradefed Java 类路径上,就会被找到并解析。
Tradefed 对象的订单
不同标签的顺序无关紧要。例如,如果build_provider
在target_preparer
之后指定,则没有区别。测试调用的流程由工具本身强制执行,因此它将始终以正确的顺序调用它们。
具有相同标签的对象的顺序很重要。例如,定义的两个target_preparer
对象将按照它们在 XML 中的定义顺序被调用。理解这一点很重要,因为它可以改变设备设置的最终状态。例如,刷机然后安装 apk与安装 apk 并刷机不同,因为刷机会擦除设备。