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.

ITestSuite

public abstract class ITestSuite
extends Object implements IBuildReceiver, IConfigurationReceiver, IDeviceTest, IInvocationContextReceiver, IMetricCollectorReceiver, IRemoteTest, IReportNotExecuted, IRuntimeHintProvider, IShardableTest, ISystemStatusCheckerReceiver, ITestCollector, ITestLoggerReceiver, ITokenRequest

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

Subclases directas conocidas

BaseTestSuite, TfSuiteRunner

BaseTestSuite	Una prueba para ejecutar el conjunto de pruebas de compatibilidad con el nuevo sistema de suites.
TfSuiteRunner	Implementación de `ITestSuite`, que cargará pruebas de la carpeta res/config/suite/ de los frascos de TF.

Subcategorías indirectas conocidas

AtestRunner, TestMappingSuiteRunner

AtestRunner	Implementación de `ITestSuite`
TestMappingSuiteRunner	Implementación de `BaseTestSuite` para ejecutar pruebas especificadas por la opción include-filter o los archivos TEST_MAPPING de la compilación como un paquete.

Es una clase abstracta que se usa para ejecutar el paquete de pruebas. Esta clase proporciona la base de cómo se ejecutará el paquete. Cada implementación puede definir la lista de pruebas a través del método loadTests().

Resumen

Campos
`public static final String`	`ABI_OPTION`
`public static final String`	`ACTIVE_MAINLINE_PARAMETER_KEY`
`public static final String`	`BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`public static final String`	`ENABLE_RESOLVE_SYM_LINKS`
`public static final String`	`MAINLINE_PARAMETER_KEY`
`public static final String`	`MODULE_CHECKER_POST`
`public static final String`	`MODULE_CHECKER_PRE`
`public static final String`	`MODULE_END_TIME`
`public static final String`	`MODULE_METADATA_EXCLUDE_FILTER`
`public static final String`	`MODULE_METADATA_INCLUDE_FILTER`
`public static final String`	`MODULE_START_TIME`
`public static final String`	`PARAMETER_KEY`
`public static final String`	`PREPARER_WHITELIST`
`public static final String`	`PRIMARY_ABI_RUN`
`public static final String`	`RANDOM_SEED`
`public static final String`	`RUNNER_WHITELIST`
`public static final String`	`SKIP_HOST_ARCH_CHECK`
`public static final String`	`SKIP_STAGING_ARTIFACTS`
`public static final String`	`SKIP_SYSTEM_STATUS_CHECKER`
`public static final String`	`STAGE_MODULE_ARTIFACTS`
`public static final String`	`TEST_TYPE_KEY`
`public static final String`	`TEST_TYPE_VALUE_PERFORMANCE`
`public static final String`	`TOKEN_KEY`
`protected boolean`	`mEnableResolveSymlinks`
`protected boolean`	`mRecoverDeviceByCvd`

Constructores públicos
`ITestSuite()`

Métodos públicos
`void`	`addModuleMetadataExcludeFilters(MultiMap<String, String> filters)`
`void`	`addModuleMetadataIncludeFilters(MultiMap<String, String> filters)`
`void`	`cleanUpSuiteSetup()` Es la oportunidad de limpiar todo lo que se necesitó durante la configuración de los paquetes, pero que no es necesario para ejecutar las pruebas.
`boolean`	`filterByConfigMetadata(IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)` Aplica el filtro de metadatos a la configuración y comprueba si se debe ejecutar.
	`getAbis(ITestDevice device)` Obtiene el conjunto de ABIs compatibles con la `AbiUtils.getAbisSupportedByCompatibility()` de pruebas de compatibilidad y el dispositivo en prueba.
`static`	`getAbisForBuildTargetArchFromSuite()` Devuelve los ABIs posibles de TestSuiteInfo.
`IBuildInfo`	`getBuildInfo()` Es posible que la implementación de `ITestSuite` requiera que la información de compilación cargue las pruebas.
`final IConfiguration`	`getConfiguration()` Muestra la invocación `IConfiguration`.
`ITestLogger`	`getCurrentTestLogger()`
`ITestDevice`	`getDevice()` Obtén el dispositivo en prueba.
`ModuleDefinition`	`getDirectModule()` Muestra el `ModuleDefinition` que se ejecutará directamente o nulo si aún no hay ninguno (cuando ITestSuite aún no se ha particionado).
`boolean`	`getIntraModuleSharding()`
`IInvocationContext`	`getInvocationContext()` Muestra el contexto de invocación.
`MultiMap<String, String>`	`getModuleMetadataIncludeFilters()`
`ITestSuite.MultiDeviceModuleStrategy`	`getMultiDeviceStrategy()`
`final String`	`getRequestedAbi()` Muestra la ABI solicitada con la opción -a o --abi.
	`getRequiredTokens(TestInformation testInfo)` Muestra la lista de tokens requeridos por la prueba.
`long`	`getRuntimeHint()` Muestra el tiempo de ejecución esperado de la prueba en milisegundos.
`File`	`getTestsDir()`
`boolean`	`isSplitting()` Muestra verdadero si actualmente estamos en `IShardableTest.split(int)`.
`abstract`	`loadTests()` Es un método abstracto para cargar la configuración de las pruebas que se ejecutarán.
`void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Informa las pruebas no ejecutadas al objeto de escucha principal proporcionado.
`void`	`reportNotExecuted(ITestInvocationListener listener)` Informa las pruebas no ejecutadas al objeto de escucha principal proporcionado.
`final void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Es el método de ejecución genérico para todas las pruebas cargadas desde `loadTests()`.
`void`	`setAbiName(String abiName)` Establece el valor de mAbiName
`final void`	`setAbis( abis)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Ejecuta el paquete de pruebas en modo de solo recopilador. Esto requiere que todas las pruebas secundarias también implementen esta interfaz.
`void`	`setConfiguration(IConfiguration configuration)` Inyecta el `IConfiguration` en uso.
`void`	`setDevice(ITestDevice device)` Inyecta el dispositivo en prueba.
`void`	`setDirectModule(ModuleDefinition module)`
`void`	`setIntraModuleSharding(boolean intraModuleSharding)`
`void`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setMetricCollectors( collectors)` Establece la lista de `IMetricCollector` definidos para la ejecución de prueba.
`void`	`setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)`
`void`	`setPrimaryAbiRun(boolean primaryAbiRun)` Establece el valor de mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule(boolean dynamicModule)` Cuando se realiza la fragmentación distribuida, no podemos tener ModuleDefinition que comparta pruebas en un grupo. De lo contrario, no funcionará la fragmentación intramódulo, por lo que permitimos inhabilitarla.
`void`	`setSkipContext(SkipContext skipContext)`
`void`	`setSystemStatusChecker( systemCheckers)` Establece los `ISystemStatusChecker` de la configuración para la prueba.
`void`	`setTestLogger(ITestLogger testLogger)` Inyecta la instancia de `ITestLogger`.
	`split(Integer shardCountHint, TestInformation testInfo)` Es una versión alternativa de `split(int)` que también proporciona un `TestInformation` que contiene información anticipada del elemento superior que crea los fragmentos.

Métodos protegidos
	`createModuleListeners()` Muestra la lista de `ITestInvocationListener` aplicables al nivel `ModuleListener`.
`boolean`	`filterByRunnerType(IConfiguration config, allowedRunners)` Aplica el filtro de la lista de entidades permitidas de Runner y quita cualquier corredor que no esté incluido en ella.
	`getAbisForBuildTargetArch()` Muestra los ABIs compatibles con la arquitectura de destino de compilación del host.
	`getHostAbis()` Devuelve el abis de la máquina host.
`void`	`setPrioritizeHostConfig(boolean prioritizeHostConfig)` Establece la opción prioritize-host-config.
`boolean`	`shouldModuleRun(ModuleDefinition module)`

Campos

ABI_OPTION

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String BUILD_ATTRIBUTE_FLAG_OVERRIDES_KEY

ENABLE_RESOLVE_SYM_LINKS

public static final String ENABLE_RESOLVE_SYM_LINKS

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_END_TIME

public static final String MODULE_END_TIME

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

MODULE_START_TIME

public static final String MODULE_START_TIME

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

RANDOM_SEED

public static final String RANDOM_SEED

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

STAGE_MODULE_ARTIFACTS

public static final String STAGE_MODULE_ARTIFACTS

TEST_TYPE_KEY

public static final String TEST_TYPE_KEY

TEST_TYPE_VALUE_PERFORMANCE

public static final String TEST_TYPE_VALUE_PERFORMANCE

TOKEN_KEY

public static final String TOKEN_KEY

mEnableResolveSymlinks

protected boolean mEnableResolveSymlinks

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

Constructores públicos

ITestSuite

public ITestSuite ()

Métodos públicos

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

Parámetros
`filters`	`MultiMap`

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

Parámetros
`filters`	`MultiMap`

cleanUpSuiteSetup

public void cleanUpSuiteSetup ()

Es la oportunidad de limpiar todo lo que se necesitó durante la configuración de los paquetes, pero que no es necesario para ejecutar las pruebas.

filterByConfigMetadata

public boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

Aplica el filtro de metadatos a la configuración y comprueba si se debe ejecutar.

Parámetros
`config`	`IConfiguration`: Es el `IConfiguration` que se evalúa.
`include`	`MultiMap`: El filtro de inclusión de metadatos
`exclude`	`MultiMap`: El filtro de exclusión de metadatos

Muestra
`boolean`	Es verdadero si se debe ejecutar el módulo; de lo contrario, es falso.

getAbis

public  getAbis (ITestDevice device)

Obtiene el conjunto de ABIs compatibles con la AbiUtils.getAbisSupportedByCompatibility() de pruebas de compatibilidad y el dispositivo en prueba.

Parámetros
`device`	`ITestDevice`

Muestra
	Es el conjunto de ABIs en el que se ejecutarán las pruebas.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Devuelve los ABIs posibles de TestSuiteInfo.

Muestra

getBuildInfo

public IBuildInfo getBuildInfo ()

Es posible que la implementación de ITestSuite requiera que la información de compilación cargue las pruebas.

Muestra
`IBuildInfo`

getConfiguration

public final IConfiguration getConfiguration ()

Muestra la invocación IConfiguration.

Muestra
`IConfiguration`

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Muestra
`ITestLogger`

getDevice

public ITestDevice getDevice ()

Obtén el dispositivo en prueba.

Muestra
`ITestDevice`	el `ITestDevice`

getDirectModule

public ModuleDefinition getDirectModule ()

Muestra el ModuleDefinition que se ejecutará directamente o nulo si aún no hay ninguno (cuando ITestSuite aún no se ha particionado).

Muestra
`ModuleDefinition`

getIntraModuleSharding

public boolean getIntraModuleSharding ()

Muestra
`boolean`

getInvocationContext

public IInvocationContext getInvocationContext ()

Muestra el contexto de invocación.

Muestra
`IInvocationContext`

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

Muestra
`MultiMap<String, String>`

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

Muestra
`ITestSuite.MultiDeviceModuleStrategy`

getRequestedAbi

public final String getRequestedAbi ()

Muestra la ABI solicitada con la opción -a o --abi.

Muestra
`String`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Muestra la lista de tokens requeridos por la prueba. Muestra un valor nulo si no hay compatibilidad con tokens.

Parámetros
`testInfo`	`TestInformation`

Muestra

getRuntimeHint

public long getRuntimeHint ()

Muestra el tiempo de ejecución esperado de la prueba en milisegundos. El tiempo se usa para balancear la carga de la ejecución fragmentada.

Muestra
`long`

getTestsDir

public File getTestsDir ()

Muestra
`File`

isSplitting

public boolean isSplitting ()

Muestra verdadero si actualmente estamos en IShardableTest.split(int).

Muestra
`boolean`

loadTests

public abstract  loadTests ()

Es un método abstracto para cargar la configuración de las pruebas que se ejecutarán. Cada prueba se define con un IConfiguration y un nombre único con el que informará los resultados.

Muestra

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informa las pruebas no ejecutadas al objeto de escucha principal proporcionado. Se deben informar como fallas con el mensaje NOT_EXECUTED_FAILURE.

Parámetros
`listener`	`ITestInvocationListener`: Es el objeto de escucha principal en el que se informan los resultados que no se ejecutaron.
`message`	`String`: Es el mensaje que se asociará con la falla no ejecutada.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Informa las pruebas no ejecutadas al objeto de escucha principal proporcionado. Se deben informar como fallas con el mensaje NOT_EXECUTED_FAILURE.

Parámetros
`listener`	`ITestInvocationListener`: Es el objeto de escucha principal en el que se informan los resultados que no se ejecutaron.

run

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Es el método de ejecución genérico para todas las pruebas cargadas desde loadTests().

Parámetros
`testInfo`	`TestInformation`: Es el objeto `TestInformation` que contiene información útil para ejecutar pruebas.
`listener`	`ITestInvocationListener`: el `ITestInvocationListener` de los resultados de la prueba

Arroja
`DeviceNotAvailableException`

setAbiName

public void setAbiName (String abiName)

Establece el valor de mAbiName

Parámetros
`abiName`	`String`

setAbis

public final void setAbis ( abis)

Parámetros
`abis`

setBuild

public void setBuild (IBuildInfo buildInfo)

Parámetros
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Ejecuta el paquete de pruebas en modo de solo recopilador. Esto requiere que todas las pruebas secundarias también implementen esta interfaz.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inyecta el IConfiguration en uso.

Parámetros
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

Inyecta el dispositivo en prueba.

Parámetros
`device`	`ITestDevice`: Es el `ITestDevice` que se usará.

setDirectModule

public void setDirectModule (ModuleDefinition module)

Parámetros
`module`	`ModuleDefinition`

setIntraModuleSharding

public void setIntraModuleSharding (boolean intraModuleSharding)

Parámetros
`intraModuleSharding`	`boolean`

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parámetros
`invocationContext`	`IInvocationContext`

setMetricCollectors

public void setMetricCollectors ( collectors)

Establece la lista de IMetricCollector definidos para la ejecución de prueba.

Parámetros
`collectors`

setMultiDeviceStrategy

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parámetros
`strategy`	`ITestSuite.MultiDeviceModuleStrategy`

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Establece el valor de mPrimaryAbiRun

Parámetros
`primaryAbiRun`	`boolean`

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Cuando se realiza la fragmentación distribuida, no podemos tener ModuleDefinition que comparta pruebas en un grupo. De lo contrario, no funcionará la fragmentación intramódulo, por lo que permitimos inhabilitarla.

Parámetros
`dynamicModule`	`boolean`

setSkipContext

public void setSkipContext (SkipContext skipContext)

Parámetros
`skipContext`	`SkipContext`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Establece los ISystemStatusChecker de la configuración para la prueba.

Parámetros
`systemCheckers`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Inyecta la instancia de ITestLogger.

Parámetros
`testLogger`	`ITestLogger`

división

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Es una versión alternativa de split(int) que también proporciona un TestInformation que contiene información anticipada del elemento superior que crea los fragmentos. Es útil si se necesita acceder a información como la del dispositivo o la compilación durante la fragmentación.

Parámetros
`shardCountHint`	`Integer`: Es el recuento de fragmentos que se intentó.
`testInfo`	`TestInformation`: El elemento superior `TestInformation`

Muestra
	una colección de pruebas secundarias que se ejecutarán por separado o `null` si la prueba no se puede particionar en este momento

Métodos protegidos

createModuleListeners

protected  createModuleListeners ()

Muestra la lista de ITestInvocationListener aplicables al nivel ModuleListener. Estos objetos de escucha se volverán a usar para cada módulo, no se volverán a crear instancias, por lo que no deben suponer un estado interno.

Muestra

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Aplica el filtro de la lista de entidades permitidas de Runner y quita cualquier corredor que no esté incluido en ella. Si una configuración tiene varios ejecutores, es posible que se quiten algunos y la configuración se siga ejecutando.

Parámetros
`config`	`IConfiguration`: Es el `IConfiguration` que se evalúa.
`allowedRunners`	: Es la lista de entidades permitidas del ejecutor actual.

Muestra
`boolean`	Es verdadero si el módulo de configuración puede ejecutarse; de lo contrario, es falso.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Muestra los ABIs compatibles con la arquitectura de destino de compilación del host. Se expone para pruebas.

Muestra

getHostAbis

protected  getHostAbis ()

Devuelve el abis de la máquina host.

Muestra

setPrioritizeHostConfig

protected void setPrioritizeHostConfig (boolean prioritizeHostConfig)

Establece la opción prioritize-host-config.

Parámetros
`prioritizeHostConfig`	`boolean`: Es verdadero para priorizar la configuración del host, es decir, ejecutar la prueba del host si es posible.

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parámetros
`module`	`ModuleDefinition`

Devuelve
`boolean`