複雜的測試配置

某些測試模塊可能需要定制的設置和拆卸步驟，而這些步驟無法在測試用例本身中執行。典型的例子可能包括：

  • 安裝其他 apk（除了測試 apk）
  • 將一些文件推送到設備
  • 運行命令（例如 adb shell pm ...）

過去，組件團隊通常通過編寫主機端測試來執行此類任務，這需要了解 Trade Federation harness，通常會增加測試模塊的複雜性。

借鑒CTS，我們引入了test module config的概念來支持此類任務，上面列出的常見任務只需幾行config即可實現。為了獲得最大的靈活性，您甚至可以實現自己的目標準備器，如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>

例如，我們可以添加以下選項標籤（在上面的“插入”註釋處）：

    <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”

在此特定示例中，可訪問性分別在測試模塊執行之前/之後啟用/禁用。通過一個簡單的示例演示，有必要涵蓋有關如何使用“選項”標籤的更多詳細信息。如上所示，標籤可以有兩個屬性：name、value。 name 屬性必須引用準備者提供的選項之一。

值字段的確切用途取決於準備者如何定義選項：它可以是字符串、數字、布爾值，甚至是文件路徑。以下是三種常見目標準備器的摘要：

  • 類名： PushFilePreparer

    • 簡稱：推送文件
    • 功能：將測試用例文件夾下的任意文件推送到設備上的目標位置
    • 注意事項：
      • 這個準備者可以從一個文件夾推送到另一個文件夾，或者從一個文件推送到另一個文件；也就是說，您不能將文件推送到設備上的文件夾下：您還必須指定該文件夾下的目標文件名
    • 選項：
      • push-file：一個 push-spec，將本地文件指定到它應該被推送到設備上的路徑。可能會重複。如果配置了多個文件推送到同一個遠程路徑，則推送最新的一個。
      • 推送：（已棄用）推送規範，格式為“ /path/to/srcfile.txt->/path/to/destfile.txt ”或“ /path/to/srcfile.txt->/path/to/destdir/ ” /path/to/srcfile.txt->/path/to/destdir/ '。可能會重複。此路徑可能與測試模塊目錄或 out 目錄本身相關。
      • post-push：嘗試所有推送後在設備上運行的命令（使用 ` adb shell <your command> `）。典型用例是使用 chmod 獲取權限

  • 類名： InstallApkSetup

    • 簡稱：安裝apk
    • 功能：將任意 apk 文件推送到設備上的目標位置
    • 選項：
      • test-file-name：要安裝到設備上的 apk 的名稱。
      • install-arg：要傳遞給 pm install 命令的附加參數，包括前導破折號，例如“-d”。可以重複

  • 類名： RunCommandTargetPreparer

    • 簡稱：運行命令
    • 功能：在測試模塊執行之前或之後執行任意 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

    • 簡稱：儀表
    • 功能：在給定設備上運行儀器測試包的測試
    • 選項：
      • package：要運行的 Android 測試應用程序的清單包名稱。
      • class：要運行的測試類名稱。
      • method：要運行的測試方法名稱。

  • 類名： AndroidJUnitTest

    • 功能：使用 android.support.test.runner.AndroidJUnitRunner 在給定設備上運行儀器測試包的測試這是執行儀器測試的主要方式。