设置套件

Tradefed 中的套件是指在通用测试运行程序下运行多个测试的设置，该运行程序驱动整体执行。

在 Tradefed 中，套件通过 ITestSuite 类驱动，该类允许独立于测试的运行方式添加和移除测试。

定义

  • 套件：测试模块集，配置为在类似的顶层设置下运行，以在单次调用中报告其结果。
  • 顶层设置：在运行任何测试模块之前应用于设备的设置。
  • 主配置文件：套件级 Tradefed XML 配置文件，描述应运行哪些模块以及应使用哪些顶层设置。
  • 模块级设置：在运行模块之前直接应用于设备的设置。这些也称为模块特定设置。
  • 模块配置文件：指 AndroidTest.xml Tradefed XML 配置文件，描述模块以及应完成哪些模块级设置。
  • 模块：测试单元，由设置步骤（模块级设置）、测试执行步骤和拆卸步骤组成。
  • 模块内重试：由模块内部的工具自动完成的重试。
  • 套件重试：完整重新运行套件先前失败的测试。

ITestSuite 结构

Tradefed 中的 ITestSuite 指的是驱动套件执行的通用基类。它由所有主要的测试套件共享，特别是 Android 兼容性测试套件 (CTS) 和 Android 供应商测试套件 (VTS)，并确保所有套件之间具有一致的执行体验。

我们有时将 ITestSuite 称为套件运行程序。

套件运行程序在执行时遵循以下步骤

  1. 加载模块的配置并确定应运行哪个集合。

  2. 运行每个模块

    1. 运行模块级设置。
    2. 运行模块测试。
    3. 运行模块级拆卸。

  3. 报告结果。

顶层设置

从 Tradefed 的角度来看，ITestSuite 只是另一个测试。它是一个复杂的测试，但仍然只是像任何其他 IRemoteTest 一样的测试。因此，在 Tradefed 配置文件中指定套件运行程序时，Tradefed 遵循配置的常用模式：运行 build_provider、target_preparer、测试（在本例中为我们的套件）和 target_cleaner。

Tradefed 配置文件中包含 ITestSuite 的此序列是顶层设置。

示例

<configuration description="Common config for Compatibility suites">

    <build_provider class="com.android.compatibility.common.tradefed.build.CompatibilityBuildProvider" />
    <!-- Setup applied before the suite: so everything running in the suite will
    have this setup beforehand -->
    <target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
        <option name="run-command" value="settings put global package_verifier_enable 0" />
        <option name="teardown-command" value="settings put global package_verifier_enable 1"/>
    </target_preparer>

    <!-- Our ITestSuite implementation -->
    <test class="com.android.compatibility.common.tradefed.testtype.suite.CompatibilityTestSuite" />

    <result_reporter class="com.android.compatibility.common.tradefed.result.ConsoleReporter" />
</configuration>

模块元数据

我们称模块元数据为在测试模块 AndroidTest.xml 中指定的额外信息。此元数据允许您指定有关模块的其他信息，并且可以使用元数据过滤模块。

元数据示例

<option name="config-descriptor:metadata" key="component" value="framework" />
<option name="config-descriptor:metadata" key="parameter" value="instant_app" />

元数据过滤器示例

--module-metadata-include-filter component=framework

以上将运行所有将 framework 作为 component 元数据的模块。

完整的 AndroidTest.xml 示例

<configuration description="Config for CTS Gesture test cases">
    <option name="test-suite-tag" value="cts" />
    <!-- Metadata -->
    <option name="config-descriptor:metadata" key="component" value="framework" />
    <option name="config-descriptor:metadata" key="parameter" value="instant_app" />
    <!-- End: metadata -->
    <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>

参数化模块

一种特殊的元数据类型是 parameter。

<option name="config-descriptor:metadata" key="parameter" value="instant_app" />

此元数据指定模块需要在不同的模式下执行，例如作为即时应用，而不是标准应用模式。

所有可能的模式或参数都由 ModuleParameters 描述，并在 ModuleParametersHelper 中具有关联的处理程序，可让您更改模块设置以在特定模式下执行。

例如，即时应用模式强制以即时模式安装 APK。

为了使参数化发生，命令行需要使用以下命令启用它

--enable-parameterized-modules

也可以使用以下命令运行单个给定模式

--enable-parameterized-modules --module-parameter <Mode>

--enable-parameterized-modules --module-parameter INSTANT_APP

当模块的参数化版本运行时，它会在参数化模块名称下报告其结果，例如 CtsGestureTestCases[instant] 与基本 CtsGestureTestCases。