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.

Subclases directas conocidas BaseTestSuite y TfSuiteRunner BaseTestSuite; Una prueba para ejecutar el Conjunto de pruebas de compatibilidad con un nuevo sistema de paquete.  TfSuiteRunner Se implementó ITestSuite, que cargará pruebas desde la carpeta tf.jars res/config/suite/.

Subcategorías indirectas conocidas AtestRunner y TestMappingSuiteRunner AtestRunner Implementación de ITestSuite TestMappingSuiteRunner. Implementación de BaseTestSuite para ejecutar pruebas especificadas por la opción include-filter o archivos TEST_MAPPING de la compilación, como un paquete.

---

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_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 todos los elementos necesarios durante la configuración de los paquetes, pero que no son necesarios 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 ModuleDefinition que se ejecutará directamente o un valor nulo si aún no se muestra ninguno (cuando ITestSuite aún 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() Muestra 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 implementen también esta interfaz.
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 al nivel ModuleListener.
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 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

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 todos los elementos necesarios durante la configuración de los paquetes, pero que no son necesarios 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.

Devuelve
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

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

Devuelve

getBuildInfo

public IBuildInfo getBuildInfo ()

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

Devuelve
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

Muestra la invocación IConfiguration.

Devuelve
IConfiguration

getCurrentTestLogger.

public ITestLogger getCurrentTestLogger ()

Devuelve
ITestLogger

getDevice

public ITestDevice getDevice ()

Pon el dispositivo a prueba.

Devuelve
ITestDevice	ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Muestra el ModuleDefinition que se ejecutará directamente o un valor nulo si aún no se muestra ninguno (cuando ITestSuite aún no se ha fragmentado).

Devuelve
ModuleDefinition

getIntraModuleSharding

public boolean getIntraModuleSharding ()

Devuelve
boolean

getInvocationContext

public IInvocationContext getInvocationContext ()

Muestra el contexto de invocación.

Devuelve
IInvocationContext

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

Devuelve
MultiMap<String, String>

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

Devuelve
ITestSuite.MultiDeviceModuleStrategy

getRequestedAbi

public final String getRequestedAbi ()

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

Devuelve
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

Devuelve

getRuntimeHint

public long getRuntimeHint ()

Muestra el tiempo de ejecución esperado de la prueba en milisegundos. El tiempo se usa para balancear las cargas de ejecuciones fragmentadas

Devuelve
long

getTestsDir

public File getTestsDir ()

Devuelve
File

Se está dividiendo

public boolean isSplitting ()

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

Devuelve
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 mediante un IConfiguration y un nombre único con el cual se informarán los resultados.

Devuelve

informeNo ejecutado

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informa las pruebas no ejecutadas al objeto de escucha principal proporcionado. Se debe informar que falló 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 debe informar que falló 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 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 implementen también esta interfaz.

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. Resulta útil si es necesario acceder a la información del dispositivo o de 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.

Devuelve
	una colección de subpruebas que se ejecutarán por separado o null si la prueba no se puede fragmentar actualmente

Métodos protegidos

createModuleListeners

protected  createModuleListeners ()

Muestra la lista de ITestInvocationListener aplicable al nivel ModuleListener. Estos objetos de escucha se volverán a usar para cada módulo y no se volverán a crear instancias de ellos, por lo que no deben asumir un estado interno.

Devuelve

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 una configuración 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.

Devuelve
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 compilación del host. Expuesto para realizar pruebas.

Devuelve

getHostAbis

protected  getHostAbis ()

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

Devuelve

EjecutarMódulo

protected boolean shouldModuleRun (ModuleDefinition module)

Parámetros
module	ModuleDefinition

Devuelve
boolean