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