模块配置的总体结构遵循与常规 Tradefed XML 配置类似的模式，但由于它们作为套件的一部分运行，因此存在一些限制。
允许的标记列表
AndroidTest.xml 或更广泛的模块配置只能包含以下 XML 标记：target_preparer、multi_target_preparer、test 和 metrics_collector。
尽管此列表看起来限制性很强，但它允许您精确定义测试模块设置需求和要运行的测试。
注意：如果您需要复习不同的标记，请参阅Tradefed XML 配置。
如果尝试从模块配置内部运行 build_provider 或 result_reporter 等对象，则会引发 ConfigurationException。这旨在避免期望这些对象实际在模块中执行某些任务。
模块配置示例
<configuration description="Config for CTS Gesture test cases">
<option name="test-suite-tag" value="cts" />
<target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
<option name="cleanup-apks" value="true" />
<option name="test-file-name" value="CtsGestureTestCases.apk" />
</target_preparer>
<test class="com.android.tradefed.testtype.AndroidJUnitTest" >
<option name="package" value="android.gesture.cts" />
<option name="runtime-hint" value="10m50s" />
</test>
</configuration>
此配置描述了一项测试，该测试需要安装 CtsGestureTestCases.apk，并将针对 android.gesture.cts 软件包运行 instrumentation。
包含标记 <include> 和 <template-include>
不建议在模块配置中使用 <include> 和 <template-include>。它们不保证按预期工作。
metrics_collector 标记的特殊情况
metrics_collector 是允许的，但仅限于 FilePullerLogCollector 类，以便指定要提取和记录模块的给定文件或目录。如果您要在特定位置留下日志并希望自动恢复它们，这将非常有用。
配置示例
<configuration description="Config for CTS UI Rendering test cases">
<target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
<option name="cleanup-apks" value="true" />
<option name="test-file-name" value="CtsUiRenderingTestCases.apk" />
</target_preparer>
<test class="com.android.tradefed.testtype.AndroidJUnitTest" >
<option name="package" value="android.uirendering.cts" />
<option name="runtime-hint" value="11m55s" />
<option name="runner" value="android.uirendering.cts.runner.UiRenderingRunner" />
<option name="isolated-storage" value="false" />
</test>
<!-- Collect the files in the dump directory for debugging -->
<metrics_collector class="com.android.tradefed.device.metric.FilePullerLogCollector">
<option name="directory-keys" value="/sdcard/UiRenderingCaptures" />
<option name="collect-on-run-ended-only" value="true" />
</metrics_collector>
</configuration>
构建信息或下载呢？
允许的标记的定义可能会给人留下错误的印象，即模块不会获得任何构建信息。事实并非如此。
构建信息由套件级设置提供，并将由套件的所有模块共享。这允许为套件进行单个顶级设置，以便运行套件的所有模块。
例如，无需每个兼容性测试套件 (CTS)模块单独查询设备信息、类型等，CTS 套件级设置 (cts.xml) 只执行一次，每个模块都将在请求时接收该信息。
为了使模块中的对象能够接收构建信息，它们需要执行与常规 Tradefed 配置中相同的操作：实现 IBuildReceiver 接口以接收 IBuildInfo。 有关更多详细信息，请参阅 testing with device。
元数据字段
许多测试模块包含一些 metadata 规范，每个规范都有其独特的目标。
示例
<option name="config-descriptor:metadata" key="component" value="framework" />
<option name="config-descriptor:metadata" key="parameter" value="instant_app" />
<option name="config-descriptor:metadata" key="parameter" value="multi_abi" />
<option name="config-descriptor:metadata" key="parameter" value="secondary_user" />
组件
component 元数据描述了模块旨在测试的通用 Android 组件。 它对测试执行没有任何直接影响； 它主要用于组织目的。
CTS 允许的组件的最新列表可在 CtsConfigLoadingTest 中找到。 如果将不存在的组件添加到 CTS 模块，则此测试在预提交时会失败。
您可以使用 module-metadata-include-filter 和 module-metadata-exclude-filter 基于组件过滤套件运行。
示例
--module-metadata-include-filter component framework
此示例仅运行使用 framework 组件注释的测试模块。
参数
parameter 元数据是信息性的，并且会影响测试执行。 它指定测试模块适用于哪种 Android 模式。 在这种情况下，模式 仅限于高级 Android 模式，例如 instant apps、secondary users 或 different abis。
在套件运行时，如果该模式适用于测试，则会根据该模式创建测试模块的多个变体。 每个变体运行类似的测试，但在不同的模式下运行。
instant_app：创建测试的变体，以将 APK 安装为即时应用。multi_abi：为设备支持的每个 ABI 创建测试的变体。secondary_user：创建测试的变体，以安装 APK 并以辅助用户身份运行测试。
性能测试模块的指标收集和后处理
对于性能测试模块，允许模块级 metrics_collector 和 metric_post_processor，因为它们对于性能测试至关重要。 模块级指标收集器和后处理器可以是模块特定的。 不建议在顶层和模块级都指定后处理器。
性能测试模块配置必须包含 test-type 元数据，其值为 performance，例如：xml <option name="config-descriptor:metadata" key="test-type" value="performance" />。 如果没有此项，如果测试配置包含 metric_collector（FilePullerLogCollector 除外）或任何 metric_post_processor，则测试在预提交时会失败。
性能测试模块配置示例
<configuration description="Runs sample performance test.">
<!-- Declare as a performance test module -->
<option name="config-descriptor:metadata" key="test-type" value="performance" />
<option name="test-tag" value="hello-world-performance-test" />
<test class="com.android.tradefed.testtype.HostTest" >
<option name="class" value="android.test.example.helloworldperformance.HelloWorldPerformanceTest" />
</test>
<!-- Add module-level post processor MetricFilePostProcessor -->
<metric_post_processor class="com.android.tradefed.postprocessor.MetricFilePostProcessor">
<option name="aggregate-similar-tests" value="true" />
<option name="enable-per-test-log" value="false" />
</metric_post_processor>
</configuration>