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,
Construtor |
|
ModuleDefinition(String name,
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 |
|
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 |
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,
Execute todos os |
final
void
|
run(TestInformation moduleInfo, ITestInvocationListener listener,
Execute todos os |
final
void
|
run(TestInformation moduleInfo, ITestInvocationListener listener)
Execute todos os |
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 |
void
|
setCollectTestsOnly(boolean collectTestsOnly)
Ativa ou desativa o modo de coleta de testes |
void
|
setDevice(ITestDevice device)
Injete o |
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(
Injete a lista de |
void
|
setRecoverVirtualDevice(boolean recoverVirtualDevice)
Os conjuntos devem recuperar o dispositivo virtual. |
final
void
|
setRetryDecision(IRetryDecision decision)
Define o |
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 |
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 |
getModuleInvocationContext
public IInvocationContext getModuleInvocationContext ()
Retorna o IInvocationContext
associado ao módulo.
Retorna | |
---|---|
IInvocationContext |
getRequiredTokens
publicgetRequiredTokens (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 |