A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

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

GTest	Un test che esegue un pacchetto di test nativo sul dispositivo specificato.
HostGTest	Un test che esegue un pacchetto di test nativo.

Sottoclassi indirette note

ArtGTest

La classe base di gTest

Riepilogo

Costanti
`String`	`FILTER_EXTENSION`
`String`	`GTEST_FLAG_FILE`
`String`	`GTEST_FLAG_FILTER`
`String`	`GTEST_FLAG_LIST_TESTS`
`String`	`GTEST_FLAG_PRINT_TIME`
`String`	`GTEST_FLAG_RUN_DISABLED_TESTS`
`String`	`GTEST_XML_OUTPUT`

Costruttori pubblici
`GTestBase()`

Metodi pubblici
`void`	`addAllExcludeFilters( filters)` Aggiunge il `ERROR(/Set)` dei filtri dei test da escludere.
`void`	`addAllIncludeFilters( filters)` Aggiunge il `ERROR(/Set)` dei filtri dei test da includere.
`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 della shell da eseguire dopo GTest.
	`getBeforeTestCmd()` Recupera i comandi della shell da eseguire prima di GTest.
	`getExcludeFilters()` Restituisce l'`ERROR(/Set)` corrente dei filtri di esclusione.
	`getFileExclusionFilterRegex()` Recupera l'espressione regolare 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 di esecuzione di un test gtest.
`String`	`getModuleName()` Recupera il modulo di test nativo di Android da eseguire.
`boolean`	`getRunDisabledTests()` Recupera 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()` Restituisce l'indice dello shard di questo test.
`String`	`getTestFilterKey()` Recupera la chiave del filtro di test.
`String`	`getTestModule()` Recupera il nome del modulo.
`boolean`	`isCollectTestsOnly()` Indica se richiamare o meno il binario di test per raccogliere l'elenco dei casi di test applicabili.
`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)` Notifica al genitore l'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)` Attiva o disattiva la modalità di raccolta dei test
`void`	`setConfiguration(IConfiguration configuration)` Inserisce il `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 shard di questo test.
`void`	`setShardIndex(int shardIndex)` Imposta l'indice dello shard di questo test.
	`split(int shardCountHint)` Versione alternativa di `split()` che fornisce anche il valore shardCount che viene tentato 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 limitazioni del sistema operativo nelle 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 di 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 helper 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)` Helper per ottenere il filtro g-test del test da eseguire.
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` Restituisce il 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.

Costanti

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Constant Value: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Valore costante: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Constant Value: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Valore costante: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Constant Value: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Valore costante: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Constant Value: "--gtest_output=xml:%s"

Costruttori pubblici

GTestBase

public GTestBase ()

Metodi pubblici

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Aggiunge il ERROR(/Set) dei filtri dei test da escludere.

Parametri
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

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 della shell da eseguire dopo GTest.

Ritorni

getBeforeTestCmd

public  getBeforeTestCmd ()

Recupera i comandi della shell da eseguire prima di GTest.

Ritorni

getExcludeFilters

public  getExcludeFilters ()

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

Ritorni

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Recupera l'espressione regolare 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 di esecuzione di un test gtest.

Ritorni
`long`

getModuleName

public String getModuleName ()

Recupera il modulo di test nativo di Android da eseguire.

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

getRunDisabledTests

public boolean getRunDisabledTests ()

Recupera se GTest deve eseguire i test disattivati.

Ritorni
`boolean`	Vero se devono essere eseguiti 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 partizionata

Ritorni
`long`

getShardCount

public int getShardCount ()

Restituisce il numero di shard corrente.

Ritorni
`int`

getShardIndex

public int getShardIndex ()

Restituisce l'indice dello shard 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 ()

Indica se richiamare o meno il 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 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)

Notifica al genitore l'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)

Attiva o disattiva la modalità di raccolta dei test

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserisce il 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 shard di questo test.

Parametri
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

Imposta l'indice dello shard di questo test.

Parametri
`shardIndex`	`int`

suddivisione

public  split (int shardCountHint)

Versione alternativa di split() che fornisce anche il valore shardCount che viene tentato di eseguire. Ciò è utile per alcuni test runner che a volte non possono decidere in modo arbitrario.

Parametri
`shardCountHint`	`int`: il numero di shard tentato.

Ritorni
	una raccolta di test secondari da eseguire separatamente o `null` se il test non è attualmente suddivisibile

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 limitazioni del sistema operativo nelle dimensioni degli argomenti.

Parametri
`filter`	`String`: la stringa di 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 che devono essere passati a GTest

Lanci
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

Restituisce la configurazione di test.

Ritorni
`IConfiguration`	un 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 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 del 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)

Helper per ottenere il filtro g-test del 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 Cases" di Google Test.

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

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

Lanci
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

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

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 recupero del proprio filtro.

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

Ritorni
`String`	stringa di filtro.

Lanci
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Imposta se GTest deve eseguire i test disattivati.

Parametri
`runDisabled`	`boolean`