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 de execução do teste. Essa classe ajuda a 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` O ID do módulo é o nome que será usado para identificar exclusivamente o módulo durante o 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, 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.
`TestInformation`	`getModuleTestInformation()`
	`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)` Relatar módulos completamente não executados.
`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`	`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 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( 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

O ID do módulo é o nome que será usado para identificar exclusivamente o módulo durante o 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, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

Construtor

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

ModuleDefinition

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

Construtor

Parâmetros
`name`	`String`: nome exclusivo da configuração de teste.
`tests`	: lista de `IRemoteTest` que precisam ser executados.
`preparersPerDevice`	: lista de `ITargetPreparer` a serem usadas para configurar o dispositivo.
`suitePreparersPerDevice`
`multiPreparers`
`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`

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

Relatar módulos completamente não executados.

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 executar também 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`

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 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 ( collectors)

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

Parâmetros
`collectors`

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`