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

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 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_END_TIME`
`public static final String`	`MODULE_METADATA_EXCLUDE_FILTER`
`public static final String`	`MODULE_METADATA_INCLUDE_FILTER`
`public static final String`	`MODULE_START_TIME`
`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`	`TEST_TYPE_KEY`
`public static final String`	`TEST_TYPE_VALUE_PERFORMANCE`
`public static final String`	`TOKEN_KEY`
`protected boolean`	`mRecoverDeviceByCvd`

Construtores públicos
`ITestSuite ()`

Métodos públicos
`void`	`addModuleMetadataExcludeFilters ( MultiMap <String, String> filters)`
`void`	`addModuleMetadataIncludeFilters ( MultiMap <String, String> filters)`
`void`	`cleanUpSuiteSetup ()` Oportunidade de limpar todas as coisas que foram necessárias durante a configuração das suítes, mas não são necessárias para executar os testes.
`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í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).
`boolean`	`getIntraModuleSharding ()`
`IInvocationContext`	`getInvocationContext ()` Retorna o contexto de invocação.
`MultiMap <String, String>`	`getModuleMetadataIncludeFilters ()`
`ITestSuite.MultiDeviceModuleStrategy`	`getMultiDeviceStrategy ()`
`final String`	`getRequestedAbi ()` Retorna o abi solicitado com a opção -a ou --abi.
	`getRequiredTokens ( TestInformation testInfo)` Retorna a lista de tokens exigidos pelo teste.
`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`	`setDirectModule ( ModuleDefinition module)`
`void`	`setIntraModuleSharding (boolean intraModuleSharding)`
`void`	`setInvocationContext ( IInvocationContext invocationContext)`
`void`	`setMetricCollectors ( collectors)` `setMetricCollectors ( collectors)` Define a lista de `IMetricCollector` s definidos para a execução de teste.
`void`	`setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)`
`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`	`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_END_TIME

public static final String MODULE_END_TIME

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

MODULE_START_TIME

public static final String MODULE_START_TIME

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

TEST_TYPE_KEY

public static final String TEST_TYPE_KEY

TEST_TYPE_VALUE_PERFORMANCE

public static final String TEST_TYPE_VALUE_PERFORMANCE

TOKEN_KEY

public static final String TOKEN_KEY

mRecoverDeviceByCvd

protected boolean mRecoverDeviceByCvd

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`

cleanUpSuiteSetup

public void cleanUpSuiteSetup ()

Oportunidade de limpar todas as coisas que foram necessárias durante a configuração das suítes, mas não são necessárias para executar os testes.

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

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
	com.android.tradefed.device.DeviceNotAvailableException
`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`

getIntraModuleSharding

public boolean getIntraModuleSharding ()

Devoluções
`boolean`

getInvocationContext

public IInvocationContext getInvocationContext ()

Retorna o contexto de invocação.

Devoluções
`IInvocationContext`

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

Devoluções
`MultiMap <String, String>`

getMultiDeviceStrategy

public ITestSuite.MultiDeviceModuleStrategy getMultiDeviceStrategy ()

Devoluções
`ITestSuite.MultiDeviceModuleStrategy`

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 exigidos pelo teste. Retorna nulo se não houver suporte para 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 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` : O objeto `TestInformation` que contém informações úteis para executar testes.
`listener`	`ITestInvocationListener` : o `ITestInvocationListener` dos resultados do teste

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

setDirectModule

public void setDirectModule (ModuleDefinition module)

Parâmetros
`module`	`ModuleDefinition`

setIntraModuleSharding

public void setIntraModuleSharding (boolean intraModuleSharding)

Parâmetros
`intraModuleSharding`	`boolean`

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 de teste.

Parâmetros
`collectors`

setMultiDeviceStrategy

public void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parâmetros
`strategy`	`ITestSuite.MultiDeviceModuleStrategy`

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

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`