À 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 dans AOSP, utilisez android-latest-release. 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.

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

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(Set<String> excludeAnnotations)` Ajoute un `Set` d'annotations à exclure si un test est marqué avec.
`void`	`addAllExcludeFilters(Set<String> filters)` Ajoute le `Set` des filtres des tests à exclure.
`void`	`addAllIncludeAnnotation(Set<String> annotations)` Ajoute un `Set` d'annotations à inclure si un test est marqué avec.
`void`	`addAllIncludeFilters(Set<String> filters)` Ajoute le `Set` de filtres pour les 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.
`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()` Supprime toutes les annotations d'inclusion actuellement suivies.
`void`	`clearIncludeFilters()` Supprimez tous les filtres d'inclusion actuellement suivis.
`Set<String>`	`getExcludeAnnotations()` Renvoie le `Set` actuel des annotations à exclure.
`Set<String>`	`getExcludeFilters()` Renvoie le `Set` actuel des filtres d'exclusion.
`File`	`getExcludeTestFile()` Renvoie le fichier contenant les tests exclus.
`Set<String>`	`getIncludeAnnotations()` Renvoie le `Set` actuel des annotations à inclure.
`Set<String>`	`getIncludeFilters()` Renvoie le `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 signale le résultat à l'écouteur.
`void`	`setExcludeTestFile(File testFile)` Définit le fichier de test des exclusions.
`void`	`setIncludeTestFile(File testFile)` Définit le fichier de test des inclusions.
`Collection<IRemoteTest>`	`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 (Set<String> excludeAnnotations)

Ajoute un Set d'annotations à exclure si un test est marqué avec.

Paramètres
`excludeAnnotations`	`Set`

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Ajoute le Set des filtres des tests à exclure.

Paramètres
`filters`	`Set`

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

Ajoute un Set d'annotations à inclure si un test est marqué avec.

Paramètres
`annotations`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Ajoute le Set de filtres pour les tests à inclure.

Paramètres
`filters`	`Set`

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.

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 ()

Supprime toutes les annotations d'inclusion actuellement suivies.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres d'inclusion actuellement suivis.

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

Renvoie le Set actuel des annotations à exclure.

Renvoie
`Set<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

Renvoie le Set actuel des filtres d'exclusion.

Renvoie
`Set<String>`

getExcludeTestFile

public File getExcludeTestFile ()

Renvoie le fichier contenant les tests exclus.

Renvoie
`File`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

Renvoie le Set actuel des annotations à inclure.

Renvoie
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Renvoie le Set actuel des filtres d'inclusion.

Renvoie
`Set<String>`

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 le filtre.

Paramètres
`filter`	`String`

Renvoie
`boolean`

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et signale le résultat à l'écouteur.

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 Collection<IRemoteTest> 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ées.

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