ITestSuite
public abstract class ITestSuite
extends Object
implements IRemoteTest, IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest, ITestLoggerReceiver
java.lang.Object | |
↳ | 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 aplicación puede definir la lista de pruebas a través de los loadTests()
método.
Resumen
Los 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 reiniciar antes de la prueba en verdadero. |
getAbis (ITestDevice device) Obtiene el conjunto de ABIs apoyada por tanto pruebas de compatibilidad | |
static | getAbisForBuildTargetArchFromSuite () Devuelve el posible abis de TestSuiteInfo. |
IBuildInfo | getBuildInfo () Implementación de |
final IConfiguration | getConfiguration () Devuelve la invocación |
ITestLogger | getCurrentTestLogger () |
ITestDevice | getDevice () Pon a prueba el dispositivo. |
ModuleDefinition | getDirectModule () Devuelve el |
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 |
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 run genérico para todas las pruebas de carga desde |
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 el |
void | setDevice (ITestDevice device) Inyecte el dispositivo bajo prueba. |
void | setInvocationContext (IInvocationContext invocationContext) |
void | setInvocationInjector (Injector injector) Obtener la corriente Guice |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) Establece la lista de |
void | setPrimaryAbiRun (boolean primaryAbiRun) Establecer el valor de mPrimaryAbiRun |
void | setShouldMakeDynamicModule (boolean dynamicModule) Al hacer 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 deshabilitarla. |
void | setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Establece el |
void | setTestLogger (ITestLogger testLogger) |
split (Integer shardCountHint, TestInformation testInfo) Versión alternativa de |
Métodos protegidos | |
---|---|
createModuleListeners () Devuelve la lista de | |
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 lista blanca de corredores, eliminando cualquier corredor que no estuviera en la lista blanca. |
getAbisForBuildTargetArch () Devuelve el abis compatible con la arquitectura de destino de la compilación del host. | |
getHostAbis () Devuelve la máquina host abis. | |
boolean | shouldModuleRun ( ModuleDefinition module) |
Los campos
ABI_OPTION
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
REBOOT_BEFORE_TEST
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
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 |
enableRebootBeforeTest
public final void enableRebootBeforeTest ()
Establece reiniciar antes de la prueba en verdadero.
getAbis
publicgetAbis (ITestDevice device)
Obtiene el conjunto de ABIs apoyada por tanto pruebas de compatibilidad AbiUtils.getAbisSupportedByCompatibility()
y el dispositivo bajo prueba.
Parámetros | |
---|---|
device | ITestDevice |
Devoluciones | |
---|---|
El conjunto de ABI para ejecutar las pruebas |
Lanza | |
---|---|
DeviceNotAvailableException |
getAbisForBuildTargetArchFromSuite
public staticgetAbisForBuildTargetArchFromSuite ()
Devuelve el posible abis de TestSuiteInfo.
Devoluciones | |
---|---|
getBuildInfo
public IBuildInfo getBuildInfo ()
Implementación de ITestSuite
puede requerir la información de generació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 |
getDevice
public ITestDevice getDevice ()
Pon a prueba el dispositivo.
Devoluciones | |
---|---|
ITestDevice | la ITestDevice |
getDirectModule
public ModuleDefinition getDirectModule ()
Devuelve el ModuleDefinition
a ser ejecutados directamente, o null si no hay ninguna todavía (cuando el ITestSuite no ha sido fragmentada aún).
Devoluciones | |
---|---|
ModuleDefinition |
getInvocationContext
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 |
getRequiredTokens
publicgetRequiredTokens ()
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 |
está dividiendo
public boolean isSplitting ()
Devuelve verdadero si actualmente estamos en IShardableTest.split(int)
.
Devoluciones | |
---|---|
boolean |
loadTests
public abstractloadTests ()
Método abstracto para cargar la configuración de las pruebas que se ejecutarán. Cada ensayo se define por un IConfiguration
y un único nombre bajo el cual se reportará resultados.
Devoluciones | |
---|---|
reportNotExecuted
public void reportNotExecuted (ITestInvocationListener listener, String message)
Informe las pruebas no ejecutadas al oyente principal proporcionado. Ellos deben ser reportados como fallido con el NOT_EXECUTED_FAILURE
mensaje.
Parámetros | |
---|---|
listener | ITestInvocationListener : el oyente principal donde informar sobre los resultados no ejecutadas. |
message | String : el mensaje que se asocia con el fracaso no ejecutada. |
reportNotExecuted
public void reportNotExecuted (ITestInvocationListener listener)
Informe las pruebas no ejecutadas al oyente principal proporcionado. Ellos deben ser reportados como fallido con el NOT_EXECUTED_FAILURE
mensaje.
Parámetros | |
---|---|
listener | ITestInvocationListener : el oyente principal donde informar sobre los resultados no ejecutadas. |
correr
public final void run (TestInformation testInfo, ITestInvocationListener listener)
Método run genérico para todas las pruebas de carga desde loadTests()
.
Parámetros | |
---|---|
testInfo | TestInformation |
listener | ITestInvocationListener |
Lanza | |
---|---|
DeviceNotAvailableException |
setAbiName
public void setAbiName (String abiName)
Establecer 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 |
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 el IConfiguration
en uso.
Parámetros | |
---|---|
configuration | IConfiguration |
setDevice
public void setDevice (ITestDevice device)
Inyecte el dispositivo bajo prueba.
Parámetros | |
---|---|
device | ITestDevice : la ITestDevice de uso |
setInvocationContext
public void setInvocationContext (IInvocationContext invocationContext)
Parámetros | |
---|---|
invocationContext | IInvocationContext |
setInvocationInjector
public void setInvocationInjector (Injector injector)
Obtener la corriente Guice Injector
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
S definida para la ejecución de 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 comparta 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 |
setSystemStatusChecker
public void setSystemStatusChecker (systemCheckers)
Establece el ISystemStatusChecker
s de la configuración de la prueba.
Parámetros | |
---|---|
systemCheckers |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Parámetros | |
---|---|
testLogger | ITestLogger |
separar
publicsplit (Integer shardCountHint, TestInformation testInfo)
Versión alternativa de split(int)
que también proporciona una TestInformation
que contiene información temprana de los padres crear 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 total de fragmentos intento. |
testInfo | TestInformation : El padre TestInformation |
Devoluciones | |
---|---|
una colección de subpruebas que debe ejecutarse por separado o null si la prueba no está en shardable |
Métodos protegidos
createModuleListeners
protectedcreateModuleListeners ()
Devuelve la lista de ITestInvocationListener
aplicable al ModuleListener
nivel. Estos oyentes se reutilizarán para cada módulo, no se volverán a crear instancias, 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 debe ejecutarse.
Parámetros | |
---|---|
config | IConfiguration : El IConfiguration siendo evaluado. |
include | MultiMap : los metadatos incluyen filtro |
exclude | MultiMap : el filtro de metadatos excluir |
Devoluciones | |
---|---|
boolean | Verdadero si el módulo debe ejecutarse, falso en caso contrario. |
filterByRunnerType
protected boolean filterByRunnerType (IConfiguration config,allowedRunners)
Aplique el filtro de lista blanca de corredores, eliminando cualquier corredor que no estuviera en la lista blanca. Si una configuración tiene varios corredores, es posible que algunos se eliminen y la configuración aún se ejecute.
Parámetros | |
---|---|
config | IConfiguration : El IConfiguration siendo evaluado. |
allowedRunners |
Devoluciones | |
---|---|
boolean | Verdadero si el módulo de configuración puede ejecutarse, falso en caso contrario. |
getAbisForBuildTargetArch
protectedgetAbisForBuildTargetArch ()
Devuelve el abis compatible con la arquitectura de destino de la compilación del host. Expuesto para pruebas.
Devoluciones | |
---|---|
getHostAbis
protectedgetHostAbis ()
Devuelve la máquina host abis.
Devoluciones | |
---|---|
shouldModuleRun
protected boolean shouldModuleRun (ModuleDefinition module)
Parámetros | |
---|---|
module | ModuleDefinition |
Devoluciones | |
---|---|
boolean |