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 IRemoteTest, IDeviceTest, IBuildReceiver, ISystemStatusCheckerReceiver, IShardableTest, ITestCollector, IInvocationContextReceiver, IRuntimeHintProvider, IMetricCollectorReceiver, IConfigurationReceiver, IReportNotExecuted, ITokenRequest, ITestLoggerReceiver

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

TestMappingSuiteRunner

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`	`MAINLINE_PARAMETER_KEY`
`public static final String`	`MODULE_CHECKER_POST`
`public static final String`	`MODULE_CHECKER_PRE`
`public static final String`	`MODULE_METADATA_EXCLUDE_FILTER`
`public static final String`	`MODULE_METADATA_INCLUDE_FILTER`
`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`	`REBOOT_BEFORE_TEST`
`public static final String`	`RUNNER_WHITELIST`
`public static final String`	`SKIP_HOST_ARCH_CHECK`
`public static final String`	`SKIP_SYSTEM_STATUS_CHECKER`
`public static final String`	`TOKEN_KEY`

Constructores públicos
`ITestSuite()`

Métodos públicos
`void`	`addModuleMetadataExcludeFilters(MultiMap<String, String> filters)`
`void`	`addModuleMetadataIncludeFilters(MultiMap<String, String> filters)`
`final void`	`enableRebootBeforeTest()` Establece reboot-before-test en verdadero.
	`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).
`IInvocationContext`	`getInvocationContext()` Muestra el contexto de invocación.
`final String`	`getRequestedAbi()` Muestra la ABI solicitada con la opción -a o --abi.
	`getRequiredTokens()`
`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`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setInvocationInjector(Injector injector)` Obtén el `Injector` de Guice actual de la invocación.
`void`	`setMetricCollectors( collectors)` Establece la lista de `IMetricCollector` definidos para la ejecución de prueba.
`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`	`setSystemStatusChecker( systemCheckers)` Establece los `ISystemStatusChecker` de la configuración para la prueba.
`void`	`setTestLogger(ITestLogger testLogger)`
	`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`	`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.
`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.
`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

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_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

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

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

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`

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

Establece reboot-before-test en verdadero.

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
`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`

getInvocationContext

public IInvocationContext getInvocationContext ()

Muestra el contexto de invocación.

Muestra
`IInvocationContext`

getRequestedAbi

public final String getRequestedAbi ()

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

Muestra
`String`

getRequiredTokens

public  getRequiredTokens ()

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`
`listener`	`ITestInvocationListener`

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á.

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parámetros
`invocationContext`	`IInvocationContext`

setInvocationInjector

public void setInvocationInjector (Injector injector)

Obtén el Injector de Guice actual de la invocación. Debería permitirnos continuar con la inserción de objetos de módulos.

Parámetros
`injector`	`Injector`

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parámetros
`collectors`

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`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

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

Parámetros
`systemCheckers`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

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

filterByConfigMetadata

protected 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.

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

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parámetros
`module`	`ModuleDefinition`

Devuelve
`boolean`