O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

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 e TfSuiteRunner (links em inglês)

BaseTestSuite (em inglês)	Um teste para executar o Teste de Compatibilidade do Android com o novo sistema do pacote.
TfSuiteRunner (link em inglês)	Implementação de `ITestSuite`, que carregará testes de jars do TF res/config/suite/ do Compute Engine.

Subclasses indiretas conhecidas

TestMappingSuiteRunner (link em inglês)

TestMappingSuiteRunner (link em inglês) Implementação de BaseTestSuite para executar testes especificados pela opção include-filter ou TEST_MAPPING do build, como um pacote.

Classe abstrata usada para executar o pacote de testes. Essa classe fornece a base de como o Suite será executado. Cada implementação pode definir a lista de testes pelo método loadTests().

Resumo

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`

Construtores públicos
`ITestSuite()`

Métodos públicos
`void`	`addModuleMetadataExcludeFilters(MultiMap<String, String> filters)`
`void`	`addModuleMetadataIncludeFilters(MultiMap<String, String> filters)`
`final void`	`enableRebootBeforeTest()` Define reinicialização-before-test como "true".
	`getAbis(ITestDevice device)` Recebe o conjunto de ABIs compatíveis com o teste de compatibilidade da `AbiUtils.getAbisSupportedByCompatibility()` e do dispositivo em teste.
`static`	`getAbisForBuildTargetArchFromSuite()` Retorna os possíveis abis do TestSuiteInfo.
`IBuildInfo`	`getBuildInfo()` A implementação de `ITestSuite` pode exigir as informações do build para carregar os testes.
`final IConfiguration`	`getConfiguration()` Retorna a invocação `IConfiguration`.
`ITestLogger`	`getCurrentTestLogger()`
`ITestDevice`	`getDevice()` Colocar o dispositivo em teste.
`ModuleDefinition`	`getDirectModule()` Retorna o `ModuleDefinition` a ser executado diretamente ou nulo caso nenhum ainda (quando o o ITestSuite ainda não foi fragmentado).
`IInvocationContext`	`getInvocationContext()` Retorna o contexto da invocação.
`final String`	`getRequestedAbi()` Retorna a abi solicitada com a opção -a ou --abi.
	`getRequiredTokens()`
`long`	`getRuntimeHint()` Retornar o ambiente de execução esperado do teste em milésimos de segundo.
`File`	`getTestsDir()`
`boolean`	`isSplitting()` Retorna "true" se estivermos em `IShardableTest.split(int)`.
`abstract`	`loadTests()` Método abstrato para carregar a configuração de testes que será executada.
`void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Informe os testes não executados ao listener principal fornecido.
`void`	`reportNotExecuted(ITestInvocationListener listener)` Informe os testes não executados ao 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)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Execute o pacote de testes no modo somente coletor. Isso exige que todos os subtestes implementem isso do BigQuery.
`void`	`setConfiguration(IConfiguration configuration)` Injeta o `IConfiguration` em uso.
`void`	`setDevice(ITestDevice device)` Injete o dispositivo em teste.
`void`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setInvocationInjector(Injector injector)` Consiga o `Injector` do Guice atual da invocação.
`void`	`setMetricCollectors( collectors)` Define a lista de `IMetricCollector`s definida para a execução do teste.
`void`	`setPrimaryAbiRun(boolean primaryAbiRun)` Defina o valor de mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule(boolean dynamicModule)` Ao fazer a fragmentação distribuída, não é possível ter um ModuleDefinition que compartilhe testes em um pool. Caso contrário, a fragmentação intramódulo não vai funcionar, então permitimos que ela seja desativada.
`void`	`setSystemStatusChecker( systemCheckers)` Define os `ISystemStatusChecker`s da configuração para o teste.
`void`	`setTestLogger(ITestLogger testLogger)`
	`split(Integer shardCountHint, TestInformation testInfo)` Versão alternativa de `split(int)`, que também fornece um `TestInformation` que contém informações antecipadas do pai que está criando os fragmentos.

Métodos protegidos
	`createModuleListeners()` Retorna a lista de `ITestInvocationListener` aplicáveis ao item `ModuleListener`. nível
`boolean`	`filterByConfigMetadata(IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)` Aplique o filtro de metadados à configuração e veja se ela deve ser executada.
`boolean`	`filterByRunnerType(IConfiguration config, allowedRunners)` Aplique a filtragem da lista de permissões do executor, removendo qualquer executor que não esteja na lista de permissões.
	`getAbisForBuildTargetArch()` Retorna o abis compatível com a arquitetura de destino de build do host.
	`getHostAbis()` Retorna o abis da máquina host.
`boolean`	`shouldModuleRun(ModuleDefinition module)`

Campos

ABI_OPTION

public static final String ABI_OPTION

CHAVE_DA_PRINCIPAL_ATIVO

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

CHAVE_DE_PARÂMETRO_PRINCIPAL

public static final String MAINLINE_PARAMETER_KEY

POSTAGEM_DE_VERIFICAÇÃO_MÓDULO

public static final String MODULE_CHECKER_POST

MÓDULO_VERIFICADOR_PRE

public static final String MODULE_CHECKER_PRE

FILTRO_DE_METADADOS_MÓDULO

public static final String MODULE_METADATA_EXCLUDE_FILTER

FILTRO DE METADADOS DE MÓDULO

public static final String MODULE_METADATA_INCLUDE_FILTER

CHAVE_DE PARÂMETRO

public static final String PARAMETER_KEY

LISTA DE PREPARAÇÃO

public static final String PREPARER_WHITELIST

PRINCIPAL_ABI_RUN

public static final String PRIMARY_ABI_RUN

SEED_ALEATÓRIA

public static final String RANDOM_SEED

TESTE_ANTES_REBOOT

public static final String REBOOT_BEFORE_TEST

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

PULAR_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

PULAR_SISTEMA_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

CHAVE_DE_TOKEN

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`

enableReiniciarAntesTeste

public final void enableRebootBeforeTest ()

Define reinicialização-before-test como "true".

GetAbis

public  getAbis (ITestDevice device)

Recebe o conjunto de ABIs compatíveis com o teste de compatibilidade da AbiUtils.getAbisSupportedByCompatibility() e do dispositivo em teste.

Parâmetros
`device`	`ITestDevice`

Retorna
	O conjunto de ABIs para executar os testes

Gera
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Retorna os possíveis abis do TestSuiteInfo.

Retorna

getBuildInfo

public IBuildInfo getBuildInfo ()

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

Retorna
`IBuildInfo`

getConfiguration

public final IConfiguration getConfiguration ()

Retorna a invocação IConfiguration.

Retorna
`IConfiguration`

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Retorna
`ITestLogger`

getDevice

public ITestDevice getDevice ()

Colocar o dispositivo em teste.

Retorna
`ITestDevice`	`ITestDevice`

getDirectModule

public ModuleDefinition getDirectModule ()

Retorna o ModuleDefinition a ser executado diretamente ou nulo caso nenhum ainda (quando o o ITestSuite ainda não foi fragmentado).

Retorna
`ModuleDefinition`

getInvocationContext

public IInvocationContext getInvocationContext ()

Retorna o contexto da invocação.

Retorna
`IInvocationContext`

getRequestedAbi

public final String getRequestedAbi ()

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

Retorna
`String`

getRequiredTokens

public  getRequiredTokens ()

Retorna

getRuntimeHint

public long getRuntimeHint ()

Retornar o ambiente de execução esperado do teste em milésimos de segundo. O tempo é usado para balancear a carga da execução fragmentada

Retorna
`long`

getTestsDir

public File getTestsDir ()

Retorna
`File`

dividindo

public boolean isSplitting ()

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

Retorna
`boolean`

loadTests

public abstract  loadTests ()

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

Retorna

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informe os testes não executados ao listener principal fornecido. Elas devem ser informadas como falhou com a mensagem NOT_EXECUTED_FAILURE.

Parâmetros
`listener`	`ITestInvocationListener`: o listener principal em que os resultados não executados são relatados.
`message`	`String`: a mensagem a ser associada à falha não executada.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Informe os testes não executados ao listener principal fornecido. Elas devem ser informadas como falhou com a mensagem NOT_EXECUTED_FAILURE.

Parâmetros
`listener`	`ITestInvocationListener`: o listener principal em que os resultados não executados são relatados.

run

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`
`listener`	`ITestInvocationListener`

Gera
`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 pacote de testes no modo somente coletor. Isso exige que todos os subtestes implementem isso do BigQuery.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta o IConfiguration em uso.

Parâmetros
`configuration`	`IConfiguration`

Definir dispositivo

public void setDevice (ITestDevice device)

Injete o dispositivo em teste.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser usado.

setInvocationContext.

public void setInvocationContext (IInvocationContext invocationContext)

Parâmetros
`invocationContext`	`IInvocationContext`

setInvocationInjector

public void setInvocationInjector (Injector injector)

Consiga o Injector do Guice atual da invocação. Isso deve nos permitir continuar a injeção de objetos de módulos.

Parâmetros
`injector`	`Injector`

setMetricCollectors

public void setMetricCollectors ( collectors)

Define a lista de IMetricCollectors definida para a execução do 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 a fragmentação distribuída, não é possível ter um ModuleDefinition que compartilhe testes em um pool. Caso contrário, a fragmentação intramódulo não vai funcionar, então permitimos que ela seja desativada.

Parâmetros
`dynamicModule`	`boolean`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Define os ISystemStatusCheckers da configuração para o teste.

Parâmetros
`systemCheckers`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

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 antecipadas do pai que está criando os fragmentos. É útil caso coisas como as informações do dispositivo ou da versão precisam ser acessadas durante a fragmentação.

Parâmetros
`shardCountHint`	`Integer`: a contagem de fragmentos tentados.
`testInfo`	`TestInformation`: o `TestInformation` pai

Retorna
	uma coleção de subtestes a serem executados separadamente ou `null` se o teste for não fragmentado no momento

Métodos protegidos

createModuleListeners

protected  createModuleListeners ()

Retorna a lista de ITestInvocationListener aplicáveis ao item ModuleListener. nível Esses listeners serão reutilizados em cada módulo, não vão ser reinstanciados eles não podem assumir um estado interno.

Retorna

filterByConfigMetadata

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

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

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

Retorna
`boolean`	Verdadeiro se o módulo precisar ser executado. Caso contrário, será falso.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Aplique a filtragem da lista de permissões do executor, removendo qualquer executor que não esteja na lista de permissões. Se um tem vários executores. Alguns deles podem 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.

Retorna
`boolean`	Verdadeiro se o módulo de configuração tiver permissão para ser executado. Caso contrário, será falso.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Retorna o abis compatível com a arquitetura de destino de build do host. Exposto para teste.

Retorna

getHostAbis

protected  getHostAbis ()

Retorna o abis da máquina host.

Retorna

shouldModuleRun.

protected boolean shouldModuleRun (ModuleDefinition module)

Parâmetros
`module`	`ModuleDefinition`

Retorna
`boolean`