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.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`
TestMappingSuiteRunner	Implementación de `BaseTestSuite` para ejecutar pruebas especificadas por la opción include-filter o archivos TEST_MAPPING desde 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 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`	`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)`
	`getAbis ( ITestDevice device)` Obtiene el conjunto de ABI compatibles con las pruebas de compatibilidad `AbiUtils.getAbisSupportedByCompatibility()` y el dispositivo bajo prueba.
`static`	`getAbisForBuildTargetArchFromSuite ()` Devuelve el posible 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 ()` Obtenga el dispositivo bajo prueba.
`ModuleDefinition`	`getDirectModule ()` Devuelve `ModuleDefinition` para que se ejecute directamente, o nulo si aún no lo ha hecho (cuando ITestSuite aún no se ha fragmentado).
`IInvocationContext`	`getInvocationContext ()` Devuelve el contexto de invocación.
`MultiMap <String, String>`	`getModuleMetadataIncludeFilters ()`
`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)` Informe las pruebas no ejecutadas al oyente principal proporcionado.
`void`	`reportNotExecuted ( ITestInvocationListener listener)` Informe 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 de solo recopilador, esto requiere todas las subpruebas para implementar esta interfaz también.
`void`	`setConfiguration ( IConfiguration configuration)` Inyecta la `IConfiguration` en uso.
`void`	`setDevice ( ITestDevice device)` Inyecte el dispositivo bajo prueba.
`void`	`setDirectModule ( ModuleDefinition module)`
`void`	`setInvocationContext ( IInvocationContext invocationContext)`
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Establece la lista de `IMetricCollector` definidos para la ejecución de la prueba.
`void`	`setPrimaryAbiRun (boolean primaryAbiRun)` Establecer el valor de mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule (boolean dynamicModule)` Al hacer fragmentación distribuida, no podemos tener ModuleDefinition que comparte pruebas en un grupo; de lo contrario, la fragmentación dentro del módulo no funcionará, por lo que permitimos deshabilitarla.
`void`	`setSystemStatusChecker ( systemCheckers)` `setSystemStatusChecker ( systemCheckers)` Establece los `ISystemStatusChecker` desde 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 temprana del padre que crea los fragmentos.

Métodos protegidos
	`createModuleListeners ()` Devuelve la lista de `ITestInvocationListener` aplicable al nivel de `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 debe ejecutarse.
`boolean`	`filterByRunnerType ( IConfiguration config, allowedRunners)` `filterByRunnerType ( IConfiguration config, allowedRunners)` Aplique el filtrado de la 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 el abis de la máquina host.
`void`	`setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)`
`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

LÍNEA PRINCIPAL_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

PREPARADOR_LISTABLANCO

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

SEMILLA ALEATORIA

public static final String RANDOM_SEED

CORREDOR_LISTABLANCA

public static final String RUNNER_WHITELIST

SALTAR_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

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

obtenerAbis

public  getAbis (ITestDevice device)

Obtiene el conjunto de ABI compatibles con las pruebas de compatibilidad AbiUtils.getAbisSupportedByCompatibility() y el dispositivo bajo prueba.

Parámetros
`device`	`ITestDevice`

Devoluciones
	El conjunto de ABI para ejecutar las pruebas en

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

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Devuelve el posible abis de TestSuiteInfo.

Devoluciones

getBuildInfo

public IBuildInfo getBuildInfo ()

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

Devoluciones
`IBuildInfo`

getConfiguration

public final IConfiguration getConfiguration ()

Devuelve la invocación IConfiguration .

Devoluciones
`IConfiguration`

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Devoluciones
`ITestLogger`

obtenerDispositivo

public ITestDevice getDevice ()

Obtenga el dispositivo bajo prueba.

Devoluciones
`ITestDevice`	el `ITestDevice`

getDirectModule

public ModuleDefinition getDirectModule ()

Devuelve ModuleDefinition para que se ejecute directamente, o nulo si aún no lo ha hecho (cuando ITestSuite aún no se ha fragmentado).

Devoluciones
`ModuleDefinition`

getInvocationContext

public IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación.

Devoluciones
`IInvocationContext`

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

Devoluciones
`MultiMap <String, String>`

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 de token.

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`

getTestsDir

public File getTestsDir ()

Devoluciones
`File`

es dividir

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

informe no ejecutado

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informe 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 reportar los resultados no ejecutados.
`message`	`String` : el mensaje que se asociará con la falla no ejecutada.

informe no ejecutado

public void reportNotExecuted (ITestInvocationListener listener)

Informe 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 reportar 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 de solo recopilador, esto requiere todas las subpruebas para implementar esta interfaz también.

setConfiguration

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

establecerModuloDirecto

public void setDirectModule (ModuleDefinition module)

Parámetros
`module`	`ModuleDefinition`

establecerInvocaciónContexto

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 la prueba.

Parámetros
`collectors`

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Establecer el valor de mPrimaryAbiRun

Parámetros
`primaryAbiRun`	`boolean`

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

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

Parámetros
`dynamicModule`	`boolean`

establecerSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

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

Parámetros
`systemCheckers`

setTestLogger

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 temprana del padre que crea los fragmentos. Es útil si es necesario acceder a elementos como el dispositivo o la información de compilación durante la fragmentación.

Parámetros
`shardCountHint`	`Integer` : el número de fragmentos intentados.
`testInfo`	`TestInformation` : El padre `TestInformation`

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

Métodos protegidos

createModuleListeners

protected  createModuleListeners ()

Devuelve la lista de ITestInvocationListener aplicable al nivel de ModuleListener . Estos oyentes se reutilizarán para cada módulo, no se volverán a crear instancias, por lo que no deberían 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 debe 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.

filtroPorTipoCorredor

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

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

Parámetros
`config`	`IConfiguration` : la `IConfiguration` que se está evaluando.
`allowedRunners`	: La lista blanca actual del corredor.

Devoluciones
`boolean`	Verdadero si el módulo de configuración puede ejecutarse, falso en caso contrario.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

Devoluciones

getHostAbis

protected  getHostAbis ()

Devuelve el abis de la máquina host.

Devoluciones

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parámetros
`strategy`	`ITestSuite.MultiDeviceModuleStrategy`

deberíaModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parámetros
`module`	`ModuleDefinition`

Devoluciones
`boolean`