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