Definición de módulo

public class ModuleDefinition
extends Object implements ITestCollector

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

---

Contenedor de la configuración de la ejecución de prueba. Esta clase te ayudará en la preparación y ejecución de las pruebas.

Resumen

Campos
public static final String	ISOLATION_COST
public static final String	MODULE_ABI
public static final String	MODULE_CACHED Esta propiedad se establece como verdadera si los resultados del módulo de prueba se almacenaron en caché.
public static final String	MODULE_CONTROLLER
public static final String	MODULE_EXTERNAL_DEPENDENCIES
public static final String	MODULE_ID ID del módulo: Es el nombre que se usará para identificar de forma exclusiva el módulo durante testRunStart.
public static final String	MODULE_ISOLATED Esta propiedad se establece como verdadera si el módulo se estaba ejecutando en un dispositivo recién preparado.
public static final String	MODULE_NAME El nombre del módulo es el nombre base asociado con el módulo y, por lo general, proviene del archivo XML de TF. archivo de configuración desde el que se cargó el módulo.
public static final String	MODULE_PARAMETERIZATION
public static final String	MODULE_SKIPPED Esta propiedad se establece como verdadera si se omite el módulo de prueba.
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 Esta propiedad se establece como verdadera si solo se informan eventos a nivel del módulo.
public static final String	TEAR_DOWN_TIME
public static final String	TEST_TIME

Constructores públicos
ModuleDefinition()
ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) Constructor
ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig) Constructor

Métodos públicos
int	compareTo(ModuleDefinition moduleDef)
String	getId() Devuelve el nombre de módulo único.
IConfiguration	getModuleConfiguration()
IInvocationContext	getModuleInvocationContext() Devuelve el IInvocationContext asociado con el módulo.
	getRequiredTokens(TestInformation testInfo)
long	getRuntimeHint() Devuelve el tiempo aproximado para ejecutar todas las pruebas del módulo.
boolean	hasModuleFailed() Muestra el valor True si se llamó a testRunFailure en el módulo *
int	neededDevices() Muestra la cantidad de dispositivos que se espera que ejecuten esta prueba.
int	numTests() Muestra la cantidad actual de IRemoteTest en espera de ejecución.
final void	reportNotExecuted(ITestInvocationListener listener, String message) Informa sobre los módulos no ejecutados completamente.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners) Ejecuta todos los IRemoteTest contenidos en el módulo y usa todos los preparadores antes y después de configurar y limpiar el dispositivo.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, int maxRunLimit) Ejecuta todos los IRemoteTest contenidos en el módulo y usa todos los preparadores antes y después de configurar y limpiar el dispositivo.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener) Ejecuta todos los IRemoteTest contenidos en el módulo y usa todos los preparadores antes y después de configurar y limpiar el dispositivo.
Throwable	runPreparation(boolean includeSuitePreparers) Ejecuta los preparadores de la prueba, incluidos los de nivel de paquete si se especifican.
void	setBuild(IBuildInfo build) Inserta el IBuildInfo que se usará durante las pruebas.
void	setCollectTestsOnly(boolean collectTestsOnly) Habilita o inhabilita el modo de recopilación de pruebas
void	setDevice(ITestDevice device) Inserta el ITestDevice que se usará durante las pruebas.
void	setEnableDynamicDownload(boolean enableDynamicDownload) Indica si se debe habilitar o no la descarga dinámica a nivel del módulo.
void	setLogSaver(ILogSaver logSaver) Pasa el protector de registros de invocación al módulo para que pueda usarlo si es necesario.
final void	setMergeAttemps(boolean mergeAttempts) Determina si se deben combinar los resultados.
void	setMetricCollectors( collectors) Incorpora la lista de IMetricCollector que usará el módulo.
void	setRecoverVirtualDevice(boolean recoverVirtualDevice) Los conjuntos deberían recuperar el dispositivo virtual.
final void	setRetryDecision(IRetryDecision decision) Configura el IRetryDecision que se usará para los reintentos dentro del módulo.
boolean	shouldRecoverVirtualDevice() Muestra si debemos recuperar el dispositivo virtual.
String	toString()
void	transferSuiteLevelOptions(IConfiguration mSuiteConfiguration) Copia algunos parámetros de configuración a nivel del paquete.

Métodos protegidos
boolean	hasTests() Muestra el valor True si el módulo aún tiene IRemoteTest para ejecutarse en su grupo.

Campos

COSTO_ISOLACIÓN

public static final String ISOLATION_COST

ABI_MÓDULO

public static final String MODULE_ABI

MODULE_CACHED

public static final String MODULE_CACHED

Esta propiedad se establece como verdadera si los resultados del módulo de prueba se almacenaron en caché.

CONTROLADOR_MÓDULO

public static final String MODULE_CONTROLLER

DEPENDENCIAS_EXTERNAS MÓDULOS

public static final String MODULE_EXTERNAL_DEPENDENCIES

ID DE MÓDULO

public static final String MODULE_ID

ID del módulo: Es el nombre que se usará para identificar de forma exclusiva el módulo durante testRunStart. Integra generalmente será una combinación de MODULE_ABI + MODULE_NAME.

MÓDULO_ISOLADO

public static final String MODULE_ISOLATED

Esta propiedad se establece como verdadera si el módulo se estaba ejecutando en un dispositivo recién preparado.

NOMBRE_MÓDULO

public static final String MODULE_NAME

El nombre del módulo es el nombre base asociado con el módulo y, por lo general, proviene del archivo XML de TF. archivo de configuración desde el que se cargó el módulo.

PARÁMETRO_DE_MÓDULO

public static final String MODULE_PARAMETERIZATION

MÓDULO_OMITIDO

public static final String MODULE_SKIPPED

Esta propiedad se establece como verdadera si se omite el módulo de prueba.

PRUEBAS_MODULE_COUNT

public static final String MODULE_TEST_COUNT

HORA_DE_PREPARACIÓN

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

HORA_REINTENTO

public static final String RETRY_TIME

MÓDULO_SPARSE

public static final String SPARSE_MODULE

Esta propiedad se establece como verdadera si solo se informan eventos a nivel del módulo.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Constructores públicos

Definición de módulo

public ModuleDefinition ()

Definición de módulo

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

Constructor

Parámetros
name	String: Es el nombre único de la configuración de prueba.
tests	: Es la lista de IRemoteTest que se debe ejecutar.
preparersPerDevice	: Lista de ITargetPreparer que se usarán para configurar el dispositivo.
multiPreparers
moduleConfig	IConfiguration: Es el IConfiguration de la configuración del módulo subyacente.

Definición de módulo

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

Constructor

Parámetros
name	String: Es el nombre único de la configuración de prueba.
tests	: Es la lista de IRemoteTest que se debe ejecutar.
preparersPerDevice	: Lista de ITargetPreparer que se usarán para configurar el dispositivo.
suitePreparersPerDevice
multiPreparers
moduleConfig	IConfiguration: Es el IConfiguration de la configuración del módulo subyacente.

Métodos públicos

comparar con

public int compareTo (ModuleDefinition moduleDef)

Parámetros
moduleDef	ModuleDefinition

Muestra
int

ID get

public String getId ()

Devuelve el nombre de módulo único.

Muestra
String

getModuleConfiguration.

public IConfiguration getModuleConfiguration ()

Muestra
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Devuelve el IInvocationContext asociado con el módulo.

Muestra
IInvocationContext

getObligatorioTokens

public  getRequiredTokens (TestInformation testInfo)

Parámetros
testInfo	TestInformation

Muestra

getRuntimeHint

public long getRuntimeHint ()

Devuelve el tiempo aproximado para ejecutar todas las pruebas del módulo.

Muestra
long

Error del módulo

public boolean hasModuleFailed ()

Muestra el valor True si se llamó a testRunFailure en el módulo *

Muestra
boolean

dispositivos necesarios

public int neededDevices ()

Muestra la cantidad de dispositivos que se espera que ejecuten esta prueba.

Muestra
int

númPruebas

public int numTests ()

Muestra la cantidad actual de IRemoteTest en espera de ejecución.

Muestra
int

informeNo ejecutado

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informa sobre los módulos no ejecutados completamente.

Parámetros
listener	ITestInvocationListener
message	String

run

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

Ejecuta todos los IRemoteTest contenidos en el módulo y usa todos los preparadores antes y después de configurar y limpiar el dispositivo.

Parámetros
moduleInfo	TestInformation
listener	ITestInvocationListener: Es el ITestInvocationListener en el que se informan los resultados.
moduleLevelListeners	: Es la lista de objetos de escucha a nivel del módulo.

Arroja
DeviceNotAvailableException	en caso de que el dispositivo se quede sin conexión.

run

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

Ejecuta todos los IRemoteTest contenidos en el módulo y usa todos los preparadores antes y después de configurar y limpiar el dispositivo.

Parámetros
moduleInfo	TestInformation: Es el TestInformation del módulo.
listener	ITestInvocationListener: Es el ITestInvocationListener en el que se informan los resultados.
moduleLevelListeners	: Es la lista de objetos de escucha a nivel del módulo.
maxRunLimit	int: Es la cantidad máxima de ejecuciones para cada caso de prueba.

Arroja
DeviceNotAvailableException	en caso de que el dispositivo se quede sin conexión.

run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Ejecuta todos los IRemoteTest contenidos en el módulo y usa todos los preparadores antes y después de configurar y limpiar el dispositivo.

Parámetros
moduleInfo	TestInformation
listener	ITestInvocationListener: Es el ITestInvocationListener en el que se informan los resultados.

Arroja
DeviceNotAvailableException	en caso de que el dispositivo se quede sin conexión.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Ejecuta los preparadores de la prueba, incluidos los de nivel de paquete si se especifican.

Parámetros
includeSuitePreparers	boolean: Se establece en true para ejecutar también preparadores a nivel del paquete.

Muestra
Throwable	Throwable de cualquier excepción que se genere cuando se ejecutan preparadores.

setBuild

public void setBuild (IBuildInfo build)

Inserta el IBuildInfo que se usará durante las pruebas.

Parámetros
build	IBuildInfo

Solo RecopilarTests

public void setCollectTestsOnly (boolean collectTestsOnly)

Habilita o inhabilita el modo de recopilación de pruebas

SetDevice

public void setDevice (ITestDevice device)

Inserta el ITestDevice que se usará durante las pruebas.

Parámetros
device	ITestDevice

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Indica si se debe habilitar o no la descarga dinámica a nivel del módulo.

Parámetros
enableDynamicDownload	boolean

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Pasa el protector de registros de invocación al módulo para que pueda usarlo si es necesario.

Parámetros
logSaver	ILogSaver

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Determina si se deben combinar los resultados.

Parámetros
mergeAttempts	boolean

setMetricCollectors

public void setMetricCollectors ( collectors)

Incorpora la lista de IMetricCollector que usará el módulo.

Parámetros
collectors

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Los conjuntos deberían recuperar el dispositivo virtual.

Parámetros
recoverVirtualDevice	boolean

setReintentarDecisión

public final void setRetryDecision (IRetryDecision decision)

Configura el IRetryDecision que se usará para los reintentos dentro del módulo.

Parámetros
decision	IRetryDecision

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Muestra si debemos recuperar el dispositivo virtual.

Muestra
boolean

toString

public String toString ()

Muestra
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Copia algunos parámetros de configuración a nivel del paquete.

Parámetros
mSuiteConfiguration	IConfiguration

Métodos protegidos

hasTests

protected boolean hasTests ()

Muestra el valor True si el módulo aún tiene IRemoteTest para ejecutarse en su grupo. De lo contrario, el valor es falso.

Muestra
boolean