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

Subclasses indiretas conhecidas

AtestRunner , TestMappingSuiteRunner

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

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 por meio 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`	`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`	`TOKEN_KEY`

Construtores públicos
`ITestSuite ()`

Métodos públicos
`void`	`addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)`
`void`	`addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)`
`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.
	`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 de `ITestSuite` pode exigir as informações de compilaçã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` a ser executado diretamente, ou nulo 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 requeridos 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 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 apenas no modo coletor, isso requer que todos os subtestes também implementem essa interface.
`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 do teste.
`void`	`setPrimaryAbiRun (boolean primaryAbiRun)` Defina o valor de mPrimaryAbiRun
`void`	`setShouldMakeDynamicModule (boolean dynamicModule)` Ao fazer fragmentação distribuída, não podemos ter ModuleDefinition que compartilhe testes em um pool, caso contrário, a fragmentação intra-módulo não funcionará, portanto, permitimos desativá-la.
`void`	`setSystemStatusChecker ( systemCheckers)` `setSystemStatusChecker ( systemCheckers)` Define o `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 estilhaços.

Métodos protegidos
	`createModuleListeners ()` Retorna a lista de `ITestInvocationListener` aplicável ao nível `ModuleListener` .
`boolean`	`filterByRunnerType ( IConfiguration config, allowedRunners)` `filterByRunnerType ( IConfiguration config, allowedRunners)` Aplique a filtragem de lista de permissões do Runner, removendo qualquer corredor que não esteja 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_STAGING_ARTIFACTS

public static final String SKIP_STAGING_ARTIFACTS

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`

filterByConfigMetadata

public 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` 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.

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

lances
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Retorna o possível abis do TestSuiteInfo.

devoluções

getBuildInfo

public IBuildInfo getBuildInfo ()

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

devoluções
`IBuildInfo`

getConfiguration

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 a ser executado diretamente, ou nulo 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 requeridos pelo teste. Retorna nulo 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`

testes de carga

public abstract  loadTests ()

Método abstrato para carregar a configuração dos testes que serão executados. Cada teste é definido por uma 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 com falha com a mensagem NOT_EXECUTED_FAILURE .

Parâmetros
`listener`	`ITestInvocationListener` : o ouvinte principal onde relatar 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 com falha com a mensagem NOT_EXECUTED_FAILURE .

Parâmetros
`listener`	`ITestInvocationListener` : o ouvinte principal onde relatar 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` : O objeto `TestInformation` que contém informações úteis para executar testes.
`listener`	`ITestInvocationListener` : o `ITestInvocationListener` dos resultados do teste

lances
`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 apenas no modo coletor, isso requer que todos os subtestes também implementem essa interface.

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`

setMetricCollectors

public void setMetricCollectors ( collectors)

Define a lista de IMetricCollector s definidos 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 fragmentação distribuída, não podemos ter ModuleDefinition que compartilhe testes em um pool, caso contrário, a fragmentação intra-módulo não funcionará, portanto, permitimos desativá-la.

Parâmetros
`dynamicModule`	`boolean`

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Define o 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 estilhaços. É útil se coisas como dispositivo ou informações de compilação precisam ser acessadas durante a fragmentação.

Parâmetros
`shardCountHint`	`Integer` : a tentativa de contagem de fragmentos.
`testInfo`	`TestInformation` : O pai `TestInformation`

devoluções
	uma coleção de subtestes a serem executados separadamente ou `null` se o teste não for fragmentável no momento

Métodos protegidos

createModuleListeners

protected  createModuleListeners ()

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

devoluções

filtroPorRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Aplique a filtragem de lista de permissões do Runner, removendo qualquer corredor que não esteja na lista de permissões. Se uma configuração tiver vários executores, alguns podem ser removidos e a configuração ainda será executada.

Parâmetros
`config`	`IConfiguration` : O `IConfiguration` sendo avaliado.
`allowedRunners`	: a lista de permissões do corredor atual.

devoluções
`boolean`	True se o módulo de configuração tiver permissão para executar, false caso contrário.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

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

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`

deveMóduloExecutar

protected boolean shouldModuleRun (ModuleDefinition module)

Parâmetros
`module`	`ModuleDefinition`

devoluções
`boolean`