ITestSuite

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

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


Es la 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 ENABLE_RESOLVE_SYM_LINKS

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 STAGE_MODULE_ARTIFACTS

public static final String TEST_TYPE_KEY

public static final String TEST_TYPE_VALUE_PERFORMANCE

public static final String TOKEN_KEY

protected boolean mEnableResolveSymlinks

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 para limpiar todas las cosas que se necesitaban durante la instalación de las suites, pero que no son necesarias necesarias para ejecutar las pruebas.

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.

getAbis(ITestDevice device)

Obtiene el conjunto de ABI compatibles con la prueba de compatibilidad AbiUtils.getAbisSupportedByCompatibility() y el dispositivo a prueba.

static getAbisForBuildTargetArchFromSuite()

Muestra la posible abis desde el TestSuiteInfo.

IBuildInfo getBuildInfo()

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

final IConfiguration getConfiguration()

Muestra la invocación IConfiguration.

ITestLogger getCurrentTestLogger()
ITestDevice getDevice()

Pon el dispositivo a prueba.

ModuleDefinition getDirectModule()

Muestra el objeto ModuleDefinition que se ejecutará directamente, o un valor nulo si aún no lo hay (cuando el valor ITestSuite todavía no se ha fragmentado).

boolean getIntraModuleSharding()
IInvocationContext getInvocationContext()

Muestra el contexto de invocación.

MultiMap<String, String> getModuleMetadataIncludeFilters()
ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy()
final String getRequestedAbi()

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

getRequiredTokens(TestInformation testInfo)

Muestra la lista de tokens que requiere la prueba.

long getRuntimeHint()

Devuelve el tiempo de ejecución esperado de la prueba en milisegundos.

File getTestsDir()
boolean isSplitting()

Muestra true si nos encontramos en IShardableTest.split(int).

abstract loadTests()

Es un método abstracto para cargar la configuración de pruebas que se ejecutará.

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)

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 conjunto de pruebas en modo de solo colector, esto requiere que todas las subpruebas lo implementen también en la interfaz de usuario.

void setConfiguration(IConfiguration configuration)

Inserta el IConfiguration en uso.

void setDevice(ITestDevice device)

Inyecta el dispositivo a prueba.

void setDirectModule(ModuleDefinition module)
void setIntraModuleSharding(boolean intraModuleSharding)
void setInvocationContext(IInvocationContext invocationContext)

void setMetricCollectors( collectors)

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

void setMultiDeviceStrategy(ITestSuite.MultiDeviceModuleStrategy strategy)
void setPrimaryAbiRun(boolean primaryAbiRun)

Establece el valor de mPrimaryAbiRun

void setShouldMakeDynamicModule(boolean dynamicModule)

Cuando se realiza una 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 inhabilitarla.

void setSystemStatusChecker( systemCheckers)

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

void setTestLogger(ITestLogger testLogger)

Inserta la instancia ITestLogger.

split(Integer shardCountHint, TestInformation testInfo)

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 aplicable a ModuleListener. a nivel de organización.

boolean filterByRunnerType(IConfiguration config, allowedRunners)

Aplica el filtro de lista blanca de ejecutores y quita cualquier ejecutor que no esté incluido en la lista blanca.

getAbisForBuildTargetArch()

Devuelve la ABI compatible con la arquitectura de destino de la compilación del host.

getHostAbis()

Muestra la ABI de la máquina anfitrión.

boolean shouldModuleRun(ModuleDefinition module)

Campos

OPCIÓN DE ABI

public static final String ABI_OPTION

CLAVE_PARÁMETRO_MAINLINE_ACTIVA

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ENABLE_RESOLVE_SYM_LINKS

CLAVE_PARÁMETRO_MAINLINEA

public static final String MAINLINE_PARAMETER_KEY

PUBLICACIÓN_DE_MODULE_CHECKER

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

FILTROS_EXCLUIDOS_DE_METADATOS_MODULE

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

CLAVE_PARÁMETRO_DE_PARÁMETRO

public static final String PARAMETER_KEY

LISTA BLANCA DE PREPARACIÓN

public static final String PREPARER_WHITELIST

EJECUCIÓN_DE_ABI_PRINCIPAL

public static final String PRIMARY_ABI_RUN

SEED ALEATORIO

public static final String RANDOM_SEED

LISTA BLANCA

public static final String RUNNER_WHITELIST

OMITIR_LA_VERSIÓN_DE_ARCHIVO_HOST

public static final String SKIP_HOST_ARCH_CHECK

OMITIR_STAGING_ARTEFACTOS

public static final String SKIP_STAGING_ARTIFACTS

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

ARTEFACTOS_MODULES_DESPUÉS DE STAGE_MODULE_ARTIFACTS

public static final String STAGE_MODULE_ARTIFACTS

CLAVE_TIPO_PRUEBA

public static final String TEST_TYPE_KEY

TIPO_DE_PRUEBA_VALOR_RENDIMIENTO

public static final String TEST_TYPE_VALUE_PERFORMANCE

CLAVE_TOKEN

public static final String TOKEN_KEY

protected boolean mEnableResolveSymlinks

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

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

CleanUpSuiteSetup

public void cleanUpSuiteSetup ()

Oportunidad para limpiar todas las cosas que se necesitaban durante la instalación de las suites, pero que no son necesarias necesarias para ejecutar las pruebas.

filterByConfigMetadata

public 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: el IConfiguration que se evalúa.

include MultiMap: Es el filtro de inclusión de metadatos.

exclude MultiMap: Es el filtro de exclusión de metadatos.

Muestra
boolean Es verdadero si debe ejecutarse el módulo. De lo contrario, es falso.

getAbis

public  getAbis (ITestDevice device)

Obtiene el conjunto de ABI compatibles con la prueba de compatibilidad AbiUtils.getAbisSupportedByCompatibility() y el dispositivo a prueba.

Parámetros
device ITestDevice

Muestra
Es el conjunto de ABI en los que se ejecutarán las pruebas.

Arroja
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Muestra la posible abis desde el TestSuiteInfo.

Muestra

getBuildInfo

public IBuildInfo getBuildInfo ()

La implementación de ITestSuite puede requerir la información de compilación para cargar 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 ()

Pon el dispositivo a prueba.

Muestra
ITestDevice ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Devuelve el objeto ModuleDefinition que se ejecutará directamente o un valor nulo si aún no lo hiciste (cuando el ITestSuite aún no se ha fragmentado).

Muestra
ModuleDefinition

getIntraModuleSharding

public boolean getIntraModuleSharding ()

Muestra
boolean

getInvocationContext

public IInvocationContext getInvocationContext ()

Muestra el contexto de invocación.

Muestra
IInvocationContext

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

Muestra
MultiMap<String, String>

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

Muestra
ITestSuite.MultiDeviceModuleStrategy

getRequestedAbi

public final String getRequestedAbi ()

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

Muestra
String

getObligatorioTokens

public  getRequiredTokens (TestInformation testInfo)

Muestra la lista de tokens que requiere la prueba. Muestra un valor nulo si no se admite ningún token.

Parámetros
testInfo TestInformation

Muestra

getRuntimeHint

public long getRuntimeHint ()

Devuelve el tiempo de ejecución esperado de la prueba en milisegundos. El tiempo se usa para balancear las cargas de la ejecución fragmentada

Muestra
long

getTestsDir

public File getTestsDir ()

Muestra
File

Se está dividiendo

public boolean isSplitting ()

Muestra true si nos encontramos en IShardableTest.split(int).

Muestra
boolean

Pruebas de carga

public abstract  loadTests ()

Es un método abstracto para cargar la configuración de pruebas que se ejecutará. Cada prueba se define por un IConfiguration y un nombre único con el que se informarán los resultados.

Muestra

informeNo ejecutado

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informa las pruebas no ejecutadas al objeto de escucha principal proporcionado. Se deben informar como Se produjo un error con el mensaje NOT_EXECUTED_FAILURE.

Parámetros
listener ITestInvocationListener: Es el objeto de escucha principal en el que se informan los resultados no ejecutados.

message String: Es el mensaje que se asociará con el error no ejecutado.

informeNo ejecutado

public void reportNotExecuted (ITestInvocationListener listener)

Informa las pruebas no ejecutadas al objeto de escucha principal proporcionado. Se deben informar como Se produjo un error con el mensaje NOT_EXECUTED_FAILURE.

Parámetros
listener ITestInvocationListener: Es el objeto de escucha principal en el que se informan los resultados no ejecutados.

run

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: Es el objeto TestInformation que contiene información útil para ejecutar. y pruebas.

listener ITestInvocationListener: el ITestInvocationListener de los resultados de la prueba

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

Solo RecopilarTests

public void setCollectTestsOnly (boolean shouldCollectTest)

Ejecuta el conjunto de pruebas en modo de solo colector, esto requiere que todas las subpruebas lo implementen también en la interfaz de usuario.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserta el IConfiguration en uso.

Parámetros
configuration IConfiguration

SetDevice

public void setDevice (ITestDevice device)

Inyecta el dispositivo a prueba.

Parámetros
device ITestDevice: Es el ITestDevice que se usará.

setDirectModule

public void setDirectModule (ModuleDefinition module)

Parámetros
module ModuleDefinition

SetIntraModuleSharding

public void setIntraModuleSharding (boolean intraModuleSharding)

Parámetros
intraModuleSharding boolean

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parámetros
invocationContext IInvocationContext

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parámetros
collectors

setMultiDeviceStrategy

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parámetros
strategy ITestSuite.MultiDeviceModuleStrategy

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Establece el valor de mPrimaryAbiRun

Parámetros
primaryAbiRun boolean

setDeberíahacerDinámicoModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Cuando se realiza una 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 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)

Inserta la instancia ITestLogger.

Parámetros
testLogger ITestLogger

división

public  split (Integer shardCountHint, 
                TestInformation testInfo)

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 cosas como el dispositivo o la compilación durante la fragmentación.

Parámetros
shardCountHint Integer: Es el recuento de intentos de fragmentos.

testInfo TestInformation: Es el elemento superior TestInformation.

Muestra
una colección de subpruebas que se ejecutarán por separado o null si la prueba es no es fragmentable actualmente

Métodos protegidos

createModuleListeners

protected  createModuleListeners ()

Muestra la lista de ITestInvocationListener aplicable a ModuleListener. a nivel de organización. Estos objetos de escucha se volverán a usar para cada módulo; no se creará una nueva instancia de ellos, por lo que no deberían asumir un estado interno.

Muestra

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Aplica el filtro de lista blanca de ejecutores y quita cualquier ejecutor que no esté incluido en la lista blanca. Si un tiene varios ejecutores, es posible que algunos se quiten y la configuración siga ejecutándose.

Parámetros
config IConfiguration: el IConfiguration que se evalúa.

allowedRunners : Es la lista blanca actual del ejecutor.

Muestra
boolean Es verdadero si se permite la ejecución del módulo de configuración. De lo contrario, es falso.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

Muestra

getHostAbis

protected  getHostAbis ()

Muestra la ABI de la máquina anfitrión.

Muestra

EjecutarMódulo

protected boolean shouldModuleRun (ModuleDefinition module)

Parámetros
module ModuleDefinition

Devuelve
boolean