Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ModuleDefinition

public class ModuleDefinition
extends Object implements Comparable<ModuleDefinition>, ITestCollector

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

Contêiner para a configuração de execução do teste. Essa classe é uma auxiliar para preparar e executar os testes.

Resumo

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

Construtores públicos
`ModuleDefinition()`
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` Construtor
`ModuleDefinition(String name, Collection<IRemoteTest> tests, Map<String, List<ITargetPreparer>> preparersPerDevice, Map<String, List<ITargetPreparer>> suitePreparersPerDevice, List<IMultiTargetPreparer> multiPreparers, IConfiguration moduleConfig)` Construtor

Métodos públicos
`int`	`compareTo(ModuleDefinition moduleDef)`
`Set<Digest>`	`getFilterDigests()` Retorna os resumos dos filtros associados aos testes.
`String`	`getId()` Retorna o nome exclusivo do módulo.
`Integer`	`getIntraModuleShardCount()`
`Integer`	`getIntraModuleShardIndex()`
`IConfiguration`	`getModuleConfiguration()`
`IInvocationContext`	`getModuleInvocationContext()` Retorna o `IInvocationContext` associado ao módulo.
`TestInformation`	`getModuleTestInformation()`
`Set<TokenProperty>`	`getRequiredTokens(TestInformation testInfo)`
`long`	`getRuntimeHint()` Retorna o tempo aproximado para executar todos os testes no módulo.
`boolean`	`hasModuleFailed()` Retorna "True" se um "testRunFailure" tiver sido chamado no módulo *
`int`	`neededDevices()` Retorna o número de dispositivos que devem 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 não executados completamente.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, 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)` Executa preparadores do teste, incluindo preparadores no nível do conjunto, se especificado.
`void`	`setBuild(IBuildInfo build)` Injete o `IBuildInfo` a ser usado durante os testes.
`void`	`setCollectKernelLog(boolean collectKernelLog)`
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Ativa ou desativa o modo de coleta de testes.
`void`	`setDefaultLogCollectors(List<IMetricCollector> collectors)`
`void`	`setDevice(ITestDevice device)` Injete o `ITestDevice` a ser usado durante os testes.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` Define se o download dinâmico será ativado no nível do módulo.
`void`	`setIntraModuleInformation(int shardCount, int shardIndex)`
`void`	`setLogSaver(ILogSaver logSaver)` Transmita o gravador de registros de invocação ao módulo para que ele possa usá-lo, se necessário.
`final void`	`setMergeAttemps(boolean mergeAttempts)` Define se devemos ou não mesclar os resultados.
`void`	`setMetricCollectors(List<IMetricCollector> collectors)` Injete a lista de `IMetricCollector` a ser usada pelo módulo.
`void`	`setRecoverVirtualDevice(boolean recoverVirtualDevice)` Os conjuntos precisam recuperar o dispositivo virtual.
`void`	`setRemoveModuleBuffering(boolean removeModuleBuffering)`
`void`	`setReportModuleEnd(boolean shouldReportModuleEnd)`
`void`	`setReportModuleStart(boolean shouldReportModuleStart)`
`final void`	`setRetryDecision(IRetryDecision decision)` Define o `IRetryDecision` a ser usado para novas tentativas no módulo.
`void`	`setUseModuleResultsForwarder(boolean useModuleResultsForwarder)`
`boolean`	`shouldRecoverVirtualDevice()` Retorna se devemos recuperar o dispositivo virtual.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` Copie algumas das configurações no nível da suíte

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

Constantes

ISOLATION_COST

public static final String ISOLATION_COST

Valor da constante: "ISOLATION_COST"

MODULE_ABI

public static final String MODULE_ABI

Valor da constante: "module-abi"

MODULE_CACHED

public static final String MODULE_CACHED

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

Valor da constante: "module-cached"

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

Valor da constante: "module_controller"

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

Valor da constante: "module-external-dependencies"

MODULE_ID

public static final String MODULE_ID

ID do módulo, o nome que será usado para identificar exclusivamente o módulo durante testRunStart. Geralmente, é uma combinação de MODULE_ABI + MODULE_NAME.

Valor da constante: "module-id"

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

Valor da constante: "module-flag-overrides"

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Essa propriedade é definida como "true" se o módulo estava sendo executado em um dispositivo recém-preparado.

Valor da constante: "module-isolated"

MODULE_NAME

public static final String MODULE_NAME

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

Valor da constante: "module-name"

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

Valor da constante: "module-param"

MODULE_SKIPPED

public static final String MODULE_SKIPPED

Essa propriedade é definida como "true" se o módulo de teste foi ignorado.

Valor da constante: "module-skipped"

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

Valor da constante: "MODULE_TEST_COUNT"

PREPARATION_TIME

public static final String PREPARATION_TIME

Valor da constante: "PREP_TIME"

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

Valor da constante: "MODULE_RETRY_FAILED"

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

Valor da constante: "MODULE_RETRY_SUCCESS"

RETRY_TIME

public static final String RETRY_TIME

Valor da constante: "MODULE_RETRY_TIME"

SPARSE_MODULE

public static final String SPARSE_MODULE

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

Valor da constante: "sparse-module"

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

Valor da constante: "TEARDOWN_TIME"

TEST_TIME

public static final String TEST_TIME

Valor da constante: "TEST_TIME"

Construtores públicos

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Construtor

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

ModuleDefinition

public ModuleDefinition (String name, 
                Collection<IRemoteTest> tests, 
                Map<String, List<ITargetPreparer>> preparersPerDevice, 
                Map<String, List<ITargetPreparer>> suitePreparersPerDevice, 
                List<IMultiTargetPreparer> multiPreparers, 
                IConfiguration moduleConfig)

Construtor

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

Métodos públicos

compareTo

public int compareTo (ModuleDefinition moduleDef)

Parâmetros
`moduleDef`	`ModuleDefinition`

Retorna
`int`

getFilterDigests

public Set<Digest> getFilterDigests ()

Retorna os resumos dos filtros associados aos testes.

Retorna
`Set<Digest>`

Gera
`IOException`

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`

getModuleTestInformation

public TestInformation getModuleTestInformation ()

Retorna
`TestInformation`

getRequiredTokens

public Set<TokenProperty> getRequiredTokens (TestInformation testInfo)

Parâmetros
`testInfo`	`TestInformation`

Retorna
`Set<TokenProperty>`

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 um "testRunFailure" tiver sido chamado no módulo *

Retorna
`boolean`

neededDevices

public int neededDevices ()

Retorna o número de dispositivos que devem 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 não executados completamente.

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

run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                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 serão informados.
`maxRunLimit`	`int`: o número máximo de execuções para cada caso de teste.

Gera
`DeviceNotAvailableException`	caso o dispositivo fique 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 serão informados.

Gera
`DeviceNotAvailableException`	caso o dispositivo fique off-line.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Executa preparadores do teste, incluindo preparadores no nível do conjunto, se especificado.

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

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

setBuild

public void setBuild (IBuildInfo build)

Injete o IBuildInfo a ser usado durante os testes.

Parâmetros
`build`	`IBuildInfo`

setCollectKernelLog

public void setCollectKernelLog (boolean collectKernelLog)

Parâmetros
`collectKernelLog`	`boolean`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Ativa ou desativa o modo de coleta de testes.

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

Parâmetros
`collectors`	`List`

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 será ativado 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 registros de invocação ao módulo para que ele possa usá-lo, se necessário.

Parâmetros
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Define se devemos ou não mesclar os resultados.

Parâmetros
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

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

Parâmetros
`collectors`	`List`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

Os conjuntos precisam recuperar o dispositivo virtual.

Parâmetros
`recoverVirtualDevice`	`boolean`

setRemoveModuleBuffering

public void setRemoveModuleBuffering (boolean removeModuleBuffering)

Parâmetros
`removeModuleBuffering`	`boolean`

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

Parâmetros
`shouldReportModuleEnd`	`boolean`

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

Parâmetros
`shouldReportModuleStart`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Define o IRetryDecision a ser usado para novas tentativas no módulo.

Parâmetros
`decision`	`IRetryDecision`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

Parâmetros
`useModuleResultsForwarder`	`boolean`

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Retorna se devemos recuperar o dispositivo virtual.

Retorna
`boolean`

toString

public String toString ()

Retorna
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Copie algumas das configurações no nível da suíte

Parâmetros
`mSuiteConfiguration`	`IConfiguration`

Métodos protegidos

hasTests

protected boolean hasTests ()

Retorna True se o módulo ainda tiver IRemoteTest para executar no pool. Caso contrário, retorna "falso".

Retorna
`boolean`