ITestSuite

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

java.lang.Oggetto
↳	com.android.tradefed.testtype.suite.ITestSuite

Sottoclassi dirette conosciute BaseTestSuite , TfSuiteRunner BaseTestSuite Un test per eseguire Compatibility Test Suite con il nuovo sistema di suite. TfSuiteRunner Implementazione di ITestSuite che caricherà i test dalla cartella TF jars res/config/suite/.

Sottoclassi indirette conosciute AtestRunner , TestMappingSuiteRunner AtestRunner Implementazione di ITestSuite TestMappingSuiteRunner Implementazione di BaseTestSuite per eseguire i test specificati dall'opzione include-filter o i file TEST_MAPPING dalla build, come una suite.

---

Classe astratta utilizzata per eseguire Test Suite. Questa classe fornisce la base di come verrà eseguita la Suite. Ogni implementazione può definire l'elenco dei test tramite il metodo loadTests() .

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	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)
	getAbis ( ITestDevice device) Ottiene il set di ABI supportati sia dal test di compatibilità AbiUtils.getAbisSupportedByCompatibility() sia dal dispositivo sottoposto a test.
static	getAbisForBuildTargetArchFromSuite () Restituisce il possibile abis da TestSuiteInfo.
IBuildInfo	getBuildInfo () L'implementazione di ITestSuite potrebbe richiedere le informazioni sulla build per caricare i test.
final IConfiguration	getConfiguration () Restituisce la chiamata IConfiguration .
ITestLogger	getCurrentTestLogger ()
ITestDevice	getDevice () Ottieni il dispositivo in prova.
ModuleDefinition	getDirectModule () Restituisce ModuleDefinition da eseguire direttamente o null se ancora non esiste (quando ITestSuite non è stato ancora partizionato).
IInvocationContext	getInvocationContext () Restituisce il contesto di chiamata.
MultiMap <String, String>	getModuleMetadataIncludeFilters ()
final String	getRequestedAbi () Restituisce l'abi richiesto con l'opzione -a o --abi.
	getRequiredTokens ( TestInformation testInfo) Restituisce l'elenco dei token richiesti dal test.
long	getRuntimeHint () Restituisce il runtime previsto del test in millisecondi.
File	getTestsDir ()
boolean	isSplitting () Restituisce true se ci troviamo attualmente in IShardableTest.split(int) .
abstract	loadTests () Metodo astratto per caricare la configurazione dei test che verranno eseguiti.
void	reportNotExecuted ( ITestInvocationListener listener, String message) Segnala i test non eseguiti all'ascoltatore principale fornito.
void	reportNotExecuted ( ITestInvocationListener listener) Segnala i test non eseguiti all'ascoltatore principale fornito.
final void	run ( TestInformation testInfo, ITestInvocationListener listener) Metodo run generico per tutti i test caricati da loadTests() .
void	setAbiName (String abiName) Impostare 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 che tutti i test secondari implementino anche questa interfaccia.
void	setConfiguration ( IConfiguration configuration) Inietta l' IConfiguration in uso.
void	setDevice ( ITestDevice device) Iniettare il dispositivo in esame.
void	setDirectModule ( ModuleDefinition module)
void	setInvocationContext ( IInvocationContext invocationContext)
void	setMetricCollectors ( collectors) setMetricCollectors ( collectors) Imposta l'elenco di IMetricCollector 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 è possibile avere ModuleDefinition che condivide i test in un pool, altrimenti lo sharding all'interno del modulo non funzionerà, quindi è consentito disabilitarlo.
void	setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers) Imposta ISystemStatusChecker dalla configurazione per il test.
void	setTestLogger ( ITestLogger testLogger) Inietta l'istanza ITestLogger
	split (Integer shardCountHint, TestInformation testInfo) Versione alternativa di split(int) che fornisce anche un TestInformation che contiene le prime informazioni dal genitore che crea i frammenti.

Metodi protetti
	createModuleListeners () Restituisce l'elenco di ITestInvocationListener applicabile al livello ModuleListener .
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) Applicare il filtro della lista bianca dei corridori, rimuovendo tutti i corridori che non sono stati inseriti nella lista bianca.
	getAbisForBuildTargetArch () Restituisce l'abis supportato dall'architettura di destinazione della build dell'host.
	getHostAbis () Restituisce l'abis della macchina host.
void	setMultiDeviceStrategy ( ITestSuite.MultiDeviceModuleStrategy strategy)
boolean	shouldModuleRun ( ModuleDefinition module)

Campi

ABI_OPZIONE

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

PARAMETRO_CHIAVE

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

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

getAbis

public  getAbis (ITestDevice device)

Ottiene il set di ABI supportati sia dal test di compatibilità AbiUtils.getAbisSupportedByCompatibility() sia dal dispositivo sottoposto a test.

Parametri
device	ITestDevice

ritorna
	Il set di ABI su cui eseguire i test

Getta
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Restituisce il possibile abis da TestSuiteInfo.

ritorna

getBuildInfo

public IBuildInfo getBuildInfo ()

L'implementazione di ITestSuite potrebbe richiedere le informazioni sulla build per caricare i test.

ritorna
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

Restituisce la chiamata IConfiguration .

ritorna
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

ritorna
ITestLogger

getDispositivo

public ITestDevice getDevice ()

Ottieni il dispositivo in prova.

ritorna
ITestDevice	il ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Restituisce ModuleDefinition da eseguire direttamente o null se ancora non esiste (quando ITestSuite non è stato ancora partizionato).

ritorna
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

Restituisce il contesto di chiamata.

ritorna
IInvocationContext

getModuleMetadataIncludeFilters

public MultiMap<String, String> getModuleMetadataIncludeFilters ()

ritorna
MultiMap <String, String>

getRequestedAbi

public final String getRequestedAbi ()

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

ritorna
String

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

Restituisce l'elenco dei token richiesti dal test. Restituisce null se nessun supporto token.

Parametri
testInfo	TestInformation

ritorna

getRuntimeHint

public long getRuntimeHint ()

Restituisce il runtime previsto del test in millisecondi. Il tempo viene utilizzato per bilanciare il carico dell'esecuzione partizionata

ritorna
long

getTestsDir

public File getTestsDir ()

ritorna
File

isSplitting

public boolean isSplitting ()

Restituisce true se ci troviamo attualmente in IShardableTest.split(int) .

ritorna
boolean

loadTest

public abstract  loadTests ()

Metodo astratto per caricare la configurazione dei test che verranno eseguiti. Ogni test è definito da una IConfiguration e da un nome univoco sotto il quale riporterà i risultati.

ritorna

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Segnala i test non eseguiti all'ascoltatore principale fornito. Dovrebbero essere segnalati come non riusciti con il messaggio NOT_EXECUTED_FAILURE .

Parametri
listener	ITestInvocationListener : il principale listener dove riportare i risultati non eseguiti.
message	String : il messaggio da associare all'errore non eseguito.

reportNotExecuted

public void reportNotExecuted (ITestInvocationListener listener)

Segnala i test non eseguiti all'ascoltatore principale fornito. Dovrebbero essere segnalati come non riusciti con il messaggio NOT_EXECUTED_FAILURE .

Parametri
listener	ITestInvocationListener : il principale listener dove riportare i risultati non eseguiti.

correre

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Metodo run generico per tutti i test caricati da loadTests() .

Parametri
testInfo	TestInformation : l'oggetto TestInformation contenente informazioni utili per eseguire i test.
listener	ITestInvocationListener : ITestInvocationListener dei risultati del test

Getta
DeviceNotAvailableException

setAbiNome

public void setAbiName (String abiName)

Impostare 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 che tutti i test secondari implementino anche questa interfaccia.

setConfigurazione

public void setConfiguration (IConfiguration configuration)

Inietta l' IConfiguration in uso.

Parametri
configuration	IConfiguration

setDispositivo

public void setDevice (ITestDevice device)

Iniettare il dispositivo in esame.

Parametri
device	ITestDevice : l' ITestDevice da usare

setDirectModule

public void setDirectModule (ModuleDefinition module)

Parametri
module	ModuleDefinition

setInvocazioneContesto

public void setInvocationContext (IInvocationContext invocationContext)

Parametri
invocationContext	IInvocationContext

setMetricCollectors

public void setMetricCollectors ( collectors)

Imposta l'elenco di IMetricCollector 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 è possibile avere ModuleDefinition che condivide i test in un pool, altrimenti lo sharding all'interno del modulo non funzionerà, quindi è consentito disabilitarlo.

Parametri
dynamicModule	boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Imposta ISystemStatusChecker dalla configurazione per il test.

Parametri
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Inietta l'istanza ITestLogger

Parametri
testLogger	ITestLogger

diviso

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Versione alternativa di split(int) che fornisce anche un TestInformation che contiene le prime informazioni dal genitore che crea i frammenti. È utile se è necessario accedere a cose come informazioni sul dispositivo o sulla build durante lo sharding.

Parametri
shardCountHint	Integer : il numero di shard tentato.
testInfo	TestInformation : l'oggetto TestInformation padre

ritorna
	una raccolta di sottotest da eseguire separatamente o null se il test non è attualmente partizionabile

Metodi protetti

createModuleListeners

protected  createModuleListeners ()

Restituisce l'elenco di ITestInvocationListener applicabile al livello ModuleListener . Questi ascoltatori verranno riutilizzati per ogni modulo, non verranno ri-istanziati quindi non dovrebbero assumere uno stato interno.

ritorna

filterByConfigMetadata

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

Applicare il filtro dei metadati alla configurazione e verificare se la configurazione deve essere eseguita.

Parametri
config	IConfiguration : l' IConfiguration valutato.
include	MultiMap : i metadati includono il filtro
exclude	MultiMap : il filtro di esclusione dei metadati

ritorna
boolean	True se il modulo deve essere eseguito, false in caso contrario.

filterByRunnerType

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Applicare il filtro della lista bianca dei corridori, rimuovendo tutti i corridori che non sono stati inseriti nella lista bianca. Se una configurazione ha più programmi di esecuzione, alcuni potrebbero essere rimossi e la configurazione continuerà a funzionare.

Parametri
config	IConfiguration : l' IConfiguration valutato.
allowedRunners	: l'attuale lista bianca 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 dell'host. Esposto per il test.

ritorna

getHostAbis

protected  getHostAbis ()

Restituisce l'abis della macchina host.

ritorna

setStrategia multidispositivo

protected void setMultiDeviceStrategy (ITestSuite.MultiDeviceModuleStrategy strategy)

Parametri
strategy	ITestSuite.MultiDeviceModuleStrategy

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parametri
module	ModuleDefinition

ritorna
boolean