À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à 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

Test qui exécute un package de test d'instrumentation sur un appareil donné à l'aide de android.support.test.runner.AndroidJUnitRunner.

Résumé

Constantes
`String`	`EXCLUDE_COLLECTOR_FILTER_KEY`
`String`	`INCLUDE_COLLECTOR_FILTER_KEY` Options de la bibliothèque d'assistance côté collecteur.
`String`	`NEW_RUN_LISTENER_ORDER_KEY` Argument du lanceur de test d'instrumentation utilisé pour activer le nouvel ordre `RunListener` côté appareil.
`String`	`USE_TEST_STORAGE_SERVICE`

Constructeurs publics
`AndroidJUnitTest()`

Méthodes publiques
`void`	`addAllExcludeAnnotation( excludeAnnotations)` Ajoute un `ERROR(/Set)` d'annotations à exclure si un test est marqué avec.
`void`	`addAllExcludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des tests à exclure.
`void`	`addAllIncludeAnnotation( annotations)` Ajoute un `ERROR(/Set)` d'annotations à inclure si un test est marqué avec.
`void`	`addAllIncludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des tests à inclure.
`void`	`addExcludeAnnotation(String excludeAnnotation)` Ajoute une annotation à exclure si un test est marqué avec.
`void`	`addExcludeFilter(String filter)` Ajoute un filtre pour exclure certains tests.
`void`	`addIncludeAnnotation(String annotation)` Ajoute une annotation à inclure si un test est marqué avec celle-ci.
`void`	`addIncludeFilter(String filter)` Ajoute un filtre pour inclure certains tests.
`void`	`clearExcludeAnnotations()` Supprime toutes les annotations d'exclusion actuellement suivies.
`void`	`clearExcludeFilters()` Supprimez tous les filtres d'exclusion actuellement suivis.
`void`	`clearIncludeAnnotations()` Supprimez toutes les annotations d'inclusion actuellement suivies.
`void`	`clearIncludeFilters()` Supprimez tous les filtres "Inclure" actuellement suivis.
	`getExcludeAnnotations()` Renvoie le `ERROR(/Set)` actuel des annotations à exclure.
	`getExcludeFilters()` Renvoie le `ERROR(/Set)` actuel des filtres d'exclusion.
`File`	`getExcludeTestFile()` Renvoie le fichier contenant les tests exclus.
	`getIncludeAnnotations()` Renvoie le `ERROR(/Set)` actuel des annotations à inclure.
	`getIncludeFilters()` Renvoie le `ERROR(/Set)` actuel des filtres d'inclusion.
`File`	`getIncludeTestFile()` Renvoie le fichier contenant les tests inclus.
`long`	`getRuntimeHint()` Renvoie la durée d'exécution attendue du test en millisecondes.
`boolean`	`isClassOrMethod(String filter)` Indique si une chaîne est le nom d'une classe ou d'une méthode.
`boolean`	`isParameterizedTest(String filter)` Renvoie la valeur "true" si une chaîne est un test paramétré.
`boolean`	`isRegex(String filter)` Indique si une chaîne est une expression régulière pour un filtre.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et communique les résultats au listener.
`void`	`setExcludeTestFile(File testFile)` Définit le fichier de test des exclusions.
`void`	`setIncludeTestFile(File testFile)` Définit le fichier de test des inclusions.
	`split(int shardCount)` Version alternative de `split()` qui fournit également le shardCount qui est tenté d'être exécuté.

Méthodes protégées
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Constantes

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

Valeur constante : "exclude-filter-group"

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

Options de la bibliothèque d'assistance côté collecteur.

Valeur constante : "include-filter-group"

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

Argument du lanceur de test d'instrumentation utilisé pour activer le nouvel ordre RunListener côté appareil.

Valeur de constante : "newRunListenerMode"

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

Valeur de constante : "useTestStorageService"

Constructeurs publics

AndroidJUnitTest

public AndroidJUnitTest ()

Méthodes publiques

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( excludeAnnotations)

Ajoute un ERROR(/Set) d'annotations à exclure si un test est marqué avec.

Paramètres
`excludeAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Ajoute le ERROR(/Set) des filtres des tests à exclure.

Paramètres
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Ajoute un ERROR(/Set) d'annotations à inclure si un test est marqué avec.

Paramètres
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute le ERROR(/Set) des filtres des tests à inclure.

Paramètres
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String excludeAnnotation)

Ajoute une annotation à exclure si un test est marqué avec.

Paramètres
`excludeAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre pour exclure certains tests.

Paramètres
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Ajoute une annotation à inclure si un test est marqué avec celle-ci.

Paramètres
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre pour inclure certains tests.

Paramètres
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Supprime toutes les annotations d'exclusion actuellement suivies.

clearExcludeFilters

public void clearExcludeFilters ()

Supprimez tous les filtres d'exclusion actuellement suivis.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Supprimez toutes les annotations d'inclusion actuellement suivies.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres "Inclure" actuellement suivis.

getExcludeAnnotations

public  getExcludeAnnotations ()

Renvoie le ERROR(/Set) actuel des annotations à exclure.

Renvoie

getExcludeFilters

public  getExcludeFilters ()

Renvoie le ERROR(/Set) actuel des filtres d'exclusion.

Renvoie

getExcludeTestFile

public File getExcludeTestFile ()

Renvoie le fichier contenant les tests exclus.

Renvoie
`File`

getIncludeAnnotations

public  getIncludeAnnotations ()

Renvoie le ERROR(/Set) actuel des annotations à inclure.

Renvoie

getIncludeFilters

public  getIncludeFilters ()

Renvoie le ERROR(/Set) actuel des filtres d'inclusion.

Renvoie

getIncludeTestFile

public File getIncludeTestFile ()

Renvoie le fichier contenant les tests inclus.

Renvoie
`File`

getRuntimeHint

public long getRuntimeHint ()

Renvoie la durée d'exécution attendue du test en millisecondes. Ce temps est utilisé pour équilibrer la charge de l'exécution fragmentée.

Renvoie
`long`

isClassOrMethod

public boolean isClassOrMethod (String filter)

Indique si une chaîne est le nom d'une classe ou d'une méthode.

Paramètres
`filter`	`String`

Renvoie
`boolean`

isParameterizedTest

public boolean isParameterizedTest (String filter)

Renvoie la valeur "true" si une chaîne est un test paramétré.

Paramètres
`filter`	`String`

Renvoie
`boolean`

isRegex

public boolean isRegex (String filter)

Indique si une chaîne est une expression régulière pour un filtre.

Paramètres
`filter`	`String`

Renvoie
`boolean`

Exécuter

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et communique les résultats au listener.

Paramètres
`testInfo`	`TestInformation` : objet `TestInformation` contenant des informations utiles pour exécuter des tests.
`listener`	`ITestInvocationListener` : `ITestInvocationListener` des résultats du test

Génère
`DeviceNotAvailableException`

setExcludeTestFile

public void setExcludeTestFile (File testFile)

Définit le fichier de test des exclusions. Ne garantit pas que testFile existe ou est un fichier.

Paramètres
`testFile`	`File`

setIncludeTestFile

public void setIncludeTestFile (File testFile)

Définit le fichier de test des inclusions. Ne garantit pas que testFile existe ou est un fichier.

Paramètres
`testFile`	`File`

split

public  split (int shardCount)

Version alternative de split() qui fournit également le shardCount qui est tenté d'être exécuté. Cela est utile pour certains lanceurs de tests qui ne peuvent pas décider arbitrairement parfois.

Paramètres
`shardCount`	`int` : nombre de partitions tenté.

Renvoie
	une collection de sous-tests à exécuter séparément ou `null` si le test n'est pas actuellement fragmentable.

Méthodes protégées

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Paramètres
`runner`	`IRemoteAndroidTestRunner`