A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

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, TfSuiteRunner

BaseTestSuite	Um teste para executar o conjunto de teste de compatibilidade com o novo sistema de conjunto.
TfSuiteRunner (link em inglês)	Implementação de `ITestSuite`, que vai carregar testes da pasta res/config/suite/ dos frascos do TF.

Subclasses indiretas conhecidas

TestMappingSuiteRunner

TestMappingSuiteRunner Implementação de BaseTestSuite para executar testes especificados pela opção include-filter ou arquivos TEST_MAPPING do build como um pacote.

Classe abstrata usada para executar o pacote de testes. Essa classe fornece a base de como o pacote 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 reboot-before-test como verdadeiro.
	`getAbis(ITestDevice device)` Extrai o conjunto de ABIs aceito pelo `AbiUtils.getAbisSupportedByCompatibility()` de teste de compatibilidade e pelo dispositivo em teste.
`static`	`getAbisForBuildTargetArchFromSuite()` Retorna os possíveis abis do TestSuiteInfo.
`IBuildInfo`	`getBuildInfo()` A implementação de `ITestSuite` pode exigir que as informações do build carreguem os testes.
`final IConfiguration`	`getConfiguration()` Retorna a invocação `IConfiguration`.
`ITestLogger`	`getCurrentTestLogger()`
`ITestDevice`	`getDevice()` Pegue o dispositivo em teste.
`ModuleDefinition`	`getDirectModule()` Retorna o `ModuleDefinition` a ser executado diretamente ou nulo se ainda não houver nenhum (quando o ITestSuite ainda não tiver sido dividido).
`IInvocationContext`	`getInvocationContext()` Retorna o contexto de invocação.
`final String`	`getRequestedAbi()` Retorna o abi solicitado com a opção -a ou --abi.
	`getRequiredTokens()`
`long`	`getRuntimeHint()` Retorna o tempo de execução esperado do teste em milissegundos.
`File`	`getTestsDir()`
`boolean`	`isSplitting()` Retorna verdadeiro se estivermos no `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)` Informar os testes não executados ao listener principal fornecido.
`void`	`reportNotExecuted(ITestInvocationListener listener)` Informar 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)` Definir o valor de mAbiName
`final void`	`setAbis( abis)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Execute o conjunto de testes no modo somente coletor. Isso exige 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`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setInvocationInjector(Injector injector)` Receba o `Injector` do Guice atual da invocação.
`void`	`setMetricCollectors( collectors)` Define a lista de `IMetricCollector`s definidos para a execução do teste.
`void`	`setPrimaryAbiRun(boolean primaryAbiRun)` Definir o valor de mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule(boolean dynamicModule)` Ao fazer o sharding distribuído, não podemos ter uma ModuleDefinition que compartilhe testes em um pool. Caso contrário, o sharding intra-módulo não vai funcionar. Por isso, permitimos desativá-lo.
`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 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 verifique se ela é executada.
`boolean`	`filterByRunnerType(IConfiguration config, allowedRunners)` Aplique a filtragem da lista de permissões do runner, removendo qualquer runner que não tenha sido incluído na lista.
	`getAbisForBuildTargetArch()` Retorna as abis compatíveis com a arquitetura de destino do build do host.
	`getHostAbis()` Retorna as abis da máquina host.
`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

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

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`

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

Define reboot-before-test como verdadeiro.

getAbis

public  getAbis (ITestDevice device)

Extrai o conjunto de ABIs aceito pelo AbiUtils.getAbisSupportedByCompatibility() de teste de compatibilidade e pelo dispositivo em teste.

Parâmetros
`device`	`ITestDevice`

Retorna
	O conjunto de ABIs em que os testes serão executados

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 que as informações do build carreguem 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 ()

Pegue o dispositivo em teste.

Retorna
`ITestDevice`	o `ITestDevice`

getDirectModule

public ModuleDefinition getDirectModule ()

Retorna o ModuleDefinition a ser executado diretamente ou nulo se ainda não houver nenhum (quando o ITestSuite ainda não tiver sido dividido).

Retorna
`ModuleDefinition`

getInvocationContext

public IInvocationContext getInvocationContext ()

Retorna o contexto de invocação.

Retorna
`IInvocationContext`

getRequestedAbi

public final String getRequestedAbi ()

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

Retorna
`String`

getRequiredTokens

public  getRequiredTokens ()

Retorna

getRuntimeHint

public long getRuntimeHint ()

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

Retorna
`long`

getTestsDir

public File getTestsDir ()

Retorna
`File`

isSplitting

public boolean isSplitting ()

Retorna verdadeiro se estivermos no IShardableTest.split(int).

Retorna
`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 em que os resultados serão informados.

Retorna

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informar os testes não executados ao listener principal fornecido. Eles precisam ser informados como falha com a mensagem NOT_EXECUTED_FAILURE.

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

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Informar os testes não executados ao listener principal fornecido. Eles precisam ser informados como falha com a mensagem NOT_EXECUTED_FAILURE.

Parâmetros
`listener`	`ITestInvocationListener`: o listener principal para informar os resultados não executados.

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)

Definir 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 exige 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

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parâmetros
`invocationContext`	`IInvocationContext`

setInvocationInjector

public void setInvocationInjector (Injector injector)

Receba o Injector do Guice atual da invocação. Isso deve permitir que continuemos a injeção de objetos de módulos.

Parâmetros
`injector`	`Injector`

setMetricCollectors

public void setMetricCollectors ( collectors)

Define a lista de IMetricCollectors definidos para a execução do teste.

Parâmetros
`collectors`

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Definir o valor de mPrimaryAbiRun

Parâmetros
`primaryAbiRun`	`boolean`

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

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

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`

dividido

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. Isso é útil se informações como do dispositivo ou do build precisarem ser acessadas durante o sharding.

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 não puder ser fragmentado

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 instanciados novamente, então não devem 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 verifique se ela é executada.

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

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

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Aplique a filtragem da lista de permissões do runner, removendo qualquer runner que não tenha sido incluído na lista. Se uma configuração tiver vários runners, alguns deles 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 atuais do executor.

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 as abis compatíveis com a arquitetura de destino do build do host. Exposto para testes.

Retorna

getHostAbis

protected  getHostAbis ()

Retorna as abis da máquina host.

Retorna

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parâmetros
`module`	`ModuleDefinition`

Retorna
`boolean`