复杂的测试配置

某些测试模块可能需要执行在测试用例本身内无法执行的自定义设置和拆解步骤。典型的示例可能包括：

  • 安装其他 apk（除了测试 apk 之外）
  • 将某些文件推送到设备
  • 运行命令（例如 adb shell pm …）

过去，组件团队通常依靠编写主机端测试来执行此类任务，这需要了解 Trade Federation 自动化测试框架，并且通常会增加测试模块的复杂性。

我们引入了测试模块配置的概念（借鉴于 CTS）来支持此类任务，只需几行配置即可完成上面列出的常见任务。为了达到最大的灵活性，您甚至可以实现自己的目标准备器（由 ITargetPreparer 或 ITargetCleaner 定义），并对其进行配置以在您自己的测试模块配置中使用。

测试模块的测试模块配置是添加到顶级模块源文件夹的必需 XML 文件，名为“AndroidTest.xml”。该 XML 文件遵循 Trade Federation 自动化测试框架使用的配置文件的格式。目前，通过测试模块配置处理的主要标记是“target_preparer”和"test"标记。

目标准备器

顾名思义，“target_preparer”标记会定义一个目标准备器（请参阅 ITargetPreparer），用于提供在执行测试模块以进行测试之前调用的设置方法；如果“target_preparer”标记中引用的类还实现了 ITargetCleaner，那么在测试模块完成后，系统将调用其拆解方法。

要使用内置的通用模块配置，请在测试模块的顶级文件夹中添加一个新文件“AndroidTest.xml”，并在该文件里填充以下内容：

<?xml version="1.0" encoding="utf-8"?>
<!-- [insert standard AOSP copyright here] -->
<configuration description="Test module config for Foo">
<!-- insert options here -->
</configuration>

例如，我们可以添加以下选项标记（在上面的“insert”注释处）：

    <target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
        <option name="run-command" value="settings put secure accessibility_enabled 1" />
        <option name="teardown-command" value="settings put secure accessibility_enabled 0" />
    </target_preparer>

这些选项会将自动化测试框架配置为：

  1. 在调用测试模块之前，在设备上执行 shell 命令“settings put secure accessibility_enabled 1”
  2. 在测试模块完成之后，执行 shell 命令“settings put secure accessibility_enabled 0”

在此特定示例中，分别在测试模块执行之前/之后启用/停用可访问性。通过一个简单的示例演示，可以详细介绍如何使用“option”标记。如上所示，该标记可以有两个属性：name 和 value。name 属性必须引用准备器提供的选项之一。

value 字段的确切用途取决于准备器如何定义选项：它可以是字符串、数字、布尔值，甚至文件路径。下面总结了三个常见的目标准备器：

  • 类名：PushFilePreparer

    • 简称：push-file
    • 功能：将测试用例文件夹下的任意文件推送到设备上的目标
    • 注意：
      • 此准备器可以从文件夹推送到文件夹，或者从文件推送到文件；也就是说，您无法将文件推送到设备上的文件夹下，您还必须指定该文件夹下的目标文件名
    • 选项：
      • push-file:：一种推送规范，用于指定本地文件在设备上应该被推送到的路径。可以重复。如果将多个文件配置为推送到同一远程路径，则系统会推送最新的文件。
      • push：（已废弃）一种推送规范，格式为“/path/to/srcfile.txt->/path/to/destfile.txt”或“/path/to/srcfile.txt->/path/to/destdir/”。可以重复。此路径可以是相对于测试模块目录或输出目录本身的路径。
      • post-push:：尝试进行所有推送后在设备上运行的命令（使用“adb shell <your command>”）。典型用例是使用 chmod 命令添加权限

  • 类名：InstallApkSetup

    • 简称：install-apk
    • 功能：将任意 apk 文件推送到设备上的目标
    • 选项：
      • test-file-name:：要安装到设备上的 apk 的名称。
      • install-arg:：要传递给 pm install 命令的其他参数，包括前导短划线，例如“-d”。可以重复

  • 类名：RunCommandTargetPreparer

    • 简称：run-command
    • 功能：在测试模块执行之前或之后执行任意 shell 命令
    • 选项：
      • run-command:：要运行的 adb shell 命令。可以重复
      • teardown-command:：要在拆解阶段运行的 adb shell 命令。可以重复

测试类

测试类是用于执行测试的 Trade Federation 类。

<test class="com.android.tradefed.testtype.AndroidJUnitTest">
  <option name="package" value="android.test.example.helloworld"/>
  <option name="runner" value="android.support.test.runner.AndroidJUnitRunner"/>
</test>

下面是三个常见的测试类：

  • 类名：GTest

    • 简称：gtest
    • 功能：在给定设备上运行原生测试软件包的测试。
    • 选项：
      • native-test-device-path:：原生测试在设备上所在的路径。

  • 类名：InstrumentationTest

    • 简称：instrumentation
    • 功能：在给定设备上运行插桩测试软件包的测试
    • 选项：
      • package：要运行的 Android 测试应用的清单软件包名称。
      • class：要运行的测试类名称。
      • method：要运行的测试方法名称。

  • 类名：AndroidJUnitTest

    • 功能：使用 android.support.test.runner.AndroidJUnitRunner 在给定设备上运行插桩测试软件包的测试。这是执行插桩测试的主要方法。