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 será definida como verdadeira se os resultados do módulo de teste forem armazenados em cache.

public static final String MODULE_CONTROLLER

public static final String MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_ID

ID do módulo o nome que será usado para identificar exclusivamente o módulo durante testRunStart.

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_ISOLATED

Essa propriedade é definida como "true" 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 de base associado ao módulo, geralmente proveniente do arquivo de configuração Xml TF 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 será definida como verdadeira se apenas 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)

Relatório que não foi executado em módulos completamente 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 protetor de registro de invocação ao módulo para que ele possa usá-lo, se necessário.

final void setMergeAttemps(boolean mergeAttempts)

Define se os resultados devem ou não ser mesclados.

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 nova tentativa intramódulo.

boolean shouldRecoverVirtualDevice()

Retorna se for necessário recuperar o dispositivo virtual.

String toString()

void transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)

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

Métodos protegidos

boolean hasTests()

Retorne "True" se o módulo ainda tiver IRemoteTest para ser executado 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.

CONTROLE_MÓDULO

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 é uma combinação de MODULE_ABI + MODULE_NAME.

MÓDULO_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 "true" se o módulo estiver em execução em um dispositivo recém-preparado.

NOME DO MÓDULO

public static final String MODULE_NAME

O nome do módulo é o nome básico associado ao módulo, 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

Esta propriedade será definida como verdadeira se o módulo de teste tiver sido 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

TEMPO_DE_TESTE

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 que serão usados para configurar o dispositivo.

suitePreparersPerDevice

multiPreparers

moduleConfig IConfiguration: o IConfiguration da configuração do módulo.

Métodos públicos

compararTo

public int compareTo (ModuleDefinition moduleDef)

Parâmetros
moduleDef ModuleDefinition

Retorna
int

getId

public String getId ()

Retorne 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 caso um testRunFailure tenha sido chamado no módulo *

Retorna
boolean

dispositivos necessários

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 também executar preparadores no 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 que será usado durante os testes.

Parâmetros
device ITestDevice

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

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 registro de invocação ao 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 devemos recuperar o dispositivo virtual.

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 verdadeiro se o módulo ainda tiver IRemoteTest para executar no pool. Falso em outros casos.

Retorna
boolean