Questa pagina è stata tradotta dall'API Cloud Translation.

GTestBase

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

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

Sottoclassi dirette note

GTest, HostGTest

Test G	Un test che esegue un pacchetto di test nativo su un determinato dispositivo.
Test Ghost	Un test che esegue un pacchetto di test nativo.

Sottoclassi indirette note

Test G

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)` Aggiunge `ERROR(/Set)` di filtri di cui test escludere.
`void`	`addAllIncludeFilters( filters)` Aggiunge `ERROR(/Set)` di filtri di quali test includere.
`void`	`addExcludeFilter(String filter)` Aggiunge un filtro dei test da escludere.
`void`	`addIncludeFilter(String filter)` Aggiunge un filtro dei 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'attuale `ERROR(/Set)` 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 il valore `ERROR(/Set)` corrente dei filtri di inclusione.
`long`	`getMaxTestTimeMs()` Restituisce il tempo massimo per l'esecuzione di un test gtest.
`String`	`getModuleName()` Scarica il modulo di test nativo Android da eseguire.
`boolean`	`getRunDisabledTests()` Scopri 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 di shard di questo test.
`String`	`getTestFilterKey()` Ottiene la chiave di filtro di prova.
`String`	`getTestModule()` Ottiene il nome del modulo.
`boolean`	`isCollectTestsOnly()` Consente di richiamare solo il programma binario di test per raccogliere o meno l'elenco degli scenari di test applicabili.
`boolean`	`isEnableXmlOutput()` Ottieni l'utilizzo dell'output XML gtest per i risultati del test o meno.
`boolean`	`isSharded()` Ricevi il flag isSharded.
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` Avvisa il publisher principale dell'esecuzione del test, in modo che i filtri di inclusione/esclusione possano essere gestiti correttamente per i nuovi tentativi.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Attiva o disattiva la modalità di raccolta di prova
`void`	`setConfiguration(IConfiguration configuration)` Inserisce `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 per questo test.
`void`	`setShardIndex(int shardIndex)` Imposta l'indice dello shard per questo test.
	`split(int shardCountHint)` Versione alternativa di `split()` che fornisce anche lo shardCount tentato eseguire.

Metodi protetti
`String`	`createFlagFile(String filter)` Crea un file contenente i filtri che verranno utilizzati tramite --gtest_flagfile per evitare qualsiasi sistema operativo delle dimensioni degli argomenti.
`void`	`erasePrependedFileName( filters, String filename)`
`String`	`getAllGTestFlags(String path)` Assistente per ottenere tutti i flag GTest da passare al comando shell adb.
`IConfiguration`	`getConfiguration()` Restituisce la configurazione di test.
`String`	`getExceptionMessage(Exception e)` Fai il possibile per recuperare un messaggio descrittivo breve e significativo `Exception`
`String`	`getGTestCmdLine(String fullPath, String flags)` Metodo helper 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)` Assistente per ottenere il filtro g-test di test da eseguire.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener listener)` Restituisce il GTestListener che fornisce ulteriori informazioni di debug, come rileva e segnala test duplicati se mDisabledDisabledCheck è false.
`abstract String`	`loadFilter(String path)` Definisci il metodo di filtro "get".
`void`	`setRunDisabled(boolean runDisabled)` Imposta se GTest deve eseguire test disabilitati.

Campi

ESTENSIONE_FILTRO

protected static final String FILTER_EXTENSION

FILE_GTEST_FLAG

protected static final String GTEST_FLAG_FILE

FILTRO_GTEST_FLAG

protected static final String GTEST_FLAG_FILTER

TEST_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

aggiungiAllEscludiFiltri

public void addAllExcludeFilters ( filters)

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

Parametri
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Parametri
`filters`

aggiungiEscludiFiltro

public void addExcludeFilter (String filter)

Aggiunge un filtro dei test da escludere.

Parametri
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro dei test da includere.

Parametri
`filter`	`String`

PulisciFiltro

public String cleanFilter (String filter)

Parametri
`filter`	`String`

Ritorni
`String`

CancellaEscludiFiltri

public void clearExcludeFilters ()

Elimina tutti i filtri di esclusione attualmente monitorati.

CancellaIncludeFiltri

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

getEscludiFiltri

public  getExcludeFilters ()

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

Ritorni

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Ottiene la regex per escludere determinati file dall'esecuzione.

Ritorni

getGTestFlag

public  getGTestFlags ()

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

Ritorni

getIncludeFilters

public  getIncludeFilters ()

Restituisce il valore ERROR(/Set) corrente dei filtri di inclusione.

Ritorni

getMaxTestTimeMs

public long getMaxTestTimeMs ()

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

Ritorni
`long`

getModuleName

public String getModuleName ()

Scarica il modulo di test nativo Android da eseguire.

Ritorni
`String`	il nome del modulo di test nativo da eseguire o nullo se non è impostato

getRunDisabledTests

public boolean getRunDisabledTests ()

Scopri se GTest deve eseguire test disabilitati.

Ritorni
`boolean`	True se è necessario eseguire 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 con sharding

Ritorni
`long`

getShardCount

public int getShardCount ()

Restituisce il numero di shard corrente.

Ritorni
`int`

getShardIndex

public int getShardIndex ()

Ottiene l'indice di shard di questo test.

Ritorni
`int`

getTestFilterKey

public String getTestFilterKey ()

Ottiene la chiave di filtro di prova.

Ritorni
`String`

getTestModule

public String getTestModule ()

Ottiene il nome del modulo.

Ritorni
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Consente di richiamare solo il programma binario di test per raccogliere o meno l'elenco degli scenari di test applicabili.

Ritorni
`boolean`

isAbilitaxmlOutput

public boolean isEnableXmlOutput ()

Ottieni l'utilizzo dell'output XML gtest per i risultati del test o meno.

Ritorni
`boolean`

Escluso

public boolean isSharded ()

Ricevi il flag isSharded.

Ritorni
`boolean`

notificaTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Notifica al publisher principale l'esecuzione del test, in modo che i filtri di inclusione/esclusione possano essere gestiti correttamente per i nuovi tentativi.

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 di prova

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserisce IConfiguration in uso.

Parametri
`configuration`	`IConfiguration`

impostaNomeModulo

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 per questo test.

Parametri
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

Imposta l'indice dello shard per questo test.

Parametri
`shardIndex`	`int`

Dividi

public  split (int shardCountHint)

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

Parametri
`shardCountHint`	`int`: numero di shard tentati.

Ritorni
	una raccolta di test secondari da eseguire separatamente oppure `null` se il test viene attualmente non si può partizionare con lo sharding

Metodi protetti

CreaFileFlag

protected String createFlagFile (String filter)

Crea un file contenente i filtri che verranno utilizzati tramite --gtest_flagfile per evitare qualsiasi sistema operativo delle dimensioni degli argomenti.

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

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

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
`DeviceNotAvailableException`

cancellarePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Parametri
`filters`
`filename`	`String`

getAllGTestFlag

protected String getAllGTestFlags (String path)

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

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

Ritorni
`String`	il valore `String` di tutti i flag GTest che devono essere passati a GTest

Lanci
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Restituisce la configurazione di test.

Ritorni
`IConfiguration`	una configurazione IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

Fai il possibile per recuperare un messaggio descrittivo breve e significativo Exception

Parametri
`e`	`Exception`: `Exception`

Ritorni
`String`	un breve messaggio

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Metodo helper per creare il comando gtest da eseguire.

Parametri
`fullPath`	`String`: percorso assoluto del file system per il file binario gtest sul dispositivo
`flags`	`String`: flag di esecuzione 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 racchiudere il comando gtest in qualche altro strumento (chroot, strace, gdb e simili).

Parametri
`fullPath`	`String`
`flags`	`String`

Ritorni
`String`

getGTestFilters

protected String getGTestFilters (String path)

Assistente per ottenere il filtro g-test di test da eseguire.

Tieni presente che i filtri filtrano solo in base al nome della funzione (ad esempio: Google Test "Test"); tutto Google Test "Scenari di test" saranno presi in considerazione.

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

Ritorni
`String`	il flag di filtro completo per passare al test g-test o una stringa vuota se non è stato specificato

Lanci
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

Restituisce il GTestListener che fornisce ulteriori informazioni di debug, come rileva e segnala test duplicati se mDisabledDisabledCheck è false. In caso contrario, restituisce il pass-in e ascolto.

Parametri
`listener`	`ITestInvocationListener`

Ritorni
`ITestInvocationListener`

filtro_caricamento

protected abstract String loadFilter (String path)

Definisci il metodo di filtro "get".

La sottoclasse deve implementare come ottenere il proprio filtro.

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

Ritorni
`String`	stringa di filtro.

Lanci
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Imposta se GTest deve eseguire test disabilitati.

Parametri
`runDisabled`	`boolean`