Definição de módulo

public class ModuleDefinition
extends Object implements ITestCollector

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

---

Contêiner da configuração de execução do 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 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_ISOLATED Essa propriedade é definida como verdadeira se o módulo foi executado 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 TF XML arquivo de configuração a partir do qual o módulo foi carregado.
public static final String	MODULE_PARAMETERIZATION
public static final String	MODULE_SKIPPED Esta propriedade será definida como verdadeira se o módulo de teste tiver sido 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() 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 no módulo.
boolean	hasModuleFailed() Retorna True caso um testRunFailure tenha sido 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 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 de 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 de 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 de configurar e limpar o dispositivo.
Throwable	runPreparation(boolean includeSuitePreparers) Execute preparadores do teste, incluindo preparadores no nível do pacote, se especificado.
void	setBuild(IBuildInfo build) Injete o IBuildInfo que 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 que será usado durante os testes.
void	setEnableDynamicDownload(boolean enableDynamicDownload) Se o download dinâmico deve ser ativado no nível do módulo.
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 no 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

MÓDULO_ABI

public static final String MODULE_ABI

MÓDULO_CACHADO

public static final String MODULE_CACHED

Essa propriedade será definida como verdadeira se os resultados do módulo de teste forem armazenados em cache.

CONTROLE_MÓDULO

public static final String MODULE_CONTROLLER

DECLARAÇÕES DE MÓDULO_EXTERNOS

public static final String MODULE_EXTERNAL_DEPENDENCIES

ID DO MÓDULO

public static final String MODULE_ID

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

MÓDULO_Isolado

public static final String MODULE_ISOLATED

Essa propriedade é definida como verdadeira se o módulo foi executado em um dispositivo recém-preparado.

NOME DO MÓDULO

public static final String MODULE_NAME

O nome do módulo é o nome de base associado ao módulo, geralmente proveniente do TF XML arquivo de configuração a partir do qual o módulo foi carregado.

PARÂMETROS_MÓDULOS

public static final String MODULE_PARAMETERIZATION

MÓDULO_PULADO

public static final String MODULE_SKIPPED

Esta propriedade será definida como verdadeira se o módulo de teste tiver sido ignorado

CONTAGEM_DE_TESTE_MÓDULOS

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

TENTAR_CONTAR_SUCESSO_DE NOVAMENTE

public static final String RETRY_SUCCESS_COUNT

TEMPO_DE_REPETIR

public static final String RETRY_TIME

MÓDULO_DE ESPERA

public static final String SPARSE_MODULE

Essa propriedade será definida como verdadeira se apenas 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

Definição de módulo

public ModuleDefinition ()

Definição de módulo

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 precisa ser executada.
preparersPerDevice	: lista de ITargetPreparer que serão usados para configurar o dispositivo.
multiPreparers
moduleConfig	IConfiguration: o IConfiguration da configuração do módulo subjacente.

Definição de módulo

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 precisa ser executada.
preparersPerDevice	: lista de ITargetPreparer que serão usados para configurar o dispositivo.
suitePreparersPerDevice
multiPreparers
moduleConfig	IConfiguration: o IConfiguration da configuração do módulo subjacente.

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

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

Relatório que não foi executado em módulos completamente 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 de configurar e limpar o dispositivo.

Parâmetros
moduleInfo	TestInformation
listener	ITestInvocationListener: o ITestInvocationListener em que os resultados serão informados.
moduleLevelListeners	: a lista de listeners no nível do módulo.

Gera
DeviceNotAvailableException	caso o dispositivo fique 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 de 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.
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	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 de 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)

Execute preparadores do teste, incluindo preparadores no nível do pacote, 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 durante a execução de preparadores.

SetBuild

public void setBuild (IBuildInfo build)

Injete o IBuildInfo que será usado durante os testes.

Parâmetros
build	IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Ativa ou desativa o modo de coleta de testes

Definir dispositivo

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 deve ser ativado no nível do módulo.

Parâmetros
enableDynamicDownload	boolean

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Transmita o protetor de registro 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 os resultados devem ou não ser mesclados.

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

Parâmetros
decision	IRetryDecision

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

Retorna se for necessário recuperar o dispositivo virtual.

Retorna
boolean

toString

public String toString ()

Retorna
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

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

Parâmetros
mSuiteConfiguration	IConfiguration

Métodos protegidos

hasTests.

protected boolean hasTests ()

Retorne "True" se o módulo ainda tiver IRemoteTest para ser executado no pool. Falso, do contrário.

Retorna
boolean