設定套裝組合

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

上述指令會以架構做為元件中繼資料，執行所有模組。

完整 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] 與 base CtsGestureTestCases。