Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

ITestSuite

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

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


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() .

Sommario

Classi nidificate

enum ITestSuite.RetryStrategy

La strategia dei tentativi da utilizzare quando si rieseguono alcuni test.

campi

public static final String ABI_OPTION

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 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 supportato sia dal test di compatibilità AbiUtils#getAbisSupportedByCompatibility() che dal dispositivo in prova.

IBuildInfo getBuildInfo ()

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

ITestDevice getDevice ()

Metti il ​​dispositivo in prova.

ModuleDefinition getDirectModule ()

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

final String getRequestedAbi ()

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

getRequiredTokens ()

Restituisce l'elenco dei token richiesti dal test.

long getRuntimeHint ()

Restituisce il runtime previsto del test in millisecondi.

abstract loadTests ()

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

void reportNotExecuted ( ITestInvocationListener listener, String message)

Riporta i test non eseguiti al listener principale fornito.

void reportNotExecuted ( ITestInvocationListener listener)

Riporta i test non eseguiti al listener principale fornito.

final void run ( ITestInvocationListener listener)

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

void setAbiName (String abiName)

Imposta il valore di mAbiName

void setBuild ( IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

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

void setConfiguration ( IConfiguration configuration)

Inietta la IConfiguration in uso.

void setDevice ( ITestDevice device)

Iniettare il dispositivo in prova.

void setDeviceInfos ( deviceInfos) setDeviceInfos ( deviceInfos)

void setInvocationContext ( IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

Ottieni l'attuale Guice Injector dall'invocazione.

final void setMaxRunLimit (int maxRunLimit)

Imposta il numero massimo di tentativi di esecuzione per ciascun modulo.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Imposta l'elenco di IMetricCollector definito 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 intra-modulo non funzionerà, quindi consentiamo di disabilitarlo.

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

Imposta ISystemStatusChecker dalla configurazione per il test.

split (int shardCountHint)

Versione alternativa di split() che fornisce anche lo shardCount che si tenta di eseguire.

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 metadati alla configurazione e verifica se la configurazione deve essere eseguita.

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

Applicare il filtro della whitelist Runner, rimuovendo tutti i runner che non sono stati autorizzati.

getAbisForBuildTargetArch ()

Restituisce l'abis supportato dall'architettura di destinazione build host.

getHostAbis ()

Restituisce l'abis della macchina host.

campi

ABI_OPTION

public static final String ABI_OPTION

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_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

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 supportato sia dal test di compatibilità AbiUtils#getAbisSupportedByCompatibility() che dal dispositivo in prova.

parametri
device ITestDevice

ritorna
L'insieme di ABI su cui eseguire i test

Genera
DeviceNotAvailableException

getBuildInfo

public IBuildInfo getBuildInfo ()

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

ritorna
IBuildInfo

GetDevice

public ITestDevice getDevice ()

Metti il ​​dispositivo in prova.

ritorna
ITestDevice il ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

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

ritorna
ModuleDefinition

getRequestedAbi

public final String getRequestedAbi ()

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

ritorna
String

getRequiredTokens

public  getRequiredTokens ()

Restituisce l'elenco dei token richiesti dal test. Restituisce null se non è supportato alcun token.

ritorna

getRuntimeHint

public long getRuntimeHint ()

Restituisce il runtime previsto del test in millisecondi. Il tempo viene utilizzato per caricare il bilanciamento dell'esecuzione frammentata

ritorna
long

loadTests

public abstract  loadTests ()

Metodo astratto per caricare la configurazione di test che verrà eseguita. Ogni test è definito da una IConfiguration e da un nome univoco con il quale riporterà i risultati.

ritorna

reportNotExecuted

public void reportNotExecuted ( ITestInvocationListener listener, 
                String message)

Riporta i test non eseguiti al listener principale fornito. Dovrebbero essere segnalati come non riusciti con il messaggio NOT_EXECUTED_FAILURE .

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

message String : il messaggio da associare all'errore non eseguito.

reportNotExecuted

public void reportNotExecuted ( ITestInvocationListener listener)

Riporta i test non eseguiti al listener principale fornito. Dovrebbero essere segnalati come non riusciti con il messaggio NOT_EXECUTED_FAILURE .

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

correre

public final void run ( ITestInvocationListener listener)

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

parametri
listener ITestInvocationListener : ITestInvocationListener dei risultati del test

Genera
DeviceNotAvailableException

setAbiName

public void setAbiName (String abiName)

Imposta il valore di mAbiName

parametri
abiName String

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 sotto-test implementino anche questa interfaccia.

setConfiguration

public void setConfiguration ( IConfiguration configuration)

Inietta la IConfiguration in uso.

parametri
configuration IConfiguration

setDevice

public void setDevice ( ITestDevice device)

Iniettare il dispositivo in prova.

parametri
device ITestDevice : ITestDevice da utilizzare

setDeviceInfos

public void setDeviceInfos ( deviceInfos)

parametri
deviceInfos

setInvocationContext

public void setInvocationContext ( IInvocationContext invocationContext)

parametri
invocationContext IInvocationContext

setInvocationInjector

public void setInvocationInjector (Injector injector)

Ottieni l'attuale Guice Injector dall'invocazione. Dovrebbe consentirci di continuare l'iniezione di oggetti dei moduli.

parametri
injector Injector

setMaxRunLimit

public final void setMaxRunLimit (int maxRunLimit)

Imposta il numero massimo di tentativi di esecuzione per ciascun modulo.

parametri
maxRunLimit int

setMetricCollectors

public void setMetricCollectors ( collectors)

Imposta l'elenco di IMetricCollector definito 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 intra-modulo non funzionerà, quindi consentiamo di disabilitarlo.

parametri
dynamicModule boolean

setSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Imposta gli ISystemStatusChecker dalla configurazione per il test.

parametri
systemCheckers

Diviso

public  split (int shardCountHint)

Versione alternativa di split() che fornisce anche lo shardCount che si tenta di eseguire. Questo è utile per alcuni runner che a volte non possono decidere arbitrariamente.

parametri
shardCountHint int : il tentativo di conteggio dei frammenti.

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

Metodi protetti

createModuleListeners

protected  createModuleListeners ()

Restituisce l'elenco di ITestInvocationListener applicabile al livello ModuleListener . Questi listener verranno riutilizzati per ciascun 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)

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

parametri
config IConfiguration : IConfiguration fase di valutazione.

include MultiMap : i metadati includono il filtro

exclude MultiMap : i metadati escludono il filtro

ritorna
boolean Vero se il modulo deve essere eseguito, falso altrimenti.

filterByRunnerType

protected boolean filterByRunnerType ( IConfiguration config, 
                 allowedRunners)

Applicare il filtro della whitelist Runner, rimuovendo tutti i runner che non sono stati autorizzati. Se una configurazione ha diversi corridori, alcuni potrebbero essere rimossi e la configurazione continuerà.

parametri
config IConfiguration : IConfiguration fase di valutazione.

allowedRunners : La lista bianca dei corridori correnti.

ritorna
boolean Vero se il modulo di configurazione è autorizzato a funzionare, falso altrimenti.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Restituisce l'abis supportato dall'architettura di destinazione build host. Esposto per i test.

ritorna

getHostAbis

protected  getHostAbis ()

Restituisce l'abis della macchina host.

ritorna