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.

ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.suite.ModuleDefinition

Contêiner para a configuração da execução do teste. Essa classe ajuda a preparar e executar os testes.

Resumo

Campos
`public static final String`	`ISOLATION_COST`
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CACHED` Essa propriedade é definida como verdadeira se os resultados do módulo de teste foram armazenados em cache.
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_EXTERNAL_DEPENDENCIES`
`public static final String`	`MODULE_ID` O ID do módulo é o nome que será usado para identificar de forma exclusiva o módulo durante o testRunStart.
`public static final String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`public static final String`	`MODULE_ISOLATED` Essa propriedade é definida como verdadeira se o módulo estiver em execução em um dispositivo recém-preparado.
`public static final String`	`MODULE_NAME` O nome do módulo é o nome básico associado a ele, geralmente proveniente do arquivo de configuração do TF Xml de onde o módulo foi carregado.
`public static final String`	`MODULE_PARAMETERIZATION`
`public static final String`	`MODULE_SKIPPED` Essa propriedade é definida como verdadeira se o módulo de teste foi ignorado
`public static final String`	`MODULE_TEST_COUNT`
`public static final String`	`PREPARATION_TIME`
`public static final String`	`RETRY_FAIL_COUNT`
`public static final String`	`RETRY_SUCCESS_COUNT`
`public static final String`	`RETRY_TIME`
`public static final String`	`SPARSE_MODULE` Essa propriedade é definida como verdadeira se apenas os eventos no nível do módulo forem informados.
`public static final String`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

Construtores públicos
`ModuleDefinition()`
`ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Construtor
`ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` Construtor

Métodos públicos
`int`	`compareTo(ModuleDefinition moduleDef)`
`String`	`getId()` Retorna o nome exclusivo do módulo.
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` Retorna o `IInvocationContext` associado ao módulo.
	`getRequiredTokens(TestInformation testInfo)`
`long`	`getRuntimeHint()` Retorna o tempo aproximado para executar todos os testes no módulo.
`boolean`	`hasModuleFailed()` Retorna "True" se uma falha de execução de teste foi chamada no módulo.
`int`	`neededDevices()` Retorna o número de dispositivos esperados para executar esse teste.
`int`	`numTests()` Retorna o número atual de `IRemoteTest` aguardando execução.
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` Informar módulos que não foram executados.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners)` Execute todos os `IRemoteTest` contidos no módulo e use todos os preparadores antes e depois para configurar e limpar o dispositivo.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, int maxRunLimit)` Execute todos os `IRemoteTest` contidos no módulo e use todos os preparadores antes e depois para configurar e limpar o dispositivo.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` Execute todos os `IRemoteTest` contidos no módulo e use todos os preparadores antes e depois para configurar e limpar o dispositivo.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` Executar os preparadores do teste, incluindo os preparadores do nível do conjunto, se especificado.
`void`	`setBuild(IBuildInfo build)` Injete o `IBuildInfo` a ser usado durante os testes.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Ativa ou desativa o modo de coleta de testes
`void`	`setDevice(ITestDevice device)` Injete o `ITestDevice` a ser usado durante os testes.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` Define se o download dinâmico vai ser ativado ou não no nível do módulo.
`void`	`setIntraModuleInformation(int shardCount, int shardIndex)`
`void`	`setLogSaver(ILogSaver logSaver)` Transmita o gravador de registro de invocação para o módulo, para que ele possa ser usado, se necessário.
`final void`	`setMergeAttemps(boolean mergeAttempts)` Define se é necessário mesclar os resultados.
`void`	`setMetricCollectors( collectors)` Injete a lista de `IMetricCollector` a ser usada pelo módulo.
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` Os conjuntos devem recuperar o dispositivo virtual.
`final void`	`setRetryDecision(IRetryDecision decision)` Define o `IRetryDecision` a ser usado para a nova tentativa no módulo.
`boolean`	`shouldRecoverVirtualDevice()` Retorna se o dispositivo virtual precisa ser recuperado.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Copiar algumas configurações do nível do pacote

Métodos protegidos
`boolean`	`hasTests()` Retorna "True" se o módulo ainda tiver `IRemoteTest` para executar no pool.

Campos

ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULE_CACHED

public static final String MODULE_CACHED

Essa propriedade é definida como verdadeira se os resultados do módulo de teste foram armazenados em cache.

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

MODULE_ID

public static final String MODULE_ID

O ID do módulo é o nome que será usado para identificar de forma exclusiva o módulo durante o testRunStart. Ele geralmente será uma combinação de MODULE_ABI + MODULE_NAME.

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Essa propriedade é definida como verdadeira se o módulo estiver em execução em um dispositivo recém-preparado.

MODULE_NAME

public static final String MODULE_NAME

O nome do módulo é o nome básico associado a ele, geralmente proveniente do arquivo de configuração do TF Xml de onde o módulo foi carregado.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

MODULE_SKIPPED

public static final String MODULE_SKIPPED

Essa propriedade é definida como verdadeira se o módulo de teste foi ignorado

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

PREPARATION_TIME

public static final String PREPARATION_TIME

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

RETRY_TIME

public static final String RETRY_TIME

SPARSE_MODULE

public static final String SPARSE_MODULE

Essa propriedade é definida como verdadeira se apenas os eventos no nível do módulo forem informados.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Construtores públicos

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Construtor

Parâmetros
`name`	`String`: nome exclusivo da configuração do teste.
`tests`	: lista de `IRemoteTest` que precisam ser executados.
`preparersPerDevice`	: lista de `ITargetPreparer` a serem usados para configurar o dispositivo.
`multiPreparers`
`moduleConfig`	`IConfiguration`: o `IConfiguration` da configuração do módulo.

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Construtor

Parâmetros
`name`	`String`: nome exclusivo da configuração do teste.
`tests`	: lista de `IRemoteTest` que precisam ser executados.
`preparersPerDevice`	: lista de `ITargetPreparer` a serem usados para configurar o dispositivo.
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`: o `IConfiguration` da configuração do módulo.

Métodos públicos

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parâmetros
`moduleDef`	`ModuleDefinition`

Retorna
`int`

getId

public String getId ()

Retorna o nome exclusivo do módulo.

Retorna
`String`

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

Retorna
`Integer`

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

Retorna
`Integer`

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Retorna
`IConfiguration`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Retorna o IInvocationContext associado ao módulo.

Retorna
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Parâmetros
`testInfo`	`TestInformation`

Retorna

getRuntimeHint

public long getRuntimeHint ()

Retorna o tempo aproximado para executar todos os testes no módulo.

Retorna
`long`

hasModuleFailed

public boolean hasModuleFailed ()

Retorna "True" se uma falha de execução de teste foi chamada no módulo.

Retorna
`boolean`

neededDevices

public int neededDevices ()

Retorna o número de dispositivos esperados para executar esse teste.

Retorna
`int`

numTests

public int numTests ()

Retorna o número atual de IRemoteTest aguardando execução.

Retorna
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informar módulos que não foram executados.

Parâmetros
`listener`	`ITestInvocationListener`
`message`	`String`

run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners)

Execute todos os IRemoteTest contidos no módulo e use todos os preparadores antes e depois para configurar e limpar o dispositivo.

Parâmetros
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` em que os resultados são informados.
`moduleLevelListeners`	: a lista de listeners no nível do módulo.

Gera
`DeviceNotAvailableException`	no caso de o dispositivo ficar off-line.

run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                int maxRunLimit)

Execute todos os IRemoteTest contidos no módulo e use todos os preparadores antes e depois para configurar e limpar o dispositivo.

Parâmetros
`moduleInfo`	`TestInformation`: o `TestInformation` do módulo.
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` em que os resultados são informados.
`moduleLevelListeners`	: a lista de listeners no nível do módulo.
`maxRunLimit`	`int`: o número máximo de execuções para cada caso de teste.

Gera
`DeviceNotAvailableException`	no caso de o dispositivo ficar off-line.

run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Execute todos os IRemoteTest contidos no módulo e use todos os preparadores antes e depois para configurar e limpar o dispositivo.

Parâmetros
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` em que os resultados são informados.

Gera
`DeviceNotAvailableException`	no caso de o dispositivo ficar off-line.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Executar os preparadores do teste, incluindo os preparadores do nível do conjunto, se especificado.

Parâmetros
`includeSuitePreparers`	`boolean`: defina como `true` para executar também os preparadores do nível do pacote.

Retorna
`Throwable`	`Throwable` de qualquer exceção gerada ao executar os preparadores.

setBuild

public void setBuild (IBuildInfo build)

Injete o IBuildInfo a ser usado durante os testes.

Parâmetros
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Ativa ou desativa o modo de coleta de testes

setDevice

public void setDevice (ITestDevice device)

Injete o ITestDevice a ser usado durante os testes.

Parâmetros
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Define se o download dinâmico vai ser ativado ou não no nível do módulo.

Parâmetros
`enableDynamicDownload`	`boolean`

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

Parâmetros
`shardCount`	`int`
`shardIndex`	`int`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Transmita o gravador de registro de invocação para o módulo, para que ele possa ser usado, se necessário.

Parâmetros
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Define se é necessário mesclar os resultados.

Parâmetros
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

Injete a lista de IMetricCollector a ser usada pelo módulo.

Parâmetros
`collectors`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Os conjuntos devem recuperar o dispositivo virtual.

Parâmetros
`recoverVirtualDevice`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Define o IRetryDecision a ser usado para a nova tentativa no módulo.

Parâmetros
`decision`	`IRetryDecision`

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Retorna se o dispositivo virtual precisa ser recuperado.

Retorna
`boolean`

toString

public String toString ()

Retorna
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Copiar algumas configurações do nível do pacote

Parâmetros
`mSuiteConfiguration`	`IConfiguration`

Métodos protegidos

hasTests

protected boolean hasTests ()

Retorna "True" se o módulo ainda tiver IRemoteTest para executar no pool. Falso em outros casos.

Retorna
`boolean`