Esta página se ha traducido con Cloud Translation API.

Suite de pruebas

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

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

Subclases directas conocidas

BaseTestSuite , TfSuiteRunner

BaseTestSuite	Una prueba para ejecutar Compatibility Test Suite con el nuevo sistema de suite.
TfSuiteRunner	Implementación de `ITestSuite` que cargará pruebas desde la carpeta TF jars res/config/suite/.

Subclases indirectas conocidas

AtestRunner , TestMappingSuiteRunner

AtestRunner	Implementación de `ITestSuite`
PruebaMappingSuiteRunner	Implementación de `BaseTestSuite` para ejecutar pruebas especificadas por la opción include-filter o archivos TEST_MAPPING de la compilación, como una suite.

Clase abstracta utilizada para ejecutar Test Suite. Esta clase proporciona la base de cómo se ejecutará la Suite. Cada implementación puede definir la lista de pruebas mediante el 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_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`	`TEST_TYPE_KEY`
`public static final String`	`TEST_TYPE_VALUE_PERFORMANCE`
`public static final String`	`TOKEN_KEY`
`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 ()` Oportunidad de limpiar todas las cosas que fueron necesarias durante la configuración de las suites pero que no son necesarias para ejecutar las pruebas.
`boolean`	`filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude)` Aplique el filtro de metadatos a la configuración y vea si la configuración debería ejecutarse.
	`getAbis ( ITestDevice device)` Obtiene el conjunto de ABI admitidas tanto por las pruebas de compatibilidad `AbiUtils.getAbisSupportedByCompatibility()` como por el dispositivo bajo prueba.
`static`	`getAbisForBuildTargetArchFromSuite ()` Devuelve los posibles abis de TestSuiteInfo.
`IBuildInfo`	`getBuildInfo ()` La implementación de `ITestSuite` puede requerir la información de compilación para cargar las pruebas.
`final IConfiguration`	`getConfiguration ()` Devuelve la invocación `IConfiguration` .
`ITestLogger`	`getCurrentTestLogger ()`
`ITestDevice`	`getDevice ()` Ponga a prueba el dispositivo.
`ModuleDefinition`	`getDirectModule ()` Devuelve `ModuleDefinition` que se ejecutará directamente, o null si todavía no hay ninguno (cuando ITestSuite aún no se ha fragmentado).
`boolean`	`getIntraModuleSharding ()`
`IInvocationContext`	`getInvocationContext ()` Devuelve el contexto de invocación.
`MultiMap <String, String>`	`getModuleMetadataIncludeFilters ()`
`ITestSuite.MultiDeviceModuleStrategy`	`getMultiDeviceStrategy ()`
`final String`	`getRequestedAbi ()` Devuelve el abi solicitado con la opción -a o --abi.
	`getRequiredTokens ( TestInformation testInfo)` Devuelve la lista de tokens requeridos por la prueba.
`long`	`getRuntimeHint ()` Devuelve el tiempo de ejecución esperado de la prueba en milisegundos.
`File`	`getTestsDir ()`
`boolean`	`isSplitting ()` Devuelve verdadero si actualmente estamos en `IShardableTest.split(int)` .
`abstract`	`loadTests ()` Método abstracto para cargar la configuración de las pruebas que se ejecutarán.
`void`	`reportNotExecuted ( ITestInvocationListener listener, String message)` Informar las pruebas no ejecutadas al oyente principal proporcionado.
`void`	`reportNotExecuted ( ITestInvocationListener listener)` Informar las pruebas no ejecutadas al oyente principal proporcionado.
`final void`	`run ( TestInformation testInfo, ITestInvocationListener listener)` Método de ejecución genérico para todas las pruebas cargadas desde `loadTests()` .
`void`	`setAbiName (String abiName)` Establecer el valor de mAbiName
`final void`	`setAbis ( abis)` `setAbis ( abis)`
`void`	`setBuild ( IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly (boolean shouldCollectTest)` Ejecute el conjunto de pruebas en modo solo recopilador; esto requiere que todas las subpruebas también implementen esta interfaz.
`void`	`setConfiguration ( IConfiguration configuration)` Inyecta la `IConfiguration` en uso.
`void`	`setDevice ( ITestDevice device)` Inyecte el dispositivo bajo prueba.
`void`	`setDirectModule ( ModuleDefinition module)`
`void`	`setIntraModuleSharding (boolean intraModuleSharding)`
`void`	`setInvocationContext ( IInvocationContext invocationContext)`
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Establece la lista de `IMetricCollector` definidos para la ejecución de prueba.
`void`	`setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)`
`void`	`setPrimaryAbiRun (boolean primaryAbiRun)` Establecer el valor de mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule (boolean dynamicModule)` Al realizar fragmentación distribuida, no podemos tener ModuleDefinition que comparta pruebas en un grupo; de lo contrario, la fragmentación dentro del módulo no funcionará, por lo que permitimos desactivarla.
`void`	`setSystemStatusChecker ( systemCheckers)` `setSystemStatusChecker ( systemCheckers)` Establece los `ISystemStatusChecker` de la configuración para la prueba.
`void`	`setTestLogger ( ITestLogger testLogger)` Inyecta la instancia `ITestLogger`
	`split (Integer shardCountHint, TestInformation testInfo)` Versión alternativa de `split(int)` que también proporciona `TestInformation` que contiene información inicial del padre que crea los fragmentos.

Métodos protegidos
	`createModuleListeners ()` Devuelve la lista de `ITestInvocationListener` aplicable al nivel `ModuleListener` .
`boolean`	`filterByRunnerType ( IConfiguration config, allowedRunners)` `filterByRunnerType ( IConfiguration config, allowedRunners)` Aplique el filtrado de lista blanca de corredores, eliminando cualquier corredor que no esté en la lista blanca.
	`getAbisForBuildTargetArch ()` Devuelve el abis compatible con la arquitectura de destino de compilación del host.
	`getHostAbis ()` Devuelve la máquina host abis.
`boolean`	`shouldModuleRun ( ModuleDefinition module)`

Campos

ABI_OPCIÓN

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

SEMILLA ALEATORIA

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

PRUEBA_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

mRecoverDevicePorCvd

protected boolean mRecoverDeviceByCvd

Constructores públicos

Suite de pruebas

public ITestSuite ()

Métodos públicos

addModuleMetadataExcludeFilters

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

Parámetros
`filters`	`MultiMap`

agregarModuleMetadataIncludeFilters

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

Parámetros
`filters`	`MultiMap`

limpiezaSuiteConfiguración

public void cleanUpSuiteSetup ()

Oportunidad de limpiar todas las cosas que fueron necesarias durante la configuración de las suites pero que no son necesarias para ejecutar las pruebas.

filterByConfigMetadata

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

Aplique el filtro de metadatos a la configuración y vea si la configuración debería ejecutarse.

Parámetros
`config`	`IConfiguration` : La `IConfiguration` que se está evaluando.
`include`	`MultiMap` : el filtro de inclusión de metadatos
`exclude`	`MultiMap` : el filtro de exclusión de metadatos

Devoluciones
`boolean`	Verdadero si el módulo debe ejecutarse; falso en caso contrario.

obtenerAbis

public  getAbis (ITestDevice device)

Obtiene el conjunto de ABI admitidas tanto por las pruebas de compatibilidad AbiUtils.getAbisSupportedByCompatibility() como por el dispositivo bajo prueba.

Parámetros
`device`	`ITestDevice`

Devoluciones
	El conjunto de ABI para ejecutar las pruebas.

Lanza
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Devuelve los posibles abis de TestSuiteInfo.

Devoluciones

obtener información de compilación

public IBuildInfo getBuildInfo ()

La implementación de ITestSuite puede requerir la información de compilación para cargar las pruebas.

Devoluciones
`IBuildInfo`

obtener configuración

public final IConfiguration getConfiguration ()

Devuelve la invocación IConfiguration .

Devoluciones
`IConfiguration`

obtenerCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Devoluciones
`ITestLogger`

obtener dispositivo

public ITestDevice getDevice ()

Ponga a prueba el dispositivo.

Devoluciones
`ITestDevice`	el `ITestDevice`

getDirectModule

public ModuleDefinition getDirectModule ()

Devuelve ModuleDefinition que se ejecutará directamente, o null si todavía no hay ninguno (cuando ITestSuite aún no se ha fragmentado).

Devoluciones
`ModuleDefinition`

getIntraModuleSharding

public boolean getIntraModuleSharding ()

Devoluciones
`boolean`

obtener contexto de invocación

public IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación.

Devoluciones
`IInvocationContext`

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

Devoluciones
`MultiMap <String, String>`

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

Devoluciones
`ITestSuite.MultiDeviceModuleStrategy`

getRequestedAbi

public final String getRequestedAbi ()

Devuelve el abi solicitado con la opción -a o --abi.

Devoluciones
`String`

obtener tokens requeridos

public  getRequiredTokens (TestInformation testInfo)

Devuelve la lista de tokens requeridos por la prueba. Devuelve nulo si no hay soporte para tokens.

Parámetros
`testInfo`	`TestInformation`

Devoluciones

getRuntimeHint

public long getRuntimeHint ()

Devuelve el tiempo de ejecución esperado de la prueba en milisegundos. El tiempo se utiliza para equilibrar la carga de la ejecución fragmentada.

Devoluciones
`long`

obtenerTestsDir

public File getTestsDir ()

Devoluciones
`File`

se está dividiendo

public boolean isSplitting ()

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

Devoluciones
`boolean`

pruebas de carga

public abstract  loadTests ()

Método abstracto para cargar la configuración de las pruebas que se ejecutarán. Cada prueba está definida por una IConfiguration y un nombre único bajo el cual informará los resultados.

Devoluciones

informarNoEjecutado

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informar las pruebas no ejecutadas al oyente principal proporcionado. Deben informarse como fallidos con el mensaje NOT_EXECUTED_FAILURE .

Parámetros
`listener`	`ITestInvocationListener` : el oyente principal donde informar los resultados no ejecutados.
`message`	`String` : el mensaje que se asociará con el error no ejecutado.

informarNoEjecutado

public void reportNotExecuted (ITestInvocationListener listener)

Informar las pruebas no ejecutadas al oyente principal proporcionado. Deben informarse como fallidos con el mensaje NOT_EXECUTED_FAILURE .

Parámetros
`listener`	`ITestInvocationListener` : el oyente principal donde informar los resultados no ejecutados.

correr

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

Lanza
`DeviceNotAvailableException`

establecerNombreAbi

public void setAbiName (String abiName)

Establecer el valor de mAbiName

Parámetros
`abiName`	`String`

conjuntoAbis

public final void setAbis ( abis)

Parámetros
`abis`

establecerConstruir

public void setBuild (IBuildInfo buildInfo)

Parámetros
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Ejecute el conjunto de pruebas en modo solo recopilador; esto requiere que todas las subpruebas también implementen esta interfaz.

establecer configuración

public void setConfiguration (IConfiguration configuration)

Inyecta la IConfiguration en uso.

Parámetros
`configuration`	`IConfiguration`

establecer dispositivo

public void setDevice (ITestDevice device)

Inyecte el dispositivo bajo prueba.

Parámetros
`device`	`ITestDevice` : el `ITestDevice` a utilizar

setDirectModule

public void setDirectModule (ModuleDefinition module)

Parámetros
`module`	`ModuleDefinition`

setIntraModuleSharding

public void setIntraModuleSharding (boolean intraModuleSharding)

Parámetros
`intraModuleSharding`	`boolean`

establecer contexto de invocación

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`

establecer estrategia multidispositivo

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parámetros
`strategy`	`ITestSuite.MultiDeviceModuleStrategy`

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Establecer el valor de mPrimaryAbiRun

Parámetros
`primaryAbiRun`	`boolean`

setDebería hacer un módulo dinámico

public void setShouldMakeDynamicModule (boolean dynamicModule)

Al realizar fragmentación distribuida, no podemos tener ModuleDefinition que comparta pruebas en un grupo; de lo contrario, la fragmentación dentro del módulo no funcionará, por lo que permitimos desactivarla.

Parámetros
`dynamicModule`	`boolean`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

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

Parámetros
`systemCheckers`

establecerTestLogger

public void setTestLogger (ITestLogger testLogger)

Inyecta la instancia ITestLogger

Parámetros
`testLogger`	`ITestLogger`

dividir

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Versión alternativa de split(int) que también proporciona TestInformation que contiene información inicial del padre que crea los fragmentos. Es útil si es necesario acceder a elementos como la información del dispositivo o de la compilación durante la fragmentación.

Parámetros
`shardCountHint`	`Integer` : el recuento de fragmentos intentado.
`testInfo`	`TestInformation` : el padre `TestInformation`

Devoluciones
	una colección de subpruebas que se ejecutarán por separado o serán `null` si la prueba no se puede fragmentar actualmente

Métodos protegidos

crearModuleListeners

protected  createModuleListeners ()

Devuelve la lista de ITestInvocationListener aplicable al nivel ModuleListener . Estos oyentes se reutilizarán para cada módulo, no se volverán a crear instancias de ellos, por lo que no deben asumir un estado interno.

Devoluciones

filtroPorTipodecorredor

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Aplique el filtrado de lista blanca de corredores, eliminando cualquier corredor que no esté en la lista blanca. Si una configuración tiene varios ejecutores, es posible que algunos se eliminen y la configuración seguirá ejecutándose.

Parámetros
`config`	`IConfiguration` : La `IConfiguration` que se está evaluando.
`allowedRunners`	: La lista blanca de corredores actual.

Devoluciones
`boolean`	Verdadero si se permite la ejecución del módulo de configuración; falso en caso contrario.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Devuelve el abis compatible con la arquitectura de destino de compilación del host. Expuesto para pruebas.

Devoluciones

obtenerHostAbis

protected  getHostAbis ()

Devuelve la máquina host abis.

Devoluciones

deberíaModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parámetros
`module`	`ModuleDefinition`

Devoluciones
`boolean`