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

模塊定義

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_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_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`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

公共構造函數
`ModuleDefinition ()`
`ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` 構造函數
`ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` `ModuleDefinition (String name, tests, preparersPerDevice, suitePreparersPerDevice, 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, TestFailureListener failureListener, int maxRunLimit)` `run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` 運行模塊中包含的所有`IRemoteTest` ，並使用之前和之後的所有準備器來設置和清理設備。
`final void`	`run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` `run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` 運行模塊中包含的所有`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)` `setMetricCollectors ( collectors)` 注入模塊要使用的`IMetricCollector`列表。
`final void`	`setRetryDecision ( IRetryDecision decision)` 設置用於模塊內重試的`IRetryDecision` 。
`String`	`toString ()`
`void`	`transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration)` 複製一些套件級別的配置

受保護的方法
`boolean`	`hasTests ()` 如果模塊仍有`IRemoteTest`要在其池中運行，則返回 True。

領域

隔離成本

public static final String ISOLATION_COST

模塊_ABI

public static final String MODULE_ABI

模塊控制器

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

模塊ID

public static final String MODULE_ID

模塊 ID 將在 testRunStart 期間用於唯一標識模塊的名稱。它通常是 MODULE_ABI + MODULE_NAME 的組合。

模塊_隔離

public static final String MODULE_ISOLATED

如果模塊在新準備的設備上運行，則此屬性設置為 true。

模塊名稱

public static final String MODULE_NAME

模塊名稱是與模塊關聯的基本名稱，通常來自加載模塊的 Xml TF 配置文件。

模塊參數化

public static final String MODULE_PARAMETERIZATION

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

準備時間

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

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

測試時間

public static final String TEST_TIME

公共構造函數

模塊定義

public ModuleDefinition ()

模塊定義

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

構造函數

參數
`name`	`String` ：測試配置的唯一名稱。
`tests`	：需要運行的`IRemoteTest`列表。
`preparersPerDevice`	：用於設置設備的`ITargetPreparer`列表。
`multiPreparers`
`moduleConfig`	`IConfiguration` ：底層模塊配置的`IConfiguration` 。

模塊定義

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`

獲取ID

public String getId ()

返回唯一的模塊名稱。

退貨
`String`

獲取模塊配置

public IConfiguration getModuleConfiguration ()

退貨
`IConfiguration`

獲取模塊調用上下文

public IInvocationContext getModuleInvocationContext ()

返回與模塊關聯的IInvocationContext 。

退貨
`IInvocationContext`

獲取所需令牌

public  getRequiredTokens (TestInformation testInfo)

參數
`testInfo`	`TestInformation`

退貨

獲取運行時提示

public long getRuntimeHint ()

返回運行模塊中所有測試的大致時間。

退貨
`long`

模塊失敗

public boolean hasModuleFailed ()

如果已在模塊上調用 testRunFailure，則返回 True *

退貨
`boolean`

所需設備

public int neededDevices ()

返回預計運行此測試的設備數量。

退貨
`int`

測試次數

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, 
                TestFailureListener failureListener, 
                int maxRunLimit)

運行模塊中包含的所有IRemoteTest ，並使用之前和之後的所有準備器來設置和清理設備。

參數
`moduleInfo`	`TestInformation` ：模塊的`TestInformation` 。
`listener`	`ITestInvocationListener` ： `ITestInvocationListener`報告結果的位置。
`moduleLevelListeners`	：模塊級別的偵聽器列表。
`failureListener`	`TestFailureListener` ：收集 testFail 日誌的特定偵聽器。可以為空。
`maxRunLimit`	`int` ：每個測試用例的最大運行次數。

投擲
`DeviceNotAvailableException`	如果設備離線。

跑步

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

運行模塊中包含的所有IRemoteTest ，並使用之前和之後的所有準備器來設置和清理設備。

參數
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener` ： `ITestInvocationListener`報告結果的位置。
`moduleLevelListeners`	：模塊級別的偵聽器列表。
`failureListener`	`TestFailureListener` ：收集 testFail 日誌的特定偵聽器。可以為空。

投擲
`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` 。

設置構建

public void setBuild (IBuildInfo build)

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

參數
`build`	`IBuildInfo`

僅設置收集測試

public void setCollectTestsOnly (boolean collectTestsOnly)

啟用或禁用測試收集模式

設置設備

public void setDevice (ITestDevice device)

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

參數
`device`	`ITestDevice`

設置啟用動態下載

public void setEnableDynamicDownload (boolean enableDynamicDownload)

是否在模塊級別啟用動態下載。

參數
`enableDynamicDownload`	`boolean`

設置日誌保存程序

public void setLogSaver (ILogSaver logSaver)

將調用日誌保存程序傳遞給模塊，以便模塊可以在必要時使用它。

參數
`logSaver`	`ILogSaver`

設置合併嘗試

public final void setMergeAttemps (boolean mergeAttempts)

設置是否應該合併結果。

參數
`mergeAttempts`	`boolean`

設置MetricCollectors

public void setMetricCollectors ( collectors)

注入模塊要使用的IMetricCollector列表。

參數
`collectors`

設置重試決策

public final void setRetryDecision (IRetryDecision decision)

設置用於模塊內重試的IRetryDecision 。

參數
`decision`	`IRetryDecision`

到字符串

public String toString ()

退貨
`String`

傳輸套件級別選項

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

複製一些套件級別的配置

參數
`mSuiteConfiguration`	`IConfiguration`

受保護的方法

有測試

protected boolean hasTests ()

如果模塊仍有IRemoteTest要在其池中運行，則返回 True。否則為假。

退貨
`boolean`