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

PruebaMappingSuiteRunner

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_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 el reinicio antes de la prueba en verdadero.
	`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).
`IInvocationContext`	`getInvocationContext ()` Devuelve el contexto de invocación.
`final String`	`getRequestedAbi ()` Devuelve el abi solicitado con la opción -a o --abi.
	`getRequiredTokens ()`
`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`	`setInvocationContext (IInvocationContext invocationContext)`
`void`	`setInvocationInjector (Injector injector)` Obtenga el `Injector` Guice actual de la invocación.
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Establece la lista de `IMetricCollector` definidos para la ejecución de prueba.
`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)`
	`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`	`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.
`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_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

SEMILLA ALEATORIA

public static final String RANDOM_SEED

REINICIAR_ANTES_PRUEBA

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

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`

habilitarReiniciarantes de la prueba

public final void enableRebootBeforeTest ()

Establece el reinicio antes de la prueba en verdadero.

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

obtener contexto de invocación

public IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación.

Devoluciones
`IInvocationContext`

getRequestedAbi

public final String getRequestedAbi ()

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

Devoluciones
`String`

obtener tokens requeridos

public  getRequiredTokens ()

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

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

establecer contexto de invocación

public void setInvocationContext (IInvocationContext invocationContext)

Parámetros
`invocationContext`	`IInvocationContext`

establecerInvocaciónInyector

public void setInvocationInjector (Injector injector)

Obtenga el Injector Guice actual de la invocación. Debería permitirnos continuar con la inyecció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)

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)

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

filterByConfigMetadata

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

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`