A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

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

Es el contenedor para la configuración de la ejecución de prueba. Esta clase es un asistente para preparar y ejecutar las pruebas.

Resumen

Campos
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_ID` ID del módulo: Es el nombre que se usará para identificar de forma inequívoca el módulo durante testRunStart.
`public static final String`	`MODULE_ISOLATED` Esta propiedad se establece como verdadera si el módulo se ejecutaba 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, que suele provenir del archivo de configuración de TF Xml desde el que se cargó el módulo.
`public static final String`	`MODULE_PARAMETERIZATION`
`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`

Constructores públicos
`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()` Muestra el nombre único del módulo.
`IInvocationContext`	`getModuleInvocationContext()` Muestra el `IInvocationContext` asociado con el módulo.
	`getRequiredTokens()`
`long`	`getRuntimeHint()` Muestra el tiempo aproximado para ejecutar todas las pruebas del módulo.
`boolean`	`hasModuleFailed()` Muestra el valor True si se llamó a un testRunFailure en el módulo.
`int`	`numTests()` Muestra la cantidad actual de `IRemoteTest` que esperan a ejecutarse.
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Informa los módulos que no se ejecutaron por completo.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` Ejecuta todos los `IRemoteTest` contenidos en el módulo y usa todos los preparadores antes y después para 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 para configurar y limpiar el dispositivo.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` Ejecuta todos los `IRemoteTest` contenidos en el módulo y usa todos los preparadores antes y después para configurar y limpiar el dispositivo.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` Ejecuta los preparadores de la prueba, incluidos los preparadores a nivel del paquete si se especifica.
`void`	`setBuild(IBuildInfo build)` Inyecta 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)` Inyecta 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 ahorro de registro de invocación al módulo para que pueda usarlo si es necesario.
`final void`	`setMergeAttemps(boolean mergeAttempts)` Establece si debemos combinar los resultados o no.
`void`	`setMetricCollectors( collectors)` Inyecta la lista de `IMetricCollector` que usará el módulo.
`final void`	`setRetryDecision(IRetryDecision decision)` Establece el `IRetryDecision` que se usará para el reintento intramódulo.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Copia algunos de los parámetros de configuración a nivel de la suite

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

Campos

MODULE_ABI

public static final String MODULE_ABI

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_ID

public static final String MODULE_ID

ID del módulo: Es el nombre que se usará para identificar de forma inequívoca el módulo durante testRunStart. Por lo general, será una combinación de MODULE_ABI + MODULE_NAME.

MODULE_ISOLATED

public static final String MODULE_ISOLATED

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

MODULE_NAME

public static final String MODULE_NAME

El nombre del módulo es el nombre base asociado con el módulo, que suele provenir del archivo de configuración de TF Xml desde el que se cargó el módulo.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

PREPARATION_TIME

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

RETRY_TIME

public static final String RETRY_TIME

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Constructores públicos

ModuleDefinition

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`	: Es una lista de `ITargetPreparer` que se usará para configurar el dispositivo.
`multiPreparers`
`moduleConfig`	`IConfiguration`: Es el `IConfiguration` de la configuración del módulo subyacente.

ModuleDefinition

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`	: Es una lista de `ITargetPreparer` que se usará para configurar el dispositivo.
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`: Es el `IConfiguration` de la configuración del módulo subyacente.

Métodos públicos

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parámetros
`moduleDef`	`ModuleDefinition`

Muestra
`int`

getId

public String getId ()

Muestra el nombre único del módulo.

Muestra
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Muestra el IInvocationContext asociado con el módulo.

Muestra
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens ()

Muestra

getRuntimeHint

public long getRuntimeHint ()

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

Muestra
`long`

hasModuleFailed

public boolean hasModuleFailed ()

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

Muestra
`boolean`

numTests

public int numTests ()

Muestra la cantidad actual de IRemoteTest que esperan a ejecutarse.

Muestra
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informa los módulos que no se ejecutaron por completo.

Parámetros
`listener`	`ITestInvocationListener`
`message`	`String`

run

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

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

Parámetros
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: Es el `ITestInvocationListener` en el que se deben informar los resultados.
`moduleLevelListeners`	: Es la lista de objetos de escucha a nivel del módulo.
`failureListener`	`TestFailureListener`: Un objeto de escucha en particular para recopilar registros en testFail. Puede ser nulo.

Arroja
`DeviceNotAvailableException`	en caso de que el dispositivo esté 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 para configurar y limpiar el dispositivo.

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

Arroja
`DeviceNotAvailableException`	en caso de que el dispositivo esté sin conexión.

run

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

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

Parámetros
`moduleInfo`	`TestInformation`: Es el `TestInformation` del módulo.
`listener`	`ITestInvocationListener`: Es el `ITestInvocationListener` en el que se deben informar los resultados.
`moduleLevelListeners`	: Es la lista de objetos de escucha a nivel del módulo.
`failureListener`	`TestFailureListener`: Un objeto de escucha en particular para recopilar registros en testFail. Puede ser nulo.
`maxRunLimit`	`int`: Es la cantidad máxima de ejecuciones para cada caso de prueba.

Arroja
`DeviceNotAvailableException`	en caso de que el dispositivo esté sin conexión.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Ejecuta los preparadores de la prueba, incluidos los preparadores a nivel del paquete si se especifica.

Parámetros
`includeSuitePreparers`	`boolean`: Establece en `true` para ejecutar también los preparadores a nivel de la suite.

Muestra
`Throwable`	`Throwable` de cualquier excepción que se genere cuando se ejecuten los preparadores.

setBuild

public void setBuild (IBuildInfo build)

Inyecta el IBuildInfo que se usará durante las pruebas.

Parámetros
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Habilita o inhabilita el modo de recopilación de pruebas

setDevice

public void setDevice (ITestDevice device)

Inyecta 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 ahorro de registro de invocación al módulo para que pueda usarlo si es necesario.

Parámetros
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Establece si debemos combinar los resultados o no.

Parámetros
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parámetros
`collectors`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Establece el IRetryDecision que se usará para el reintento intramódulo.

Parámetros
`decision`	`IRetryDecision`

toString

public String toString ()

Muestra
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Copia algunos de los parámetros de configuración a nivel de la suite

Parámetros
`mSuiteConfiguration`	`IConfiguration`

Métodos protegidos

hasTests

protected boolean hasTests ()

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

Muestra
`boolean`