Definição do Módulo

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 de teste. Esta classe é um auxiliar para 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

Esta propriedade será configurada como true 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

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

public static final String MODULE_ISOLATED

Esta propriedade será 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 base associado ao módulo, geralmente vindo do arquivo de configuração Xml TF do qual o módulo foi carregado.

public static final String MODULE_PARAMETERIZATION

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

Esta propriedade será configurada como true se apenas eventos de nível de módulo forem relatados.

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) ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig) ModuleDefinition (String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)

Construtor

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

Construtor

Métodos públicos

int compareTo ( ModuleDefinition moduleDef)

String getId ()

Retorne o nome exclusivo do módulo.

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 do módulo.

boolean hasModuleFailed ()

Retorna True se um testRunFailure foi chamado no módulo *

int neededDevices ()

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

int numTests ()

Retorna o número atual de IRemoteTest aguardando para ser executado.

final void reportNotExecuted ( ITestInvocationListener listener, String message)

Relate módulos completamente não executados.

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

Execute todo o IRemoteTest contido 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, TestFailureListener failureListener) run ( TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)

Execute todo o IRemoteTest contido 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 todo o IRemoteTest contido no módulo e use todos os preparadores antes e depois para configurar e limpar o dispositivo.

Throwable runPreparation (boolean includeSuitePreparers)

Execute preparadores do teste, incluindo preparadores de nível de suíte, 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)

Habilitar ou não o download dinâmico no nível do módulo.

void setLogSaver ( ILogSaver logSaver)

Passe o protetor de log de invocação para o 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) setMetricCollectors ( collectors)

Injete a Lista de IMetricCollector a ser utilizada 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 novas tentativas intramódulo.

boolean shouldRecoverVirtualDevice ()

Retorna se devemos recuperar o dispositivo virtual.

String toString ()

void transferSuiteLevelOptions ( IConfiguration mSuiteConfiguration)

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

Métodos protegidos

boolean hasTests ()

Retorne True se o Módulo ainda tiver IRemoteTest para executar em seu pool.

Campos

ISOLATION_COST

public static final String ISOLATION_COST

MÓDULO_ABI

public static final String MODULE_ABI

MÓDULO_CACHED

public static final String MODULE_CACHED

Esta propriedade será configurada como true se os resultados do módulo de teste foram armazenados em cache.

MÓDULO_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

MÓDULO_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 será uma combinação de MODULE_ABI + MODULE_NAME.

MÓDULO_ISOLADO

public static final String MODULE_ISOLATED

Esta propriedade será definida como verdadeira 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 base associado ao módulo, geralmente vindo do arquivo de configuração Xml TF do qual o módulo foi carregado.

MÓDULO_PARAMETERIZAÇÃO

public static final String MODULE_PARAMETERIZATION

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

TEMPO DE PREPARAÇÃO

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

Esta propriedade será configurada como true se apenas eventos de nível de módulo forem relatados.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Construtores públicos

Definição do Módulo

public ModuleDefinition ()

Definição do Módulo

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 precisa ser executado.

preparersPerDevice : lista de ITargetPreparer a ser usada para configurar o dispositivo.

multiPreparers

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

Definição do Módulo

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 precisa ser executado.

preparersPerDevice : lista de ITargetPreparer a ser usada para configurar o dispositivo.

suitePreparersPerDevice

multiPreparers

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

Métodos públicos

comparado a

public int compareTo (ModuleDefinition moduleDef)

Parâmetros
moduleDef ModuleDefinition

Devoluções
int

obterId

public String getId ()

Retorne o nome exclusivo do módulo.

Devoluções
String

getModuleConfiguração

public IConfiguration getModuleConfiguration ()

Devoluções
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Retorna o IInvocationContext associado ao módulo.

Devoluções
IInvocationContext

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Parâmetros
testInfo TestInformation

Devoluções

getRuntimeHint

public long getRuntimeHint ()

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

Devoluções
long

hasModuleFailed

public boolean hasModuleFailed ()

Retorna True se um testRunFailure foi chamado no módulo *

Devoluções
boolean

necessáriosDispositivos

public int neededDevices ()

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

Devoluções
int

numTestes

public int numTests ()

Retorna o número atual de IRemoteTest aguardando para ser executado.

Devoluções
int

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Relate módulos completamente não executados.

Parâmetros
listener ITestInvocationListener

message String

correr

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

Execute todo o IRemoteTest contido 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 onde relatar os resultados.

moduleLevelListeners : a lista de ouvintes no nível do módulo.

failureListener TestFailureListener : um ouvinte específico para coletar logs em testFail. Pode ser nulo.

maxRunLimit int : o número máximo de execuções para cada caso de teste.

Lança
DeviceNotAvailableException no caso de o dispositivo ficar offline.

correr

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

Execute todo o IRemoteTest contido 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 onde relatar os resultados.

moduleLevelListeners : a lista de ouvintes no nível do módulo.

failureListener TestFailureListener : um ouvinte específico para coletar logs em testFail. Pode ser nulo.

Lança
DeviceNotAvailableException no caso de o dispositivo ficar offline.

correr

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Execute todo o IRemoteTest contido 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 onde relatar os resultados.

Lança
DeviceNotAvailableException no caso de o dispositivo ficar offline.

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

Execute preparadores do teste, incluindo preparadores de nível de suíte, se especificado.

Parâmetros
includeSuitePreparers boolean : definido como true para executar também preparadores de nível de suíte.

Devoluções
Throwable Throwable de qualquer exceção levantada 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

setDispositivo

public void setDevice (ITestDevice device)

Injete o ITestDevice a ser usado durante os testes.

Parâmetros
device ITestDevice

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Habilitar ou não o download dinâmico no nível do módulo.

Parâmetros
enableDynamicDownload boolean

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Passe o protetor de log de invocação para o 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 utilizada 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 novas tentativas intramódulo.

Parâmetros
decision IRetryDecision

deveriaRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Retorna se devemos recuperar o dispositivo virtual.

Devoluções
boolean

para sequenciar

public String toString ()

Devoluções
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

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

Parâmetros
mSuiteConfiguration IConfiguration

Métodos protegidos

temTestes

protected boolean hasTests ()

Retorne True se o Módulo ainda tiver IRemoteTest para executar em seu pool. Caso contrário, falso.

Devoluções
boolean