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.

AndroidJUnitTest

public class AndroidJUnitTest
extends InstrumentationTest implements IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestFileFilterReceiver, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.InstrumentationTest
	↳	com.android.tradefed.testtype.AndroidJUnitTest

Un test che esegue un pacchetto di test di strumentazione sul dispositivo specificato utilizzando android.support.test.runner.AndroidJUnitRunner.

Riepilogo

Costanti
`String`	`EXCLUDE_COLLECTOR_FILTER_KEY`
`String`	`INCLUDE_COLLECTOR_FILTER_KEY` Opzioni della libreria helper lato raccoglitore.
`String`	`NEW_RUN_LISTENER_ORDER_KEY` Argomento di esecuzione del test di strumentazione utilizzato per attivare il nuovo ordine `RunListener` sul lato dispositivo.
`String`	`USE_TEST_STORAGE_SERVICE`

Costruttori pubblici
`AndroidJUnitTest()`

Metodi pubblici
`void`	`addAllExcludeAnnotation( excludeAnnotations)` Aggiunge un `ERROR(/Set)` di annotazioni da escludere se un test è contrassegnato con questo valore.
`void`	`addAllExcludeFilters( filters)` Aggiunge il `ERROR(/Set)` dei filtri dei test da escludere.
`void`	`addAllIncludeAnnotation( annotations)` Aggiunge un `ERROR(/Set)` di annotazioni da includere se un test è contrassegnato con questo valore.
`void`	`addAllIncludeFilters( filters)` Aggiunge il `ERROR(/Set)` dei filtri dei test da includere.
`void`	`addExcludeAnnotation(String excludeAnnotation)` Aggiunge un'annotazione da escludere se un test è contrassegnato con questa annotazione.
`void`	`addExcludeFilter(String filter)` Aggiunge un filtro per i test da escludere.
`void`	`addIncludeAnnotation(String annotation)` Aggiunge un'annotazione da includere se un test è contrassegnato.
`void`	`addIncludeFilter(String filter)` Aggiunge un filtro per i test da includere.
`void`	`clearExcludeAnnotations()` Elimina tutte le annotazioni di esclusione attualmente monitorate.
`void`	`clearExcludeFilters()` Elimina tutti i filtri di esclusione attualmente monitorati.
`void`	`clearIncludeAnnotations()` Elimina tutte le annotazioni di inclusione attualmente monitorate.
`void`	`clearIncludeFilters()` Elimina tutti i filtri di inclusione attualmente monitorati.
	`getExcludeAnnotations()` Restituisce l'attuale `ERROR(/Set)` di annotazioni da escludere.
	`getExcludeFilters()` Restituisce l'`ERROR(/Set)` corrente dei filtri di esclusione.
`File`	`getExcludeTestFile()` Restituisce il file contenente i test esclusi.
	`getIncludeAnnotations()` Restituisce l'`ERROR(/Set)` corrente delle annotazioni da includere.
	`getIncludeFilters()` Restituisce l'`ERROR(/Set)` corrente dei filtri di inclusione.
`File`	`getIncludeTestFile()` Restituisce il file contenente i test inclusi.
`long`	`getRuntimeHint()` Restituisce il tempo di esecuzione previsto del test in millisecondi.
`boolean`	`isClassOrMethod(String filter)` Restituisce un valore che indica se una stringa è il nome di una classe o di un metodo.
`boolean`	`isParameterizedTest(String filter)` Restituisce un valore che indica se una stringa è un test parametrizzato.
`boolean`	`isRegex(String filter)` Restituisce true se una stringa è un'espressione regolare per il filtro.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Esegue i test e comunica il risultato al listener.
`void`	`setExcludeTestFile(File testFile)` Imposta il file di test delle esclusioni.
`void`	`setIncludeTestFile(File testFile)` Imposta il file di test degli include.
	`split(int shardCount)` Versione alternativa di `split()` che fornisce anche il valore shardCount che viene tentato di eseguire.

Metodi protetti
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Costanti

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

Constant Value: "exclude-filter-group"

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

Opzioni della libreria helper lato raccoglitore.

Valore costante: "include-filter-group"

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

Argomento di esecuzione del test di strumentazione utilizzato per attivare il nuovo ordine RunListener sul lato dispositivo.

Constant Value: "newRunListenerMode"

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

Constant Value: "useTestStorageService"

Costruttori pubblici

AndroidJUnitTest

public AndroidJUnitTest ()

Metodi pubblici

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( excludeAnnotations)

Aggiunge un ERROR(/Set) di annotazioni da escludere se un test è contrassegnato con questo valore.

Parametri
`excludeAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

Parametri
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Aggiunge un ERROR(/Set) di annotazioni da includere se un test è contrassegnato con questo valore.

Parametri
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Parametri
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String excludeAnnotation)

Aggiunge un'annotazione da escludere se un test è contrassegnato con questa annotazione.

Parametri
`excludeAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Aggiunge un filtro per i test da escludere.

Parametri
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Aggiunge un'annotazione da includere se un test è contrassegnato.

Parametri
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Aggiunge un filtro per i test da includere.

Parametri
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Elimina tutte le annotazioni di esclusione attualmente monitorate.

clearExcludeFilters

public void clearExcludeFilters ()

Elimina tutti i filtri di esclusione attualmente monitorati.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Elimina tutte le annotazioni di inclusione attualmente monitorate.

clearIncludeFilters

public void clearIncludeFilters ()

Elimina tutti i filtri di inclusione attualmente monitorati.

getExcludeAnnotations

public  getExcludeAnnotations ()

Restituisce l'attuale ERROR(/Set) di annotazioni da escludere.

Ritorni

getExcludeFilters

public  getExcludeFilters ()

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

Ritorni

getExcludeTestFile

public File getExcludeTestFile ()

Restituisce il file contenente i test esclusi.

Ritorni
`File`

getIncludeAnnotations

public  getIncludeAnnotations ()

Restituisce l'ERROR(/Set) corrente delle annotazioni da includere.

Ritorni

getIncludeFilters

public  getIncludeFilters ()

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

Ritorni

getIncludeTestFile

public File getIncludeTestFile ()

Restituisce il file contenente i test inclusi.

Ritorni
`File`

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`

isClassOrMethod

public boolean isClassOrMethod (String filter)

Restituisce un valore che indica se una stringa è il nome di una classe o di un metodo.

Parametri
`filter`	`String`

Ritorni
`boolean`

isParameterizedTest

public boolean isParameterizedTest (String filter)

Restituisce un valore che indica se una stringa è un test parametrizzato.

Parametri
`filter`	`String`

Ritorni
`boolean`

isRegex

public boolean isRegex (String filter)

Restituisce true se una stringa è un'espressione regolare per il filtro.

Parametri
`filter`	`String`

Ritorni
`boolean`

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Esegue i test e comunica il risultato al listener.

Parametri
`testInfo`	`TestInformation`: l'oggetto `TestInformation` contenente informazioni utili per eseguire i test.
`listener`	`ITestInvocationListener`: il `ITestInvocationListener` dei risultati del test

Lanci
`DeviceNotAvailableException`

setExcludeTestFile

public void setExcludeTestFile (File testFile)

Imposta il file di test delle esclusioni. Non garantisce che testFile esista o sia un file.

Parametri
`testFile`	`File`

setIncludeTestFile

public void setIncludeTestFile (File testFile)

Imposta il file di test degli include. Non garantisce che testFile esista o sia un file.

Parametri
`testFile`	`File`

suddivisione

public  split (int shardCount)

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
`shardCount`	`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

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametri
`runner`	`IRemoteAndroidTestRunner`