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

Subclasses diretas conhecidas BaseTestSuite , TfSuiteRunner BaseTestSuite Um teste para executar o Compatibility Test Suite com o novo sistema de suite. TfSuiteRunner Implementação do ITestSuite que irá carregar testes da pasta TF jars res/config/suite/.

Subclasses indiretas conhecidas AtestRunner , TestMappingSuiteRunner AtestRunner Implementação do ITestSuite TestMappingSuiteRunner Implementação do BaseTestSuite para executar testes especificados pela opção include-filter, ou arquivos TEST_MAPPING do build, como uma suíte.

---

Classe abstrata usada para executar o Test Suite. Esta classe fornece a base de como a Suite será executada. Cada implementação pode definir a lista de testes através do método loadTests() .

Resumo

Turmas aninhadas
enum	ITestSuite.MultiDeviceModuleStrategy

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	RUNNER_WHITELIST
public static final String	SKIP_HOST_ARCH_CHECK
public static final String	SKIP_SYSTEM_STATUS_CHECKER
public static final String	TOKEN_KEY

Construtores públicos
ITestSuite ()

Métodos públicos
void	addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)
void	addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)
	getAbis ( ITestDevice device) Obtém o conjunto de ABIs compatível com o teste de compatibilidade AbiUtils.getAbisSupportedByCompatibility() e o dispositivo em teste.
static	getAbisForBuildTargetArchFromSuite () Retorna o possível abis do TestSuiteInfo.
IBuildInfo	getBuildInfo () A implementação do ITestSuite pode exigir as informações de compilação para carregar os testes.
final IConfiguration	getConfiguration () Retorna a chamada IConfiguration .
ITestLogger	getCurrentTestLogger ()
ITestDevice	getDevice () Coloque o dispositivo em teste.
ModuleDefinition	getDirectModule () Retorna o ModuleDefinition a ser executado diretamente, ou null se nenhum ainda (quando o ITestSuite ainda não foi fragmentado).
IInvocationContext	getInvocationContext () Retorna o contexto de invocação.
MultiMap <String, String>	getModuleMetadataIncludeFilters ()
final String	getRequestedAbi () Retorna o abi solicitado com a opção -a ou --abi.
	getRequiredTokens ( TestInformation testInfo) Retorna a lista de tokens necessários pelo teste.
long	getRuntimeHint () Retorne o tempo de execução esperado do teste em milissegundos.
File	getTestsDir ()
boolean	isSplitting () Retorna true se estivermos atualmente em IShardableTest.split(int) .
abstract	loadTests () Método abstrato para carregar a configuração dos testes que serão executados.
void	reportNotExecuted ( ITestInvocationListener listener, String message) Relate os testes não executados para o listener principal fornecido.
void	reportNotExecuted ( ITestInvocationListener listener) Relate os testes não executados para o listener principal fornecido.
final void	run ( TestInformation testInfo, ITestInvocationListener listener) Método de execução genérico para todos os testes carregados de loadTests() .
void	setAbiName (String abiName) Defina o valor de mAbiName
final void	setAbis ( abis) setAbis ( abis)
void	setBuild ( IBuildInfo buildInfo)
void	setCollectTestsOnly (boolean shouldCollectTest) Execute o conjunto de testes no modo somente coletor, isso requer que todos os subtestes implementem essa interface também.
void	setConfiguration ( IConfiguration configuration) Injeta o IConfiguration em uso.
void	setDevice ( ITestDevice device) Injete o dispositivo em teste.
void	setDirectModule ( ModuleDefinition module)
void	setInvocationContext ( IInvocationContext invocationContext)
void	setMetricCollectors ( collectors) setMetricCollectors ( collectors) Define a lista de IMetricCollector s definidos para a execução de teste.
void	setPrimaryAbiRun (boolean primaryAbiRun) Defina o valor de mPrimaryAbiRun
void	setShouldMakeDynamicModule (boolean dynamicModule) Ao fazer sharding distribuído, não podemos ter ModuleDefinition que compartilhe testes em um pool, caso contrário, o sharding intra-módulo não funcionará, então permitimos desativá-lo.
void	setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Define os ISystemStatusChecker s da configuração para o teste.
void	setTestLogger ( ITestLogger testLogger) Injeta a instância ITestLogger
	split (Integer shardCountHint, TestInformation testInfo) Versão alternativa de split(int) que também fornece um TestInformation que contém informações iniciais do pai que cria os fragmentos.

Métodos protegidos
	createModuleListeners () Retorna a lista de ITestInvocationListener aplicável ao nível ModuleListener .
boolean	filterByConfigMetadata ( IConfiguration config, MultiMap <String, String> include, MultiMap <String, String> exclude) Aplique o filtro de metadados à configuração e veja se a configuração deve ser executada.
boolean	filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners) Aplique a filtragem da lista de permissões do Executor, removendo qualquer runner que não tenha sido incluído na lista de permissões.
	getAbisForBuildTargetArch () Retorne o abis suportado pela arquitetura de destino de compilação do Host.
	getHostAbis () Retorna o abis da máquina host.
void	setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)
boolean	shouldModuleRun ( ModuleDefinition module)

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

RANDOM_SEED

public static final String RANDOM_SEED

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

Construtores 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

getAbis

public  getAbis (ITestDevice device)

Obtém o conjunto de ABIs compatível com o teste de compatibilidade AbiUtils.getAbisSupportedByCompatibility() e o dispositivo em teste.

Parâmetros
device	ITestDevice

Devoluções
	O conjunto de ABIs para executar os testes em

Lança
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Retorna o possível abis do TestSuiteInfo.

Devoluções

getBuildInfo

public IBuildInfo getBuildInfo ()

A implementação do ITestSuite pode exigir as informações de compilação para carregar os testes.

Devoluções
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

Retorna a chamada IConfiguration .

Devoluções
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Devoluções
ITestLogger

getDevice

public ITestDevice getDevice ()

Coloque o dispositivo em teste.

Devoluções
ITestDevice	o ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Retorna o ModuleDefinition a ser executado diretamente, ou null se nenhum ainda (quando o ITestSuite ainda não foi fragmentado).

Devoluções
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

Retorna o contexto de invocação.

Devoluções
IInvocationContext

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

Devoluções
MultiMap <String, String>

getRequestedAbi

public final String getRequestedAbi ()

Retorna o abi solicitado com a opção -a ou --abi.

Devoluções
String

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Retorna a lista de tokens necessários pelo teste. Retorna null se não houver suporte a token.

Parâmetros
testInfo	TestInformation

Devoluções

getRuntimeHint

public long getRuntimeHint ()

Retorne o tempo de execução esperado do teste em milissegundos. O tempo é usado para balancear a carga da execução fragmentada

Devoluções
long

getTestsDir

public File getTestsDir ()

Devoluções
File

isSplitting

public boolean isSplitting ()

Retorna true se estivermos atualmente em IShardableTest.split(int) .

Devoluções
boolean

loadTests

public abstract  loadTests ()

Método abstrato para carregar a configuração dos testes que serão executados. Cada teste é definido por um IConfiguration e um nome exclusivo sob o qual relatará os resultados.

Devoluções

relatórioNão executado

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Relate os testes não executados para o listener principal fornecido. Eles devem ser relatados como com falha com a mensagem NOT_EXECUTED_FAILURE .

Parâmetros
listener	ITestInvocationListener : o listener principal onde reportar os resultados não executados.
message	String : a mensagem a ser associada à falha não executada.

relatórioNão executado

public void reportNotExecuted (ITestInvocationListener listener)

Relate os testes não executados para o listener principal fornecido. Eles devem ser relatados como com falha com a mensagem NOT_EXECUTED_FAILURE .

Parâmetros
listener	ITestInvocationListener : o listener principal onde reportar os resultados não executados.

corre

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Método de execução genérico para todos os testes carregados de loadTests() .

Parâmetros
testInfo	TestInformation : O objeto TestInformation contendo informações úteis para executar testes.
listener	ITestInvocationListener : o ITestInvocationListener dos resultados do teste

Lança
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

Defina o 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)

Execute o conjunto de testes no modo somente coletor, isso requer que todos os subtestes implementem essa interface também.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta o IConfiguration em uso.

Parâmetros
configuration	IConfiguration

setDevice

public void setDevice (ITestDevice device)

Injete o dispositivo em teste.

Parâmetros
device	ITestDevice : o ITestDevice a ser usado

setDirectModule

public void setDirectModule (ModuleDefinition module)

Parâmetros
module	ModuleDefinition

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parâmetros
invocationContext	IInvocationContext

setMetric Collectors

public void setMetricCollectors ( collectors)

Define a lista de IMetricCollector s definidos para a execução de teste.

Parâmetros
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Defina o valor de mPrimaryAbiRun

Parâmetros
primaryAbiRun	boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Ao fazer sharding distribuído, não podemos ter ModuleDefinition que compartilhe testes em um pool, caso contrário, o sharding intra-módulo não funcionará, então permitimos desativá-lo.

Parâmetros
dynamicModule	boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Define os ISystemStatusChecker s da configuração para o teste.

Parâmetros
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Injeta a instância ITestLogger

Parâmetros
testLogger	ITestLogger

dividir

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Versão alternativa de split(int) que também fornece um TestInformation que contém informações iniciais do pai que cria os fragmentos. É útil se coisas como informações de dispositivo ou compilação precisarem ser acessadas durante a fragmentação.

Parâmetros
shardCountHint	Integer : a contagem de estilhaços tentada.
testInfo	TestInformation : O pai TestInformation

Devoluções
	uma coleção de subtestes a serem executados separadamente ou null se o teste não puder ser fragmentado no momento

Métodos protegidos

createModuleListeners

protected  createModuleListeners ()

Retorna a lista de ITestInvocationListener aplicável ao nível ModuleListener . Esses listeners serão reutilizados para cada módulo, não serão reinstanciados, portanto, não devem assumir um estado interno.

Devoluções

filterByConfigMetadata

protected boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

Aplique o filtro de metadados à configuração e veja se a configuração deve ser executada.

Parâmetros
config	IConfiguration : O IConfiguration que está sendo avaliado.
include	MultiMap : os metadados incluem filtro
exclude	MultiMap : o filtro de exclusão de metadados

Devoluções
boolean	True se o módulo deve ser executado, false caso contrário.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Aplique a filtragem da lista de permissões do Executor, removendo qualquer runner que não tenha sido incluído na lista de permissões. Se uma configuração tiver vários executores, alguns poderão ser removidos e a configuração ainda será executada.

Parâmetros
config	IConfiguration : O IConfiguration que está sendo avaliado.
allowedRunners	: a lista de permissões do executor atual.

Devoluções
boolean	True se o módulo de configuração tiver permissão para ser executado, false caso contrário.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Retorne o abis suportado pela arquitetura de destino de compilação do Host. Exposto para teste.

Devoluções

getHostAbis

protected  getHostAbis ()

Retorna o abis da máquina host.

Devoluções

setMultiDeviceStrategy

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parâmetros
strategy	ITestSuite.MultiDeviceModuleStrategy

deveModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parâmetros
module	ModuleDefinition

Devoluções
boolean