GTestBase

public abstract class GTestBase
extends Object implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver

java.lang.Object
↳	com.android.tradefed.testtype.GTestBase

Sottoclassi dirette conosciute GTest , HostGTest GTest Un test che esegue un pacchetto di test nativo su un determinato dispositivo. HostGTest Un test che esegue un pacchetto di test nativo.

Sottoclassi indirette conosciute ArtGTest ArtGTest

---

La classe base di gTest

Riepilogo

Campi
protected static final String	FILTER_EXTENSION
protected static final String	GTEST_FLAG_FILE
protected static final String	GTEST_FLAG_FILTER
protected static final String	GTEST_FLAG_LIST_TESTS
protected static final String	GTEST_FLAG_PRINT_TIME
protected static final String	GTEST_FLAG_RUN_DISABLED_TESTS
protected static final String	GTEST_XML_OUTPUT

Costruttori pubblici
GTestBase ()

Metodi pubblici
void	addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) Aggiunge l' ERROR(/Set) dei filtri di quali test escludere.
void	addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Aggiunge l' ERROR(/Set) dei filtri di quali test includere.
void	addExcludeFilter (String filter) Aggiunge un filtro su quali test escludere.
void	addIncludeFilter (String filter) Aggiunge un filtro su quali test includere.
String	cleanFilter (String filter)
void	clearExcludeFilters () Elimina tutti i filtri di esclusione attualmente monitorati.
void	clearIncludeFilters () Elimina tutti i filtri di inclusione attualmente monitorati.
IAbi	getAbi ()
	getAfterTestCmd () Ottiene i comandi della shell da eseguire dopo GTest.
	getBeforeTestCmd () Ottiene i comandi della shell da eseguire prima di GTest.
	getExcludeFilters () Restituisce l' ERROR(/Set) corrente dei filtri di esclusione.
	getFileExclusionFilterRegex () Ottiene la regex per escludere determinati file dall'esecuzione.
	getGTestFlags () Ottiene valori di flag aggiuntivi da passare al comando shell del test nativo.
	getIncludeFilters () Restituisce l' ERROR(/Set) corrente dei filtri di inclusione.
long	getMaxTestTimeMs () Ottiene il tempo massimo necessario per l'esecuzione di un gtest.
String	getModuleName () Ottieni l'esecuzione del modulo di test nativo di Android.
boolean	getRunDisabledTests () Scopri se GTest deve eseguire test disabilitati.
long	getRuntimeHint () Restituisce il tempo di esecuzione previsto del test in millisecondi.
int	getShardCount () Restituisce il conteggio dei frammenti corrente.
int	getShardIndex () Ottiene l'indice shard di questo test.
String	getTestFilterKey () Ottiene la chiave del filtro di prova.
String	getTestModule () Ottiene il nome del modulo.
boolean	isCollectTestsOnly () Ottiene solo richiamare il file binario di test per raccogliere o meno l'elenco dei casi di test applicabili.
boolean	isEnableXmlOutput () Ottiene o meno l'utilizzo dell'output gtest xml per i risultati del test.
boolean	isSharded () Ottiene il flag isSharded.
void	notifyTestExecution (boolean incompleteTestFound, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests) Notifica al genitore dell'esecuzione del test, in modo che i filtri di inclusione/esclusione possano essere gestiti correttamente per i tentativi di ripetizione.
void	setAbi ( IAbi abi)
void	setCollectTestsOnly (boolean shouldCollectTest) Abilita o disabilita la modalità di raccolta dei test
void	setConfiguration ( IConfiguration configuration) Inietta la IConfiguration in uso.
void	setModuleName (String moduleName) Imposta il modulo di test nativo di Android per l'esecuzione.
void	setShardCount (int shardCount) Imposta il conteggio dei frammenti di questo test.
void	setShardIndex (int shardIndex) Imposta l'indice shard di questo test.
	split (int shardCountHint) Versione alternativa di split() che fornisce anche lo shardCount che si tenta di eseguire.

Metodi protetti
String	createFlagFile (String filter) Crea un file contenente i filtri che verranno utilizzati tramite --gtest_flagfile per evitare qualsiasi limitazione del sistema operativo nella dimensione degli argomenti.
void	erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename)
String	getAllGTestFlags (String path) Aiutante per ottenere tutti i flag GTest da passare nel comando adb shell.
IConfiguration	getConfiguration () Restituisce la configurazione di prova.
String	getExceptionMessage (Exception e) Fare del proprio meglio per recuperare un breve messaggio descrittivo significativo per una determinata Exception
String	getGTestCmdLine (String fullPath, String flags) Metodo di supporto per creare il comando gtest da eseguire.
String	getGTestCmdLineWrapper (String fullPath, String flags) Helper che consente alle classi derivate di racchiudere il comando gtest in qualche altro strumento (chroot, strace, gdb e simili).
String	getGTestFilters (String path) Aiutante per far funzionare il filtro g-test del test.
ITestInvocationListener	getGTestListener ( ITestInvocationListener listener) Restituisce GTestListener che fornisce informazioni di debug aggiuntive, come rileva e segnala test duplicati se mDisabledDuplicateCheck è falso.
abstract String	loadFilter (String path) Definire il metodo di filtro Get.
void	setRunDisabled (boolean runDisabled) Imposta se GTest deve eseguire test disabilitati.

Campi

FILTER_ESTENSIONE

protected static final String FILTER_EXTENSION

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Costruttori pubblici

GTestBase

public GTestBase ()

Metodi pubblici

aggiungiAllExcludeFilters

public void addAllExcludeFilters ( filters)

Aggiunge l' ERROR(/Set) dei filtri di quali test escludere.

Parametri
filters

aggiungiAllIncludeFilters

public void addAllIncludeFilters ( filters)

Aggiunge l' ERROR(/Set) dei filtri di quali test includere.

Parametri
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Aggiunge un filtro su quali test escludere.

Parametri
filter	String

aggiungiIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro su quali test includere.

Parametri
filter	String

cleanFilter

public String cleanFilter (String filter)

Parametri
filter	String

ritorna
String

clearExcludeFilters

public void clearExcludeFilters ()

Elimina tutti i filtri di esclusione attualmente monitorati.

clearIncludeFilters

public void clearIncludeFilters ()

Elimina tutti i filtri di inclusione attualmente monitorati.

getAbi

public IAbi getAbi ()

ritorna
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

Ottiene i comandi della shell da eseguire dopo GTest.

ritorna

getBeforeTestCmd

public  getBeforeTestCmd ()

Ottiene i comandi della shell da eseguire prima di GTest.

ritorna

getExcludeFilters

public  getExcludeFilters ()

Restituisce l' ERROR(/Set) corrente dei filtri di esclusione.

ritorna

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Ottiene la regex per escludere determinati file dall'esecuzione.

ritorna

getGTestFlags

public  getGTestFlags ()

Ottiene valori di flag aggiuntivi da passare al comando shell del test nativo.

ritorna

getIncludeFilters

public  getIncludeFilters ()

Restituisce l' ERROR(/Set) corrente dei filtri di inclusione.

ritorna

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Ottiene il tempo massimo necessario per l'esecuzione di un gtest.

ritorna
long

getModuloNome

public String getModuleName ()

Ottieni l'esecuzione del modulo di test nativo di Android.

ritorna
String	il nome del modulo di test nativo da eseguire o null se non impostato

getRunDisabledTests

public boolean getRunDisabledTests ()

Scopri se GTest deve eseguire test disabilitati.

ritorna
boolean	Vero se devono essere eseguiti i test disabilitati, falso altrimenti

getRuntimeHint

public long getRuntimeHint ()

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

ritorna
long

getShardCount

public int getShardCount ()

Restituisce il conteggio dei frammenti corrente.

ritorna
int

getShardIndex

public int getShardIndex ()

Ottiene l'indice shard di questo test.

ritorna
int

getTestFilterKey

public String getTestFilterKey ()

Ottiene la chiave del filtro di prova.

ritorna
String

getModuloTest

public String getTestModule ()

Ottiene il nome del modulo.

ritorna
String

èCollectTestsOnly

public boolean isCollectTestsOnly ()

Ottiene solo richiamare il file binario di test per raccogliere o meno l'elenco dei casi di test applicabili.

ritorna
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Ottiene o meno l'utilizzo dell'output gtest xml per i risultati del test.

ritorna
boolean

isSharded

public boolean isSharded ()

Ottiene il flag isSharded.

ritorna
boolean

notificaTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Notifica al genitore dell'esecuzione del test, in modo che i filtri di inclusione/esclusione possano essere gestiti correttamente per i tentativi di ripetizione.

Parametri
incompleteTestFound	boolean
failedTests

setAbi

public void setAbi (IAbi abi)

Parametri
abi	IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Abilita o disabilita la modalità di raccolta dei test

setConfigurazione

public void setConfiguration (IConfiguration configuration)

Inietta la IConfiguration in uso.

Parametri
configuration	IConfiguration

setNomeModulo

public void setModuleName (String moduleName)

Imposta il modulo di test nativo di Android per l'esecuzione.

Parametri
moduleName	String : il nome del modulo di test nativo da eseguire

setShardCount

public void setShardCount (int shardCount)

Imposta il conteggio dei frammenti di questo test.

Parametri
shardCount	int

setShardIndex

public void setShardIndex (int shardIndex)

Imposta l'indice shard di questo test.

Parametri
shardIndex	int

diviso

public  split (int shardCountHint)

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

Parametri
shardCountHint	int : il conteggio dei frammenti tentati.

ritorna
	una raccolta di test secondari da eseguire separatamente o null se il test non è attualmente frammentabile

Metodi protetti

createFlagFile

protected String createFlagFile (String filter)

Crea un file contenente i filtri che verranno utilizzati tramite --gtest_flagfile per evitare qualsiasi limitazione del sistema operativo nella dimensione degli argomenti.

Parametri
filter	String : la stringa del filtro

ritorna
String	Il percorso del file contenente il filtro.

Lancia
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parametri
filters
filename	String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Aiutante per ottenere tutti i flag GTest da passare nel comando adb shell.

Parametri
path	String : il percorso completo del file binario sul dispositivo.

ritorna
String	la String di tutti i flag GTest che dovrebbero essere passati a GTest

Lancia
DeviceNotAvailableException

getConfigurazione

protected IConfiguration getConfiguration ()

Restituisce la configurazione di prova.

ritorna
IConfiguration	una IConfigurazione

getExceptionMessage

protected String getExceptionMessage (Exception e)

Fare del proprio meglio per recuperare un breve messaggio descrittivo significativo per una determinata Exception

Parametri
e	Exception : l' Exception

ritorna
String	un breve messaggio

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Metodo di supporto per creare il comando gtest da eseguire.

Parametri
fullPath	String : percorso assoluto del file system per il binario gtest sul dispositivo
flags	String : flag di esecuzione gtest

ritorna
String	la riga di comando della shell da eseguire per gtest

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Helper che consente alle classi derivate di racchiudere il comando gtest in qualche altro strumento (chroot, strace, gdb e simili).

Parametri
fullPath	String
flags	String

ritorna
String

getGTestFilters

protected String getGTestFilters (String path)

Aiutante per far funzionare il filtro g-test del test.

Tieni presente che i filtri filtrano solo in base al nome della funzione (es: Google Test "Test"); verranno presi in considerazione tutti i "Test Case" di Google Test.

Parametri
path	String : il percorso completo del file binario sul dispositivo.

ritorna
String	il flag di filtro completo da passare al g-test o una stringa vuota se non ne è stato specificato nessuno

Lancia
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

Restituisce GTestListener che fornisce informazioni di debug aggiuntive, come rileva e segnala test duplicati se mDisabledDuplicateCheck è falso. In caso contrario, restituisce il listener passato.

Parametri
listener	ITestInvocationListener

ritorna
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Definire il metodo di filtro Get.

La sottoclasse deve implementare come ottenere il proprio filtro.

Parametri
path	String : il percorso completo del file di filtro.

ritorna
String	stringa di filtro.

Lancia
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Imposta se GTest deve eseguire test disabilitati.

Parametri
runDisabled	boolean