ITestSuite

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

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

Configura el reinicio antes de la prueba como verdadero.

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

IInvocationContext getInvocationContext()

Muestra el contexto de invocación.

final String getRequestedAbi()

Muestra la abi solicitada 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()

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 setInvocationContext(IInvocationContext invocationContext)

void setInvocationInjector(Injector injector)

Obtén el Injector de Guice actual de la invocación.

void setMetricCollectors( collectors)

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

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)

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

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

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

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

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

REBOOT_ANTES_DE_PRUEBA

public static final String REBOOT_BEFORE_TEST

LISTA BLANCA

public static final String RUNNER_WHITELIST

OMITIR_LA_VERSIÓN_DE_ARCHIVO_HOST

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

CLAVE_TOKEN

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

habilitación de reinicio antes de la prueba

public final void enableRebootBeforeTest ()

Configura el reinicio antes de la prueba como verdadero.

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

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

Muestra
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

Muestra el contexto de invocación.

Muestra
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

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

Muestra
String

getObligatorioTokens

public  getRequiredTokens ()

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 ejecuciones fragmentadas

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

listener ITestInvocationListener

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

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parámetros
invocationContext IInvocationContext

setInvocationInyector

public void setInvocationInjector (Injector injector)

Obtén el Injector de Guice actual de la invocación. Debería permitirnos continuar la inserción de objetos de los módulos.

Parámetros
injector Injector

setMetricCollectors

public void setMetricCollectors ( collectors)

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

Parámetros
collectors

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)

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

filterByConfigMetadata

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

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