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 |
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 |
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 |
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
|
setDirectModule(ModuleDefinition module)
|
void
|
setIntraModuleSharding(boolean intraModuleSharding)
|
void
|
setInvocationContext(IInvocationContext invocationContext)
|
void
|
setMetricCollectors(
Establece la lista de elementos |
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(
Establece los |
void
|
setTestLogger(ITestLogger testLogger)
Inserta la instancia |
|
split(Integer shardCountHint, TestInformation testInfo)
Versión alternativa de |
Métodos protegidos | |
---|---|
|
createModuleListeners()
Muestra la lista de |
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
ENABLE_RESOLVE_SYM_LINKS
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
mEnableResolveSymlinks
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
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 | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
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 |
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
publicgetRequiredTokens (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 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 : 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 |
|
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
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 | |
---|---|
|
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 |