GTestBase

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

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


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) di filtri da cui escludere i test.

void addAllIncludeFilters ( filters) addAllIncludeFilters ( filters)

Aggiunge l' ERROR(/Set) di filtri di cui includere i test.

void addExcludeFilter (String filter)

Aggiunge un filtro di quali test escludere.

void addIncludeFilter (String filter)

Aggiunge un filtro di 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'attuale ERROR(/Set) dei filtri di esclusione.

getFileExclusionFilterRegex ()

Ottiene regex per escludere determinati file dall'esecuzione.

getGTestFlags ()

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

getIncludeFilters ()

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

long getMaxTestTimeMs ()

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

String getModuleName ()

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

boolean getRunDisabledTests ()

Ottieni se GTest deve eseguire test disabilitati.

long getRuntimeHint ()

Restituisce il tempo di esecuzione previsto del test in millisecondi.

int getShardCount ()

Restituisce il conteggio degli shard 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 invocare il binario di test per raccogliere l'elenco dei casi di test applicabili o meno.

boolean isEnableXmlOutput ()

Ottiene o meno l'output xml di gtest per i risultati dei test.

boolean isSharded ()

Ottiene il flag isSharded.

void setAbi ( IAbi abi)
void setCollectTestsOnly (boolean shouldCollectTest)

Abilita o disabilita la modalità di raccolta dei test

void setConfiguration ( IConfiguration configuration)

Inserisce la IConfiguration in uso.

void setModuleName (String moduleName)

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

void setShardCount (int shardCount)

Imposta il numero di 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 args.

void erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename)
String getAllGTestFlags (String path)

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

IConfiguration getConfiguration ()

Restituisce la configurazione del test.

String getExceptionMessage (Exception e)

Fai del tuo meglio per recuperare un breve messaggio descrittivo significativo per una determinata Exception

String getGTestCmdLine (String fullPath, String flags)

Metodo di supporto per compilare 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 ottenere l'esecuzione del filtro g-test di test.

ITestInvocationListener getGTestListener ( ITestInvocationListener listener)

Restituisce GTestListener che fornisce informazioni di debug aggiuntive, ad esempio rileva e segnala test duplicati se mDisabledDuplicateCheck è false.

abstract String loadFilter (String path)

Definisci il metodo di acquisizione del filtro.

void setRunDisabled (boolean runDisabled)

Imposta se GTest deve eseguire test disabilitati.

Campi

FILTRO_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

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Aggiunge l' ERROR(/Set) di filtri da cui escludere i test.

Parametri
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Aggiunge l' ERROR(/Set) di filtri di cui includere i test.

Parametri
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Aggiunge un filtro di quali test escludere.

Parametri
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro di quali test includere.

Parametri
filter String

filtro pulito

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'attuale ERROR(/Set) dei filtri di esclusione.

ritorna

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Ottiene regex per escludere determinati file dall'esecuzione.

ritorna

getGTestFlags

public  getGTestFlags ()

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

ritorna

getIncludeFilters

public  getIncludeFilters ()

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

ritorna

getMaxTestTimeMs

public long getMaxTestTimeMs ()

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

ritorna
long

getModuleName

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

Ottieni se GTest deve eseguire test disabilitati.

ritorna
boolean True se devono essere eseguiti test disabilitati, false 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 partizionata

ritorna
long

getShardCount

public int getShardCount ()

Restituisce il conteggio degli shard 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

getTestModule

public String getTestModule ()

Ottiene il nome del modulo.

ritorna
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

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

ritorna
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

Ottiene o meno l'output xml di gtest per i risultati dei test.

ritorna
boolean

isSharded

public boolean isSharded ()

Ottiene il flag isSharded.

ritorna
boolean

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)

Inserisce la IConfiguration in uso.

Parametri
configuration IConfiguration

setModuleName

public void setModuleName (String moduleName)

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

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

setShardCount

public void setShardCount (int shardCount)

Imposta il numero di 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 corridori del test che a volte non possono decidere arbitrariamente.

Parametri
shardCountHint int : il numero di frammenti tentati.

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

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 args.

Parametri
filter String : la stringa del filtro

ritorna
String Il percorso del file contenente il filtro.

Tiri
DeviceNotAvailableException

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parametri
filters

filename String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Aiutante per far passare tutti i flag GTest 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 al GTest

Tiri
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

Restituisce la configurazione del test.

ritorna
IConfiguration una IConfigurazione

getExceptionMessage

protected String getExceptionMessage (Exception e)

Fai del tuo 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 compilare il comando gtest da eseguire.

Parametri
fullPath String : percorso assoluto del file system per gtest binary sul dispositivo

flags String : flag di esecuzione di 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 ottenere l'esecuzione del filtro g-test di test.

Si noti che i filtri filtrano solo sul 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 del filtro completo da passare al g-test o una stringa vuota se non ne è stata specificata nessuna

Tiri
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

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

Parametri
listener ITestInvocationListener

ritorna
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Definisci il metodo di acquisizione del filtro.

La sottoclasse deve implementare come ottenere il proprio filtro.

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

ritorna
String stringa di filtro.

Tiri
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Imposta se GTest deve eseguire test disabilitati.

Parametri
runDisabled boolean