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 |
static
|
getAbisForBuildTargetArchFromSuite()
Muestra la posible abis desde el TestSuiteInfo. |
IBuildInfo
|
getBuildInfo()
La implementación de |
final
IConfiguration
|
getConfiguration()
Muestra la invocación |
ITestLogger
|
getCurrentTestLogger()
|
ITestDevice
|
getDevice()
Pon el dispositivo a prueba. |
ModuleDefinition
|
getDirectModule()
Muestra el objeto |
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 |
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 |
void
|
setAbiName(String abiName)
Establece el valor de mAbiName |
final
void
|
setAbis(
|
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 |
void
|
setDevice(ITestDevice device)
Inyecta el dispositivo a prueba. |
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setInvocationInjector(Injector injector)
Obtén el |
void
|
setMetricCollectors(
Establece la lista de elementos |
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(
Establece los |
void
|
setTestLogger(ITestLogger testLogger)
|
|
split(Integer shardCountHint, TestInformation testInfo)
Versión alternativa de |
Métodos protegidos | |
---|---|
|
createModuleListeners()
Muestra la lista de |
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,
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
publicgetAbis (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 staticgetAbisForBuildTargetArchFromSuite ()
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
publicgetRequiredTokens ()
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 abstractloadTests ()
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
publicsplit (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
protectedcreateModuleListeners ()
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
protectedgetAbisForBuildTargetArch ()
Devuelve la ABI compatible con la arquitectura de destino de la compilación del host. Expuesto para realizar pruebas.
Muestra | |
---|---|
|
getHostAbis
protectedgetHostAbis ()
Muestra la ABI de la máquina anfitrión.
Muestra | |
---|---|
|
EjecutarMódulo
protected boolean shouldModuleRun (ModuleDefinition module)
Parámetros | |
---|---|
module |
ModuleDefinition |
Devuelve | |
---|---|
boolean |