A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 agente di raccolta.
`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(Set<String> excludeAnnotations)` Aggiunge un `Set` di annotazioni da escludere se un test è contrassegnato con questo valore.
`void`	`addAllExcludeFilters(Set<String> filters)` Aggiunge il `Set` dei filtri dei test da escludere.
`void`	`addAllIncludeAnnotation(Set<String> annotations)` Aggiunge un `Set` di annotazioni da includere se un test è contrassegnato con questo valore.
`void`	`addAllIncludeFilters(Set<String> filters)` Aggiunge il `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.
`Set<String>`	`getExcludeAnnotations()` Restituisce l'`Set` corrente delle annotazioni da escludere.
`Set<String>`	`getExcludeFilters()` Restituisce l'attuale `Set` dei filtri di esclusione.
`File`	`getExcludeTestFile()` Restituisce il file contenente i test esclusi.
`Set<String>`	`getIncludeAnnotations()` Restituisce l'`Set` corrente delle annotazioni da includere.
`Set<String>`	`getIncludeFilters()` Restituisce l'`Set` corrente dei filtri di inclusione.
`File`	`getIncludeTestFile()` Restituisce il file contenente i test inclusi.
`long`	`getRuntimeHint()` Restituisce la durata prevista 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.
`Collection<IRemoteTest>`	`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

Valore costante: "exclude-filter-group"

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

Opzioni della libreria helper lato agente di raccolta.

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.

Valore costante: "newRunListenerMode"

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

Valore costante: "useTestStorageService"

Costruttori pubblici

AndroidJUnitTest

public AndroidJUnitTest ()

Metodi pubblici

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> excludeAnnotations)

Aggiunge un Set di annotazioni da escludere se un test è contrassegnato con questo valore.

Parametri
`excludeAnnotations`	`Set`

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Aggiunge il Set dei filtri dei test da escludere.

Parametri
`filters`	`Set`

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

Aggiunge un Set di annotazioni da includere se un test è contrassegnato con questo valore.

Parametri
`annotations`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Aggiunge il Set dei filtri dei test da includere.

Parametri
`filters`	`Set`

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 Set<String> getExcludeAnnotations ()

Restituisce l'Set corrente delle annotazioni da escludere.

Resi
`Set<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

Restituisce l'attuale Set dei filtri di esclusione.

Resi
`Set<String>`

getExcludeTestFile

public File getExcludeTestFile ()

Restituisce il file contenente i test esclusi.

Resi
`File`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

Restituisce l'Set corrente delle annotazioni da includere.

Resi
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Restituisce l'Set corrente dei filtri di inclusione.

Resi
`Set<String>`

getIncludeTestFile

public File getIncludeTestFile ()

Restituisce il file contenente i test inclusi.

Resi
`File`

getRuntimeHint

public long getRuntimeHint ()

Restituisce la durata prevista del test in millisecondi. Il tempo viene utilizzato per bilanciare il carico dell'esecuzione suddivisa in shard

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

Resi
`boolean`

isParameterizedTest

public boolean isParameterizedTest (String filter)

Restituisce se una stringa è un test parametrizzato.

Parametri
`filter`	`String`

Resi
`boolean`

isRegex

public boolean isRegex (String filter)

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

Parametri
`filter`	`String`

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

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

ripartire

public Collection<IRemoteTest> split (int shardCount)

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

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

Resi
`Collection<IRemoteTest>`	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`