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


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

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

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

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