本頁面由 Cloud Translation API 翻譯而成。

ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

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

測試執行設定的容器。此類別是準備及執行測試的輔助程式。

摘要

欄位
`public static final String`	`ISOLATION_COST`
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CACHED` 如果快取了測試模組結果，這個屬性會設為 true。
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_EXTERNAL_DEPENDENCIES`
`public static final String`	`MODULE_ID` 模組 ID 是 testRunStart 期間用來識別唯一模組的名稱。
`public static final String`	`MODULE_ISOLATED` 如果模組是在全新準備的裝置上執行，則這個屬性會設為 true。
`public static final String`	`MODULE_NAME` 模組名稱是與模組相關聯的基礎名稱，通常來自 Xml TF 設定檔。
`public static final String`	`MODULE_PARAMETERIZATION`
`public static final String`	`MODULE_SKIPPED` 如果略過測試模組，這個屬性會設為 true
`public static final String`	`MODULE_TEST_COUNT`
`public static final String`	`PREPARATION_TIME`
`public static final String`	`RETRY_FAIL_COUNT`
`public static final String`	`RETRY_SUCCESS_COUNT`
`public static final String`	`RETRY_TIME`
`public static final String`	`SPARSE_MODULE` 如果只回報模組層級事件，這個屬性會設為 true。
`public static final String`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

公用建構函式
`ModuleDefinition()`
`ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` 建構函式
`ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` 建構函式

公用方法
`int`	`compareTo(ModuleDefinition moduleDef)`
`String`	`getId()` 傳回專屬模組名稱。
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` 傳回與模組相關聯的 `IInvocationContext`。
	`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, moduleLevelListeners)` 執行模組中包含的所有 `IRemoteTest`，並使用之前和直到完成設定並清理裝置後
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, int maxRunLimit)` 執行模組中包含的所有 `IRemoteTest`，並使用之前和直到完成設定並清理裝置後
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` 執行模組中包含的所有 `IRemoteTest`，並使用之前和直到完成設定並清理裝置後
`Throwable`	`runPreparation(boolean includeSuitePreparers)` 執行測試的準備工具，包括套件層級的準備工具 (如有指定)。
`void`	`setBuild(IBuildInfo build)` 插入要在測試期間使用的 `IBuildInfo`。
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` 啟用或停用測試收集模式
`void`	`setDevice(ITestDevice device)` 插入要在測試期間使用的 `ITestDevice`。
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` 是否在模組層級啟用動態下載。
`void`	`setLogSaver(ILogSaver logSaver)` 將叫用記錄保護程式傳遞至模組，讓模組在必要時使用。
`final void`	`setMergeAttemps(boolean mergeAttempts)` 設定是否應合併結果。
`void`	`setMetricCollectors( collectors)` 插入要供模組使用的 `IMetricCollector` 清單。
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` 組合應復原虛擬裝置。
`final void`	`setRetryDecision(IRetryDecision decision)` 設定要用於模組內重試的 `IRetryDecision`。
`boolean`	`shouldRecoverVirtualDevice()` 如果應復原虛擬裝置，則傳回。
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` 複製部分套件層級設定

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

欄位

ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULE_CACHED 模組

public static final String MODULE_CACHED

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

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

MODULE_ID

public static final String MODULE_ID

模組 ID 是 testRunStart 期間用來識別唯一模組的名稱。這項服務通常會結合 MODULE_ABI + MODULE_NAME。

模組化

public static final String MODULE_ISOLATED

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

MODULE_NAME

public static final String MODULE_NAME

模組名稱是與模組相關聯的基礎名稱，通常來自 Xml TF 設定檔。

模組化

public static final String MODULE_PARAMETERIZATION

模組化

public static final String MODULE_SKIPPED

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

MODULE_TEST_COUNT 個

public static final String MODULE_TEST_COUNT

PREPARATION_TIME

public static final String PREPARATION_TIME

重試次數

public static final String RETRY_FAIL_COUNT

RETRY_SUCCESS_COUNT 則

public static final String RETRY_SUCCESS_COUNT

重試時間

public static final String RETRY_TIME

SPARSE_MODULE

public static final String SPARSE_MODULE

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

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

測試時間

public static final String TEST_TIME

公用建構函式

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

建構函式

參數
`name`	`String`：測試設定的專屬名稱。
`tests`	：需要執行的 `IRemoteTest` 清單。
`preparersPerDevice`	：用於設定裝置的 `ITargetPreparer` 清單。
`multiPreparers`
`moduleConfig`	`IConfiguration`：基礎模組設定的 `IConfiguration`。

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

建構函式

參數
`name`	`String`：測試設定的專屬名稱。
`tests`	：需要執行的 `IRemoteTest` 清單。
`preparersPerDevice`	：用於設定裝置的 `ITargetPreparer` 清單。
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`：基礎模組設定的 `IConfiguration`。

公用方法

比較目標

public int compareTo (ModuleDefinition moduleDef)

參數
`moduleDef`	`ModuleDefinition`

傳回
`int`

getId

public String getId ()

傳回專屬模組名稱。

傳回
`String`

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

傳回
`IConfiguration`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

傳回與模組相關聯的 IInvocationContext。

傳回
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

參數
`testInfo`	`TestInformation`

傳回

getRuntimeHint

public long getRuntimeHint ()

傳回執行模組中所有測試的約略時間。

傳回
`long`

hasModuleFailed

public boolean hasModuleFailed ()

如果模組已呼叫 testRunFailure，則傳回 True *

傳回
`boolean`

所需裝置

public int neededDevices ()

傳回預計執行這項測試的裝置數量。

傳回
`int`

numTests

public int numTests ()

傳回目前等待執行的 IRemoteTest 數量。

傳回
`int`

未執行

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

回報完全未執行的模組。

參數
`listener`	`ITestInvocationListener`
`message`	`String`

得分

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners)

執行模組中包含的所有 IRemoteTest，並使用之前和直到完成設定並清理裝置後

參數
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`：要回報結果的 `ITestInvocationListener`。
`moduleLevelListeners`	：模組層級的事件監聽器清單。

擲回
`DeviceNotAvailableException`	避免裝置離線

得分

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                int maxRunLimit)

執行模組中包含的所有 IRemoteTest，並使用之前和直到完成設定並清理裝置後

參數
`moduleInfo`	`TestInformation`：模組的 `TestInformation`。
`listener`	`ITestInvocationListener`：要回報結果的 `ITestInvocationListener`。
`moduleLevelListeners`	：模組層級的事件監聽器清單。
`maxRunLimit`	`int`：每個測試案例的執行次數上限。

擲回
`DeviceNotAvailableException`	避免裝置離線

得分

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

執行模組中包含的所有 IRemoteTest，並使用之前和直到完成設定並清理裝置後

參數
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`：要回報結果的 `ITestInvocationListener`。

擲回
`DeviceNotAvailableException`	避免裝置離線

執行準備

public Throwable runPreparation (boolean includeSuitePreparers)

執行測試的準備工具，包括套件層級的準備工具 (如有指定)。

參數
`includeSuitePreparers`	`boolean`：設為 `true` 即可執行套件層級的準備工具。

傳回
`Throwable`	執行準備工具時引發任何例外狀況的 `Throwable`。

setBuild

public void setBuild (IBuildInfo build)

插入要在測試期間使用的 IBuildInfo。

參數
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

啟用或停用測試收集模式

setDevice

public void setDevice (ITestDevice device)

插入要在測試期間使用的 ITestDevice。

參數
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

是否在模組層級啟用動態下載。

參數
`enableDynamicDownload`	`boolean`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

將叫用記錄保護程式傳遞至模組，讓模組在必要時使用。

參數
`logSaver`	`ILogSaver`

設定 MergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

設定是否應合併結果。

參數
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

插入要供模組使用的 IMetricCollector 清單。

參數
`collectors`

設定復原虛擬裝置

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

組合應復原虛擬裝置。

參數
`recoverVirtualDevice`	`boolean`

設定重試決策

public final void setRetryDecision (IRetryDecision decision)

設定要用於模組內重試的 IRetryDecision。

參數
`decision`	`IRetryDecision`

應復原 VirtualDevice

public boolean shouldRecoverVirtualDevice ()

如果應復原虛擬裝置，則傳回。

傳回
`boolean`

toString

public String toString ()

傳回
`String`

TransferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

複製部分套件層級設定

參數
`mSuiteConfiguration`	`IConfiguration`

保護方法

hasTests

protected boolean hasTests ()

如果模組仍有 IRemoteTest 可在其集區中執行，則傳回 True。否則傳回「否」。

傳回
`boolean`