此页面由 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

已缓存的模块

public static final String MODULE_CACHED

如果测试模块结果已缓存，则此属性会设置为 true。

模块控制器

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 的组合。

MODULE_ISOLATED

public static final String MODULE_ISOLATED

如果模块是在新准备的设备上运行，则此属性设置为 true。

MODULE_NAME

public static final String MODULE_NAME

模块名称是与模块相关的基本名称，通常来自 XML TF 从中加载模块的配置文件

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

MODULE_SKIPPED（跳过）

public static final String MODULE_SKIPPED

如果跳过测试模块，则此属性会设置为 true

MODULE_TEST_COUNT 项

public static final String MODULE_TEST_COUNT

准备时间

public static final String PREPARATION_TIME

RETRY_FAIL_COUNT 次

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`

获取 ID

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`

测试数

public int numTests ()

返回等待执行的 IRemoteTest 的当前数量。

返回
`int`

reportNotExecuted

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`	以便在设备离线时启动

runPreparation

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`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

设置我们是否应合并结果。

参数
`mergeAttempts`	`boolean`

setMetricCollector

public void setMetricCollectors ( collectors)

注入要供模块使用的 IMetricCollector 的列表。

参数
`collectors`

setRestoreVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

集应恢复虚拟设备。

参数
`recoverVirtualDevice`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

设置要用于模块内重试的 IRetryDecision。

参数
`decision`	`IRetryDecision`

shouldrecoveryVirtualDevice

public boolean shouldRecoverVirtualDevice ()

返回是否应恢复虚拟设备。

返回
`boolean`

toString

public String toString ()

返回
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

复制一些套件级别的配置

参数
`mSuiteConfiguration`	`IConfiguration`

受保护的方法

hasTest

protected boolean hasTests ()

如果模块仍有 IRemoteTest 要在其池中运行，则返回 True。否则为 false。

返回
`boolean`