在 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());
    }
}

貿易聯盟的主機驅動測試是由 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() 處理常式，針對每個類別執行某些裝置專屬的一次性設定或清理作業。如要解決這個問題，請使用 進行交易註解

  • @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>