ITestSuite

public abstract class ITestSuite
extends Object implements IRemoteTest, IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest, ITestLoggerReceiver

java.lang.Object
? com.android.tradefed.testtype.suite.ITestSuite


Classe astratta utilizzata per eseguire Test Suite. Questa classe fornisce la base su come verrà eseguita la Suite. Ogni implementazione può definire l'elenco delle prove con le loadTests() metodo.

Riepilogo

Campi

public static final String ABI_OPTION

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

public static final String MODULE_CHECKER_POST

public static final String MODULE_CHECKER_PRE

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String PARAMETER_KEY

public static final String PREPARER_WHITELIST

public static final String PRIMARY_ABI_RUN

public static final String RANDOM_SEED

public static final String REBOOT_BEFORE_TEST

public static final String RUNNER_WHITELIST

public static final String SKIP_HOST_ARCH_CHECK

public static final String SKIP_SYSTEM_STATUS_CHECKER

public static final String TOKEN_KEY

Costruttori pubblici

ITestSuite ()

Metodi pubblici

void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
final void enableRebootBeforeTest ()

Imposta reboot-before-test su true.

getAbis (ITestDevice device)

Ottiene l'insieme di ABI supportato sia compatibilità test AbiUtils.getAbisSupportedByCompatibility() e il dispositivo in prova.

static getAbisForBuildTargetArchFromSuite ()

Restituisce il possibile abis da TestSuiteInfo.

IBuildInfo getBuildInfo ()

Attuazione della ITestSuite può richiedere informazioni build per caricare i test.

final IConfiguration getConfiguration ()

Restituisce l'invocazione IConfiguration .

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

Metti il ​​dispositivo in prova.

ModuleDefinition getDirectModule ()

Restituisce il ModuleDefinition da eseguire direttamente, oppure null se non ancora (quando l'ITestSuite non è stato ancora sharded).

IInvocationContext getInvocationContext ()

Restituisce il contesto di chiamata.

final String getRequestedAbi ()

Restituisce l'abi richiesto con l'opzione -a o --abi.

getRequiredTokens ()
long getRuntimeHint ()

Restituisce il tempo di esecuzione previsto del test in millisecondi.

File getTestsDir ()
boolean isSplitting ()

Restituisce true se siamo attualmente in IShardableTest.split(int) .

abstract loadTests ()

Metodo astratto per caricare la configurazione dei test che verrà eseguita.

void reportNotExecuted (ITestInvocationListener listener, String message)

Segnala i test non eseguiti al listener principale fornito.

void reportNotExecuted (ITestInvocationListener listener)

Segnala i test non eseguiti al listener principale fornito.

final void run (TestInformation testInfo, ITestInvocationListener listener)

Metodo run generico per tutta la prova caricati da loadTests() .

void setAbiName (String abiName)

Imposta il valore di mAbiName

final void setAbis ( abis) setAbis ( abis)
void setBuild (IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

Esegui la suite di test in modalità solo raccoglitore, questo richiede tutti i sotto-test per implementare anche questa interfaccia.

void setConfiguration ( IConfiguration configuration)

Inietta IConfiguration in uso.

void setDevice (ITestDevice device)

Iniettare il dispositivo in prova.

void setInvocationContext (IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

Prendi il corrente Guice Injector dalla chiamata.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Imposta l'elenco dei IMetricCollector s definiti per l'esecuzione del test.

void setPrimaryAbiRun (boolean primaryAbiRun)

Imposta il valore di mPrimaryAbiRun

void setShouldMakeDynamicModule (boolean dynamicModule)

Quando si esegue lo sharding distribuito, non possiamo avere ModuleDefinition che condivide i test in un pool, altrimenti lo sharding all'interno del modulo non funzionerà, quindi permettiamo di disabilitarlo.

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

Imposta ISystemStatusChecker s dalla configurazione per il test.

void setTestLogger (ITestLogger testLogger)

split (Integer shardCountHint, TestInformation testInfo)

Versione alternativa di split(int) , che fornisce anche un TestInformation che contiene informazioni in anticipo dal genitore creare i cocci.

Metodi protetti

createModuleListeners ()

Restituisce la lista dei ITestInvocationListener applicabile al ModuleListener livello.

boolean filterByConfigMetadata ( IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)

Applica il filtro dei metadati alla configurazione e verifica se la configurazione deve essere eseguita.

boolean filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners)

Applica il filtro della lista bianca Runner, rimuovendo qualsiasi corridore che non era nella whitelist.

getAbisForBuildTargetArch ()

Restituisce l'abis supportato dall'architettura di destinazione della build Host.

getHostAbis ()

Restituisce l'abis della macchina host.

boolean shouldModuleRun ( ModuleDefinition module)

Campi

ABI_OPTION

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

MODULO_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULO_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARER_WHITELIST

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

RANDOM_SEED

public static final String RANDOM_SEED

REBOOT_BEFORE_TEST

public static final String REBOOT_BEFORE_TEST

RUNNER_WHITELIST

public static final String RUNNER_WHITELIST

SKIP_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SKIP_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

Costruttori pubblici

ITestSuite

public ITestSuite ()

Metodi pubblici

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

Parametri
filters MultiMap

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

Parametri
filters MultiMap

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

Imposta reboot-before-test su true.

getAbis

public  getAbis (ITestDevice device)

Ottiene l'insieme di ABI supportato sia compatibilità test AbiUtils.getAbisSupportedByCompatibility() e il dispositivo in prova.

Parametri
device ITestDevice

ritorna
Il set di ABI su cui eseguire i test

tiri
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Restituisce il possibile abis da TestSuiteInfo.

ritorna

getBuildInfo

public IBuildInfo getBuildInfo ()

Attuazione della ITestSuite può richiedere informazioni build per caricare i test.

ritorna
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

Restituisce l'invocazione IConfiguration .

ritorna
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

ritorna
ITestLogger

getDevice

public ITestDevice getDevice ()

Metti il ​​dispositivo in prova.

ritorna
ITestDevice ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Restituisce il ModuleDefinition da eseguire direttamente, oppure null se non ancora (quando l'ITestSuite non è stato ancora sharded).

ritorna
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

Restituisce il contesto di chiamata.

ritorna
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

Restituisce l'abi richiesto con l'opzione -a o --abi.

ritorna
String

getRequiredTokens

public  getRequiredTokens ()

ritorna

getRuntimeHint

public long getRuntimeHint ()

Restituisce il tempo di esecuzione previsto del test in millisecondi. Il tempo viene utilizzato per caricare l'esecuzione partizionata del bilanciamento

ritorna
long

getTestsDir

public File getTestsDir ()

ritorna
File

isSplitting

public boolean isSplitting ()

Restituisce true se siamo attualmente in IShardableTest.split(int) .

ritorna
boolean

test di carico

public abstract  loadTests ()

Metodo astratto per caricare la configurazione dei test che verrà eseguita. Ogni test è definito da IConfiguration e un nome univoco in base al quale riporterà i risultati.

ritorna

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Segnala i test non eseguiti al listener principale fornito. Essi dovrebbero essere segnalati come non riuscito con il NOT_EXECUTED_FAILURE messaggio.

Parametri
listener ITestInvocationListener : l'ascoltatore principale dove per segnalare i risultati non eseguiti.

message String : il messaggio ad essere associato con il fallimento non eseguito.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Segnala i test non eseguiti al listener principale fornito. Essi dovrebbero essere segnalati come non riuscito con il NOT_EXECUTED_FAILURE messaggio.

Parametri
listener ITestInvocationListener : l'ascoltatore principale dove per segnalare i risultati non eseguiti.

correre

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Metodo run generico per tutta la prova caricati da loadTests() .

Parametri
testInfo TestInformation

listener ITestInvocationListener

tiri
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

Imposta il valore di mAbiName

Parametri
abiName String

setAbis

public final void setAbis ( abis)

Parametri
abis

setBuild

public void setBuild (IBuildInfo buildInfo)

Parametri
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Esegui la suite di test in modalità solo raccoglitore, questo richiede tutti i sotto-test per implementare anche questa interfaccia.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inietta IConfiguration in uso.

Parametri
configuration IConfiguration

setDevice

public void setDevice (ITestDevice device)

Iniettare il dispositivo in prova.

Parametri
device ITestDevice : l' ITestDevice per uso

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parametri
invocationContext IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

Prendi il corrente Guice Injector dalla chiamata. Dovrebbe consentirci di continuare l'iniezione di oggetti dei moduli.

Parametri
injector Injector

setMetricCollectors

public void setMetricCollectors ( collectors)

Imposta l'elenco dei IMetricCollector s definiti per l'esecuzione del test.

Parametri
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Imposta il valore di mPrimaryAbiRun

Parametri
primaryAbiRun boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Quando si esegue lo sharding distribuito, non possiamo avere ModuleDefinition che condivide i test in un pool, altrimenti lo sharding all'interno del modulo non funzionerà, quindi permettiamo di disabilitarlo.

Parametri
dynamicModule boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Imposta ISystemStatusChecker s dalla configurazione per il test.

Parametri
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Parametri
testLogger ITestLogger

diviso

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Versione alternativa di split(int) , che fornisce anche un TestInformation che contiene informazioni in anticipo dal genitore creare i cocci. È utile se è necessario accedere a elementi come informazioni sul dispositivo o sulla build durante lo sharding.

Parametri
shardCountHint Integer : il conteggio frammento tentato.

testInfo TestInformation : Il genitore TestInformation

ritorna
un insieme di prove secondarie da eseguire separatamente o null se il test non è attualmente shardable

Metodi protetti

createModuleListeners

protected  createModuleListeners ()

Restituisce la lista dei ITestInvocationListener applicabile al ModuleListener livello. Questi listener verranno riutilizzati per ogni modulo, non verranno istanziati nuovamente, quindi non dovrebbero assumere uno stato interno.

ritorna

filterByConfigMetadata

protected boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

Applica il filtro dei metadati alla configurazione e verifica se la configurazione deve essere eseguita.

Parametri
config IConfiguration : IConfiguration in corso di valutazione.

include MultiMap : i metadati comprendono filtro

exclude MultiMap : il filtro metadati escludere

ritorna
boolean True se il modulo deve essere eseguito, false altrimenti.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Applica il filtro della lista bianca Runner, rimuovendo qualsiasi corridore che non era nella whitelist. Se una configurazione ha diversi corridori, alcuni potrebbero essere rimossi e la configurazione continuerà a essere eseguita.

Parametri
config IConfiguration : IConfiguration in corso di valutazione.

allowedRunners : l'attuale whitelist del corridore.

ritorna
boolean True se il modulo di configurazione può essere eseguito, false in caso contrario.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Restituisce l'abis supportato dall'architettura di destinazione della build Host. Esposto per test.

ritorna

getHostAbis

protected  getHostAbis ()

Restituisce l'abis della macchina host.

ritorna

dovrebbeModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parametri
module ModuleDefinition

ritorna
boolean