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 testes de compatibilidade com o novo sistema de suíte.
TfSuiteRunner	Implementação do `ITestSuite` que carregará testes da pasta TF jars res/config/suite/.

Subclasses indiretas conhecidas

TestMappingSuiteRunner

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

Classe abstrata usada para executar o Test Suite. Esta classe fornece a base de como o Suite será executado. Cada implementação pode definir a lista de testes através do 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 antes do teste como verdadeiro.
	`getAbis (ITestDevice device)` Obtém o conjunto de ABIs compatíveis com o teste de compatibilidade `AbiUtils.getAbisSupportedByCompatibility()` e o dispositivo em teste.
`static`	`getAbisForBuildTargetArchFromSuite ()` Retorna o abis possível do TestSuiteInfo.
`IBuildInfo`	`getBuildInfo ()` A implementação do `ITestSuite` pode exigir as informações de construção para carregar os testes.
`final IConfiguration`	`getConfiguration ()` Retorna a invocação `IConfiguration` .
`ITestLogger`	`getCurrentTestLogger ()`
`ITestDevice`	`getDevice ()` Coloque o dispositivo em teste.
`ModuleDefinition`	`getDirectModule ()` Retorna o `ModuleDefinition` para ser executado diretamente ou nulo se ainda não houver (quando o ITestSuite ainda não foi fragmentado).
`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 ()` Retorne o tempo de execução esperado do teste em milissegundos.
`File`	`getTestsDir ()`
`boolean`	`isSplitting ()` Retorna verdadeiro 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 ao ouvinte principal fornecido.
`void`	`reportNotExecuted (ITestInvocationListener listener)` Relate os testes não executados ao ouvinte 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 todos os subtestes para implementar esta 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)` Obtenha o `Injector` Guice atual da invocação.
`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)`
	`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 Runner, removendo qualquer executor que não esteja na lista de permissões.
	`getAbisForBuildTargetArch ()` Retorne 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

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`

ativarRebootBeforeTest

public final void enableRebootBeforeTest ()

Define reinicialização antes do teste como verdadeiro.

getAbis

public  getAbis (ITestDevice device)

Obtém o conjunto de ABIs compatíveis 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

Lança
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Retorna o abis possível do TestSuiteInfo.

Devoluções

getBuildInfo

public IBuildInfo getBuildInfo ()

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

Devoluções
`IBuildInfo`

getConfiguração

public final IConfiguration getConfiguration ()

Retorna a invocação 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 para ser executado diretamente ou nulo se ainda não houver (quando o ITestSuite ainda não foi fragmentado).

Devoluções
`ModuleDefinition`

getInvocationContext

public IInvocationContext getInvocationContext ()

Retorna o contexto de invocação.

Devoluções
`IInvocationContext`

getRequestedAbi

public final String getRequestedAbi ()

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

Devoluções
`String`

getRequiredTokens

public  getRequiredTokens ()

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 verdadeiro se estivermos atualmente em IShardableTest.split(int) .

Devoluções
`boolean`

testes de carga

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

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Relate os testes não executados ao ouvinte principal fornecido. Eles devem ser relatados como falhados com a mensagem NOT_EXECUTED_FAILURE .

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

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Relate os testes não executados ao ouvinte principal fornecido. Eles devem ser relatados como falhados com a mensagem NOT_EXECUTED_FAILURE .

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

correr

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`

Lança
`DeviceNotAvailableException`

definirAbiName

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 todos os subtestes para implementar esta interface também.

setConfiguração

public void setConfiguration (IConfiguration configuration)

Injeta o IConfiguration em uso.

Parâmetros
`configuration`	`IConfiguration`

setDispositivo

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)

Obtenha o Injector Guice atual da invocação. 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 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)

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 tentativa de contagem de fragmentos.
`testInfo`	`TestInformation` : O `TestInformation` pai

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

criarModuleListeners

protected  createModuleListeners ()

Retorna a lista de ITestInvocationListener aplicável ao nível ModuleListener . Esses ouvintes serão reutilizados para cada módulo, não serão reinstanciados, portanto não deverão 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`	Verdadeiro se o módulo deve 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 executor que não esteja 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`	Verdadeiro se o módulo de configuração tiver permissão para ser executado; caso contrário, falso.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Retorne o abis compatível com a arquitetura de destino de build do Host. Exposto para testes.

Devoluções

getHostAbis

protected  getHostAbis ()

Retorna o abis da máquina host.

Devoluções

deveriaModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parâmetros
`module`	`ModuleDefinition`

Devoluções
`boolean`