為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ModuleDefinition

public class ModuleDefinition
extends Object implements Comparable<ModuleDefinition>, ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.suite.ModuleDefinition

測試執行設定的容器。這個類別是準備及執行測試的輔助工具。

摘要

常數
`String`	`ISOLATION_COST`
`String`	`MODULE_ABI`
`String`	`MODULE_CACHED` 如果測試模組結果已快取，這項屬性會設為 true。
`String`	`MODULE_CONTROLLER`
`String`	`MODULE_EXTERNAL_DEPENDENCIES`
`String`	`MODULE_ID` 模組 ID 是在 testRunStart 期間用來專屬識別模組的名稱。
`String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`String`	`MODULE_ISOLATED` 如果模組是在剛準備好的裝置上執行，這個屬性會設為 true。
`String`	`MODULE_NAME` 模組名稱是與模組相關聯的基本名稱，通常來自模組載入的 Xml TF 設定檔。
`String`	`MODULE_PARAMETERIZATION`
`String`	`MODULE_SKIPPED` 如果略過測試模組，這個屬性會設為 true。
`String`	`MODULE_TEST_COUNT`
`String`	`PREPARATION_TIME`
`String`	`RETRY_FAIL_COUNT`
`String`	`RETRY_SUCCESS_COUNT`
`String`	`RETRY_TIME`
`String`	`SPARSE_MODULE` 如果只回報模組層級事件，這個屬性會設為 true。
`String`	`TEAR_DOWN_TIME`
`String`	`TEST_TIME`

公用建構函式
`ModuleDefinition()`
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` 建構函式
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, Map<String, List<ITargetPreparer>> suitePreparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` 建構函式

公用方法
`int`	`compareTo(ModuleDefinition moduleDef)`
`Set<Digest>`	`getFilterDigests()` 傳回與測試相關聯的篩選器摘要。
`String`	`getId()` 傳回不重複的模組名稱。
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` 傳回與模組相關聯的 `IInvocationContext`。
`TestInformation`	`getModuleTestInformation()`
`Set<TokenProperty>`	`getRequiredTokens(TestInformation testInfo)`
`long`	`getRuntimeHint()` 傳回執行模組中所有測試的大約時間。
`boolean`	`hasModuleFailed()` 如果已在模組上呼叫 testRunFailure，則傳回 True。
`int`	`neededDevices()` 傳回預計會執行這項測試的裝置數量。
`int`	`numTests()` 傳回目前等待執行的 `IRemoteTest` 數量。
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` 回報完全未執行的模組。
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, int maxRunLimit)` 執行模組中包含的所有 `IRemoteTest`，並在設定及清除裝置前後使用所有準備工具。
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` 執行模組中包含的所有 `IRemoteTest`，並在設定及清除裝置前後使用所有準備工具。
`Throwable`	`runPreparation(boolean includeSuitePreparers)` 執行測試準備作業，包括指定的套件層級準備作業。
`void`	`setBuild(IBuildInfo build)` 插入測試期間要使用的 `IBuildInfo`。
`void`	`setCollectKernelLog(boolean collectKernelLog)`
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` 啟用或停用測試收集模式
`void`	`setDefaultLogCollectors(List<IMetricCollector> collectors)`
`void`	`setDevice(ITestDevice device)` 插入測試期間要使用的 `ITestDevice`。
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` 是否要在模組層級啟用動態下載。
`void`	`setIntraModuleInformation(int shardCount, int shardIndex)`
`void`	`setLogSaver(ILogSaver logSaver)` 將叫用記錄儲存器傳遞至模組，以便在必要時使用。
`final void`	`setMergeAttemps(boolean mergeAttempts)` 設定是否應合併結果。
`void`	`setMetricCollectors(List<IMetricCollector> collectors)` 將模組要使用的 `IMetricCollector` 清單插入其中。
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` 設定應會復原虛擬裝置。
`void`	`setRemoveModuleBuffering(boolean removeModuleBuffering)`
`void`	`setReportModuleEnd(boolean shouldReportModuleEnd)`
`void`	`setReportModuleStart(boolean shouldReportModuleStart)`
`final void`	`setRetryDecision(IRetryDecision decision)` 設定用於模組內重試的 `IRetryDecision`。
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`boolean`	`shouldRecoverVirtualDevice()` 傳回是否應復原虛擬裝置。
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` 複製幾個套件層級設定

受保護的方法
`boolean`	`hasTests()` 如果模組的集區中仍有 `IRemoteTest` 要執行，則傳回 True。

常數

ISOLATION_COST

public static final String ISOLATION_COST

常數值： "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

常數值： "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

如果測試模組結果已快取，這項屬性會設為 true。

常數值： "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

常數值： "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

常數值： "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

模組 ID，這個名稱會在 testRunStart 期間用於專屬識別模組。通常是 MODULE_ABI + MODULE_NAME 的組合。

常數值： "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

常數值： "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

如果模組是在新準備的裝置上執行，這個屬性會設為 true。

常數值： "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

模組名稱是與模組相關聯的基本名稱，通常來自模組載入的 XML TF 設定檔。

常數值： "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

常數值： "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

如果略過測試模組，這個屬性會設為 true

常數值： "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

常數值： "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

常數值： "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

常數值： "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

常數值： "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

常數值： "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

如果只回報模組層級事件，這個屬性會設為 true。

常數值： "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

常數值： "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

常數值： "TEST_TIME"

公用建構函式