ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

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

---

Contenitore per la configurazione dell'esecuzione del test. Questo utilissimo metodo ti aiuta a preparare ed eseguire i test.

Riepilogo

Campi
public static final String	ISOLATION_COST
public static final String	MODULE_ABI
public static final String	MODULE_CACHED Questa proprietà è impostata su true se i risultati del modulo di test sono stati memorizzati nella cache.
public static final String	MODULE_CONTROLLER
public static final String	MODULE_EXTERNAL_DEPENDENCIES
public static final String	MODULE_ID Module ID (ID modulo): il nome che verrà utilizzato per identificare in modo univoco il modulo durante testRunStart.
public static final String	MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY
public static final String	MODULE_ISOLATED Questa proprietà viene impostata su true se il modulo è in esecuzione su un dispositivo appena preparato.
public static final String	MODULE_NAME Il nome del modulo è il nome base associato al modulo, in genere proveniente dal file di configurazione TF XML da cui è stato caricato il modulo.
public static final String	MODULE_PARAMETERIZATION
public static final String	MODULE_SKIPPED Questa proprietà viene impostata su true se il modulo di test è stato ignorato
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 Questa proprietà viene impostata su true se vengono registrati solo gli eventi a livello di modulo.
public static final String	TEAR_DOWN_TIME
public static final String	TEST_TIME

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

Metodi pubblici
int	compareTo(ModuleDefinition moduleDef)
String	getId() Restituisce il nome univoco del modulo.
Integer	getIntraModuleShardCount()
Integer	getIntraModuleShardIndex()
IConfiguration	getModuleConfiguration()
IInvocationContext	getModuleInvocationContext() Restituisce il valore IInvocationContext associato al modulo.
	getRequiredTokens(TestInformation testInfo)
long	getRuntimeHint() Restituisce il tempo approssimativo necessario per eseguire tutti i test nel modulo.
boolean	hasModuleFailed() Restituisce True se è stato chiamato un testRunFailure nel modulo *
int	neededDevices() Restituisce il numero di dispositivi su cui è previsto l'esecuzione di questo test.
int	numTests() Restituisce il numero corrente di IRemoteTest in attesa di esecuzione.
final void	reportNotExecuted(ITestInvocationListener listener, String message) Segnala i moduli completamente non eseguiti.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners) Esegui tutti i IRemoteTest contenuti nel modulo e utilizza tutti i preparativi prima e dopo per configurare e pulire il dispositivo.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, int maxRunLimit) Esegui tutti i IRemoteTest contenuti nel modulo e utilizza tutti i preparati prima e dopo per configurare e pulire il dispositivo.
final void	run(TestInformation moduleInfo, ITestInvocationListener listener) Esegui tutti i IRemoteTest contenuti nel modulo e utilizza tutti i preparativi prima e dopo per configurare e pulire il dispositivo.
Throwable	runPreparation(boolean includeSuitePreparers) Esegui i preparativi del test, inclusi i preparativi a livello di suite, se specificati.
void	setBuild(IBuildInfo build) Inserisci il IBuildInfo da utilizzare durante i test.
void	setCollectTestsOnly(boolean collectTestsOnly) Attiva o disattiva la modalità di raccolta di prova
void	setDevice(ITestDevice device) Inserisci il valore ITestDevice da utilizzare durante i test.
void	setEnableDynamicDownload(boolean enableDynamicDownload) Se attivare o meno il download dinamico a livello di modulo.
void	setIntraModuleInformation(int shardCount, int shardIndex)
void	setLogSaver(ILogSaver logSaver) Passa il salvatore dei log di chiamata al modulo in modo che possa utilizzarlo, se necessario.
final void	setMergeAttemps(boolean mergeAttempts) Imposta se unire o meno i risultati.
void	setMetricCollectors( collectors) Inserisci l'elenco di IMetricCollector da utilizzare dal modulo.
void	setRecoverVirtualDevice(boolean recoverVirtualDevice) I set dovrebbero recuperare il dispositivo virtuale.
final void	setRetryDecision(IRetryDecision decision) Imposta il valore IRetryDecision da utilizzare per il nuovo tentativo all'interno del modulo.
boolean	shouldRecoverVirtualDevice() Restituisce se dobbiamo recuperare il dispositivo virtuale.
String	toString()
void	transferSuiteLevelOptions(IConfiguration mSuiteConfiguration) Copia alcune della configurazione a livello di suite

Metodi protetti
boolean	hasTests() Restituisce True se il modulo ha ancora IRemoteTest da eseguire nel pool.

Campi

ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULO_CACHE

public static final String MODULE_CACHED

Questa proprietà è impostata su true se i risultati del modulo di test sono stati memorizzati nella cache.

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

ID_MODULO

public static final String MODULE_ID

ID modulo, il nome che verrà utilizzato per identificare in modo univoco il modulo durante testRunStart. Di solito si tratta di una combinazione di MODULE_ABI + MODULE_NAME.

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

MODULE_ISOLATED

public static final String MODULE_ISOLATED

Questa proprietà è impostata su true se il modulo era in esecuzione su un dispositivo appena preparato.

MODULE_NAME

public static final String MODULE_NAME

Il nome del modulo è il nome di base associato al modulo, di solito proveniente dal file di configurazione TF Xml da cui è stato caricato il modulo.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

MODULE_SKIPPED

public static final String MODULE_SKIPPED

Questa proprietà viene impostata su true se il modulo di test è stato ignorato

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

Questa proprietà viene impostata su true se vengono registrati solo gli eventi a livello di modulo.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

Costruttori pubblici

ModuleDefinition

public ModuleDefinition ()

ModuleDefinition

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

Costruttore

Parametri
name	String: nome univoco della configurazione di test.
tests	: elenco di IRemoteTest da eseguire.
preparersPerDevice	: elenco di ITargetPreparer da utilizzare per configurare il dispositivo.
multiPreparers
moduleConfig	IConfiguration: il IConfiguration della configurazione del modulo sottostante.

Definizione del modulo

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

Costruttore

Parametri
name	String: nome univoco della configurazione del test.
tests	: elenco di IRemoteTest da eseguire.
preparersPerDevice	: elenco di ITargetPreparer da utilizzare per configurare il dispositivo.
suitePreparersPerDevice
multiPreparers
moduleConfig	IConfiguration: il IConfiguration della configurazione dei moduli sottostanti.

Metodi pubblici

confrontaTo

public int compareTo (ModuleDefinition moduleDef)

Parametri
moduleDef	ModuleDefinition

Ritorni
int

getId

public String getId ()

Restituisce il nome univoco del modulo.

Ritorni
String

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

Ritorni
Integer

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

Ritorni
Integer

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

Ritorni
IConfiguration

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

Restituisce il IInvocationContext associato al modulo.

Ritorni
IInvocationContext

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Parametri
testInfo	TestInformation

Ritorni

getRuntimeHint

public long getRuntimeHint ()

Restituisce il tempo approssimativo per eseguire tutti i test nel modulo.

Ritorni
long

hasModuleFailed

public boolean hasModuleFailed ()

Restituisce True se è stato chiamato un testRunFailure nel modulo *

Ritorni
boolean

neededDevices

public int neededDevices ()

Restituisce il numero di dispositivi su cui è previsto l'esecuzione di questo test.

Ritorni
int

numTests

public int numTests ()

Restituisce il numero corrente di IRemoteTest in attesa di esecuzione.

Ritorni
int

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Segnala i moduli completamente non eseguiti.

Parametri
listener	ITestInvocationListener
message	String

run

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

Esegui tutti i IRemoteTest contenuti nel modulo e utilizza tutti i preparati prima e dopo per configurare e pulire il dispositivo.

Parametri
moduleInfo	TestInformation
listener	ITestInvocationListener: il ITestInvocationListener in cui segnalare i risultati.
moduleLevelListeners	: l'elenco di listener a livello di modulo.

Lanci
DeviceNotAvailableException	in caso di disconnessione del dispositivo.

run

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

Esegui tutti i IRemoteTest contenuti nel modulo e utilizza tutti i preparati prima e dopo per configurare e pulire il dispositivo.

Parametri
moduleInfo	TestInformation: il TestInformation per il modulo.
listener	ITestInvocationListener: il ITestInvocationListener in cui segnalare i risultati.
moduleLevelListeners	: l'elenco degli ascoltatori a livello di modulo.
maxRunLimit	int: il numero massimo di esecuzioni per ogni test case.

Lanci
DeviceNotAvailableException	in caso di disconnessione del dispositivo.

run

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

Esegui tutti i IRemoteTest contenuti nel modulo e utilizza tutti i preparati prima e dopo per configurare e pulire il dispositivo.

Parametri
moduleInfo	TestInformation
listener	ITestInvocationListener: il ITestInvocationListener in cui segnalare i risultati.

Lanci
DeviceNotAvailableException	in caso di disconnessione del dispositivo.

corsaPreparazione

public Throwable runPreparation (boolean includeSuitePreparers)

Esegui i preparativi del test, inclusi i preparativi a livello di suite, se specificati.

Parametri
includeSuitePreparers	boolean: imposta su true per eseguire anche i preparativi a livello di suite.

Ritorni
Throwable	Throwable di qualsiasi eccezione sollevata durante la corsa dei preparativi.

setBuild

public void setBuild (IBuildInfo build)

Inserisci il valore IBuildInfo da utilizzare durante i test.

Parametri
build	IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Attiva o disattiva la modalità di raccolta dei test

setDevice

public void setDevice (ITestDevice device)

Inserisci il ITestDevice da utilizzare durante i test.

Parametri
device	ITestDevice

setAbilitaDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

Se attivare o meno il download dinamico a livello di modulo.

Parametri
enableDynamicDownload	boolean

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

Parametri
shardCount	int
shardIndex	int

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Passa il salvatore dei log di chiamata al modulo in modo che possa utilizzarlo, se necessario.

Parametri
logSaver	ILogSaver

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

Imposta se unire o meno i risultati.

Parametri
mergeAttempts	boolean

setMetricCollectors

public void setMetricCollectors ( collectors)

Inserisci l'elenco di IMetricCollector da utilizzare dal modulo.

Parametri
collectors

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

I set dovrebbero recuperare il dispositivo virtuale.

Parametri
recoverVirtualDevice	boolean

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

Imposta il valore IRetryDecision da utilizzare per il nuovo tentativo all'interno del modulo.

Parametri
decision	IRetryDecision

dovrebbeRecuperareilDispositivoVirtuale

public boolean shouldRecoverVirtualDevice ()

Restituisce se dobbiamo recuperare il dispositivo virtuale.

Ritorni
boolean

toString

public String toString ()

Ritorni
String

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

Copiare alcune impostazioni a livello di suite

Parametri
mSuiteConfiguration	IConfiguration

Metodi protetti

hasTest

protected boolean hasTests ()

Restituisce True se il modulo ha ancora IRemoteTest da eseguire nel pool. Falso negli altri casi.

Ritorni
boolean