在 Trade Federation 中编写主机驱动测试

本页介绍如何编写由主机驱动的 JUnit4 风格的设备测试。这意味着线束的主机端将触发针对设备的操作。

请注意，我们认为“主机端”测试和“主机驱动”测试略有不同：

主机驱动测试：是在主机上运行的与一个或多个设备交互的测试。被测系统 (SUT) 不在主机本身上，而是在主机上进行测试。
主机端测试：是纯粹在主机上运行并仅在主机上测试某些内容的测试，例如单元测试。

为什么要创建主机驱动测试而不是仪器测试？

某些测试可能需要您影响设备的整体状态，例如发出重启命令。在仪器测试用例中，重新启动会终止仪器，测试无法继续，并且没有可用的结果。

主机驱动的测试还可以驱动额外的设置步骤，这些步骤需要与测试所依赖的外部设备进行交互。

主机驱动的测试可以处理这些用例，并允许使用更多场景对设备进行高级测试。如果您处于这种情况，那么编写主机驱动的测试是最有意义的。

主机驱动的测试是如何用 TF 编写的？

这是一个示例：

@RunWith(DeviceJUnit4ClassRunner.class)
public class SampleHostJUnit4DeviceTest extends BaseHostJUnit4Test {
    @Before
    public void setUp() throws Exception {
       // Some setup
    }

    @Test
    public void testCheckWeHaveDevice() throws Exception {
        Assert.assertNotNull(getDevice());
    }
}

Trade Federation 中的主机驱动测试由DeviceJUnit4ClassRunner JUnit4 测试运行程序驱动。测试类的整体结构与常规的 JUnit4 测试相同：

@BeforeClass
@Before
@Test
@After
@AfterClass
Assume , Assert

扩展BaseHostJunit4Test是一种继承有用的测试实用程序 API 的方法，例如：

installPackage ：允许在目标设备上安装 APK。
installPackageAsUser ：允许以用户身份在目标设备上安装 APK。
uninstallPackage ：允许卸载 APK。
isPackageInstalled ：检查是否安装了包。
hasDeviceFeature : 检查设备是否支持某个功能。（ pm list features ）
runDeviceTests(DeviceTestRunOptions options) ：使用DeviceTestRunOptions对目标设备运行仪器测试以处理所有可能的选项。

还提供对 Tradefed 设备对象的访问：

getDevice() ：返回一个用于操作设备的 TF 设备对象。
getBuild() ：返回构建信息 TF 对象以获取有关构建的信息。
getAbi() ：返回运行测试的 ABI。

Tradefed 支持：每类设备准备和清理

JUnit4 @BeforeClass和@AfterClass仅适用于静态方法，这使得无法使用#getDevice()处理程序来执行某些特定于设备的、一次性的、每个类的设置或清理。要解决此问题，请使用 Tradefed 注释。

@BeforeClassWithInfo：在@BeforeClass 注解之前运行
@AfterClassWithInfo：在@AfterClass 注解之后运行

   @BeforeClassWithInfo
   public static void beforeClassWithDevice(TestInformation testInfo) {
       assertNotNull(testInfo.getDevice());
       testInfo.properties().put("mytest:test-prop", "test");
   }

   @AfterClassWithInfo
   public static void afterClassWithDevice(TestInformation testInfo) {
       assertNotNull(testInfo.getDevice());
       testInfo.properties().put("mytest:test-prop", "test");
   }

TestInformation允许您使用可在静态或非静态范围内使用的设备和存储属性。 BaseHostJUnit4Test支持通过#getTestInformation()在非静态范围内获取TestInformation 。

如果您不扩展BaseHostJUnit4Test ，则可以实现ITestInformationReceiver以接收TestInformation对象。

如何在 Tradefed 中配置主机驱动测试？

在 Tradefed XML 配置文件中，主机驱动的测试通过HostTest运行程序运行。

<test class="com.android.tradefed.testtype.HostTest" >
    <option name="class" value="android.sample.cts.SampleHostJUnit4DeviceTest" />
</test>