GTestBase

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

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

Classi di sottoclasse dirette note 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.

Classi di sottoclasse indirette note ArtGTest ArtGTest

---

La classe di 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) Aggiunge il ERROR(/Set) dei filtri di cui escludere i test.
void	addAllIncludeFilters( filters) Aggiunge il ERROR(/Set) dei filtri di cui includere i test.
void	addExcludeFilter(String filter) Aggiunge un filtro per i test da escludere.
void	addIncludeFilter(String filter) Aggiunge un filtro per i test da 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() Recupera i comandi shell da eseguire dopo GTest.
	getBeforeTestCmd() Recupera i comandi shell da eseguire prima di GTest.
	getExcludeFilters() Restituisce l'ERROR(/Set) corrente dei filtri di esclusione.
	getFileExclusionFilterRegex() Recupera la regex per escludere l'esecuzione di determinati file.
	getGTestFlags() Recupera i valori dei flag aggiuntivi da passare al comando shell del test nativo.
	getIncludeFilters() Restituisce l'ERROR(/Set) corrente dei filtri di inclusione.
long	getMaxTestTimeMs() Restituisce il tempo massimo per l'esecuzione di un gtest.
String	getModuleName() Esegui il modulo di test nativo per Android.
boolean	getRunDisabledTests() Indica se GTest deve eseguire i test disattivati.
long	getRuntimeHint() Restituisce il tempo di esecuzione previsto del test in millisecondi.
int	getShardCount() Restituisce il numero di shard corrente.
int	getShardIndex() Recupera l'indice del frammento di questo test.
String	getTestFilterKey() Recupera la chiave del filtro di test.
String	getTestModule() Recupera il nome del modulo.
boolean	isCollectTestsOnly() Consente di eseguire solo l'invoke del file binario di test per raccogliere l'elenco dei casi di test applicabili o meno.
boolean	isEnableXmlOutput() Indica se utilizzare o meno l'output XML di gtest per i risultati dei test.
boolean	isSharded() Recupera il flag isSharded.
void	notifyTestExecution(boolean incompleteTestFound, failedTests) Avvisa il proprietario dell'esecuzione del test, in modo che i filtri di inclusione/esclusione possano essere gestiti correttamente per i tentativi di nuovo esecuzione.
void	setAbi(IAbi abi)
void	setCollectTestsOnly(boolean shouldCollectTest) Attiva o disattiva la modalità di raccolta dei test
void	setConfiguration(IConfiguration configuration) Invia il IConfiguration in uso.
void	setModuleName(String moduleName) Imposta l'esecuzione del modulo di test nativo Android.
void	setShardCount(int shardCount) Imposta il numero di shard di questo test.
void	setShardIndex(int shardIndex) Imposta l'indice del frammento di questo test.
	split(int shardCountHint) Versione alternativa di split() che fornisce anche il valore shardCount che si tenta di eseguire.

Metodi protetti
String	convertName(String gtestFlagName)
String	createFlagFile(String filter) Crea un file contenente i filtri che verranno utilizzati tramite --gtest_flagfile per evitare eventuali limitazioni del sistema operativo per le dimensioni degli argomenti.
void	erasePrependedFileName( filters, String filename)
String	getAllGTestFlags(String path) Helper per ottenere tutti i flag GTest da passare al comando adb shell.
IConfiguration	getConfiguration() Restituisce la configurazione del test.
String	getExceptionMessage(Exception e) Fai del tuo meglio per recuperare un messaggio descrittivo breve e significativo per un determinato 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 eseguire il wrapping del comando gtest in un altro strumento (chroot, strace, gdb e simili).
String	getGTestFilters(String path) Funzione di supporto per ottenere il filtro del test g-test da eseguire.
ITestInvocationListener	getGTestListener(ITestInvocationListener... listeners) Restituisce GTestListener che fornisce informazioni di debug aggiuntive, ad esempio rileva e segnala i test duplicati se mDisabledDuplicateCheck è false.
abstract String	loadFilter(String path) Definisci il metodo di filtro get.
void	setRunDisabled(boolean runDisabled) Imposta se GTest deve eseguire i test disattivati.

Campi

FILTER_EXTENSION

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

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Aggiunge il ERROR(/Set) dei filtri di cui escludere i test.

Parametri
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Aggiunge il ERROR(/Set) dei filtri di cui includere i test.

Parametri
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Aggiunge un filtro per i test da escludere.

Parametri
filter	String

addIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro per i test da includere.

Parametri
filter	String

cleanFilter

public String cleanFilter (String filter)

Parametri
filter	String

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

Ritorni
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

Recupera i comandi shell da eseguire dopo GTest.

Ritorni

getBeforeTestCmd

public  getBeforeTestCmd ()

Recupera i comandi shell da eseguire prima di GTest.

Ritorni

getExcludeFilters

public  getExcludeFilters ()

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

Ritorni

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Recupera la regex per escludere l'esecuzione di determinati file.

Ritorni

getGTestFlags

public  getGTestFlags ()

Recupera i valori dei flag aggiuntivi da passare al comando shell del test nativo.

Ritorni

getIncludeFilters

public  getIncludeFilters ()

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

Ritorni

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Restituisce il tempo massimo per l'esecuzione di un gtest.

Ritorni
long

getModuleName

public String getModuleName ()

Esegui il modulo di test nativo per Android.

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

getRunDisabledTests

public boolean getRunDisabledTests ()

Indica se GTest deve eseguire i test disattivati.

Ritorni
boolean	Vero se devono essere eseguiti i test disattivati, falso in caso contrario

getRuntimeHint

public long getRuntimeHint ()

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

Ritorni
long

getShardCount

public int getShardCount ()

Restituisce il numero di shard corrente.

Ritorni
int

getShardIndex

public int getShardIndex ()

Recupera l'indice del frammento di questo test.

Ritorni
int

getTestFilterKey

public String getTestFilterKey ()

Recupera la chiave del filtro di test.

Ritorni
String

getTestModule

public String getTestModule ()

Recupera il nome del modulo.

Ritorni
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Consente di eseguire o meno l'istruzione di chiamata del file binario di test per raccogliere l'elenco dei casi di test applicabili.

Ritorni
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Indica se utilizzare o meno l'output XML di gtest per i risultati dei test.

Ritorni
boolean

isSharded

public boolean isSharded ()

Recupera il flag isSharded.

Ritorni
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Avvisa il proprietario dell'esecuzione del test, in modo che i filtri di inclusione/esclusione possano essere gestiti correttamente per i tentativi di nuovo esecuzione.

Parametri
incompleteTestFound	boolean
failedTests

setAbi

public void setAbi (IAbi abi)

Parametri
abi	IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Attiva o disattiva la modalità di raccolta dei test

setConfiguration

public void setConfiguration (IConfiguration configuration)

Invia il IConfiguration in uso.

Parametri
configuration	IConfiguration

setModuleName

public void setModuleName (String moduleName)

Imposta l'esecuzione del modulo di test nativo Android.

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

setShardCount

public void setShardCount (int shardCount)

Imposta il numero di shard di questo test.

Parametri
shardCount	int

setShardIndex

public void setShardIndex (int shardIndex)

Imposta l'indice del frammento di questo test.

Parametri
shardIndex	int

suddivisione

public  split (int shardCountHint)

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

Parametri
shardCountHint	int: il numero di tentativi di shard.

Ritorni
	una raccolta di sottotesti da eseguire separatamente o null se il test non è attualmente suddivisibile in parti

Metodi protetti

convertName

protected String convertName (String gtestFlagName)

Parametri
gtestFlagName	String

Ritorni
String

createFlagFile

protected String createFlagFile (String filter)

Crea un file contenente i filtri che verranno utilizzati tramite --gtest_flagfile per evitare eventuali limitazioni del sistema operativo per le dimensioni degli argomenti.

Parametri
filter	String: la stringa del filtro

Ritorni
String	Il percorso del file contenente il filtro.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parametri
filters
filename	String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Helper per ottenere tutti i flag GTest da passare al comando adb shell.

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

Ritorni
String	il String di tutti i flag GTest da passare a GTest

Lanci
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

Restituisce la configurazione del test.

Ritorni
IConfiguration	un'istanza di IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Fai del tuo meglio per recuperare un messaggio descrittivo breve e significativo per un determinato Exception

Parametri
e	Exception: il Exception

Ritorni
String	un messaggio breve

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Metodo di supporto per creare il comando gtest da eseguire.

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

Ritorni
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 eseguire il wrapping del comando gtest in un altro strumento (chroot, strace, gdb e simili).

Parametri
fullPath	String
flags	String

Ritorni
String

getGTestFilters

protected String getGTestFilters (String path)

Funzione di supporto per ottenere il filtro del test g-test da eseguire.

Tieni presente che i filtri vengono applicati solo al nome della funzione (ad es. Test di Google "Test"); verranno presi in considerazione tutti i "Test case" di Test di Google.

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

Ritorni
String	il flag del filtro completo da passare al test G oppure una stringa vuota se non ne sono stati specificati

Lanci
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Restituisce GTestListener che fornisce informazioni di debug aggiuntive, ad esempio rileva e segnala i test duplicati se mDisabledDuplicateCheck è false. In caso contrario, restituisce l'ascoltatore passato.

Parametri
listeners	ITestInvocationListener

Ritorni
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Definisci il metodo di filtro get.

La sottoclasse deve implementare la modalità di ottenimento del proprio filtro.

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

Ritorni
String	stringa filtro.

Lanci
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Imposta se GTest deve eseguire i test disattivati.

Parametri
runDisabled	boolean