Questa pagina è stata tradotta dall'API Cloud Translation.

GTestBase

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

java.lang.Oggetto
↳	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 note

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 dei test da escludere.
`void`	`addAllIncludeFilters ( filters)` `addAllIncludeFilters ( filters)` Aggiunge l' `ERROR(/Set)` dei filtri dei test da includere.
`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' `ERROR(/Set)` corrente dei filtri di esclusione.
	`getFileExclusionFilterRegex ()` Ottiene regex per escludere determinati file dall'esecuzione.
	`getGTestFlags ()` Ottiene valori 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 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 runtime previsto del test in millisecondi.
`int`	`getShardCount ()` Restituisce il numero di 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 file binario di test per raccogliere l'elenco dei casi di test applicabili o meno.
`boolean`	`isEnableXmlOutput ()` Ottiene l'utilizzo dell'output gtest xml per i risultati del test o meno.
`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)` Inietta l' `IConfiguration` in uso.
`void`	`setModuleName (String moduleName)` Impostare l'esecuzione del modulo di test nativo di Android.
`void`	`setShardCount (int shardCount)` Imposta il numero di shard 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)` Helper per ottenere tutti i flag GTest da passare nel comando adb shell.
`IConfiguration`	`getConfiguration ()` Restituisce la configurazione di prova.
`String`	`getExceptionMessage (Exception e)` Fai del tuo meglio per recuperare un breve messaggio descrittivo significativo per una data `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)` Helper per eseguire il filtro g-test del test.
`ITestInvocationListener`	`getGTestListener ( ITestInvocationListener listener)` Restituisce il GTestListener che fornisce ulteriori informazioni di debug, come rileva e segnala i test duplicati se mDisabledDuplicateCheck è false.
`abstract String`	`loadFilter (String path)` Definire il metodo get filter.
`void`	`setRunDisabled (boolean runDisabled)` Imposta se GTest deve eseguire i test disabilitati.

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 l' ERROR(/Set) dei filtri dei test da escludere.

Parametri
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

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`

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`

getDopoTestCmd

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 regex per escludere determinati file dall'esecuzione.

ritorna

getGTestFlags

public  getGTestFlags ()

Ottiene valori 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 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 i test disabilitati, false in caso contrario

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`

getShardCount

public int getShardCount ()

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

ritorna
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

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

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)

Inietta l' IConfiguration in uso.

Parametri
`configuration`	`IConfiguration`

setNomeModulo

public void setModuleName (String moduleName)

Impostare 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 shard 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 numero di shard tentato.

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

Parametri
`filter`	`String` : la stringa del filtro

ritorna
`String`	Il percorso del file contenente il filtro.

Getta
	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 nel comando adb shell.

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

ritorna
`String`	la `String` di tutti i flag GTest che devono essere passati al GTest

Getta
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Restituisce la configurazione di prova.

ritorna
`IConfiguration`	un IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Fai del tuo meglio per recuperare un breve messaggio descrittivo significativo per una data 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)

Helper per eseguire il filtro g-test del test.

Si noti 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 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

Getta
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

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

Parametri
`listener`	`ITestInvocationListener`

ritorna
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

Definire il metodo get filter.

La sottoclasse deve implementare come ottenere il proprio filtro.

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

ritorna
`String`	stringa di filtro.

Getta
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Imposta se GTest deve eseguire i test disabilitati.

Parametri
`runDisabled`	`boolean`