À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

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 d'android.support.test.runner.AndroidJUnitRunner.

Résumé

Champs
`public static final String`	`EXCLUDE_COLLECTOR_FILTER_KEY`
`public static final String`	`INCLUDE_COLLECTOR_FILTER_KEY` Options de la bibliothèque d'outils du côté du collecteur.
`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.
`public static final 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 celui-ci.
`void`	`addAllExcludeFilters( filters)` Ajoute les `ERROR(/Set)` des filtres des tests à exclure.
`void`	`addAllIncludeAnnotation( annotations)` Ajoute un `ERROR(/Set)` d'annotations à inclure si un test est marqué avec celui-ci.
`void`	`addAllIncludeFilters( filters)` Ajoute les `ERROR(/Set)` des filtres des tests à inclure.
`void`	`addExcludeAnnotation(String excludeAnnotation)` Ajoute une annotation à exclure si un test est marqué avec elle.
`void`	`addExcludeFilter(String filter)` Ajoute un filtre des tests à exclure.
`void`	`addIncludeAnnotation(String annotation)` Ajoute une annotation à inclure si un test est marqué avec elle.
`void`	`addIncludeFilter(String filter)` Ajoute un filtre des tests à inclure.
`void`	`clearExcludeAnnotations()` Supprimez 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 d'inclusion actuellement suivis.
	`getExcludeAnnotations()` Renvoie l'`ERROR(/Set)` actuel des annotations à exclure.
	`getExcludeFilters()` Renvoie l'`ERROR(/Set)` actuelle des filtres d'exclusion.
`File`	`getExcludeTestFile()` Renvoie le fichier contenant les tests exclus.
	`getIncludeAnnotations()` Renvoie la `ERROR(/Set)` actuelle des annotations à inclure.
	`getIncludeFilters()` Renvoie l'`ERROR(/Set)` actuelle des filtres d'inclusion.
`File`	`getIncludeTestFile()` Renvoie le fichier contenant les tests inclus.
`long`	`getRuntimeHint()` Renvoie la durée d'exécution prévue 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)` Indique 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 le filtrage.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et transmet les résultats à 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.
	`split(int shardCount)` Version alternative de `split()` qui fournit également le shardCount que vous essayez d'exécuter.

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

Champs

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

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

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.

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

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 celui-ci.

Paramètres
`excludeAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Ajoute les 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 celui-ci.

Paramètres
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Ajoute les 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 elle.

Paramètres
`excludeAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre des tests à exclure.

Paramètres
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

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

Paramètres
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre des tests à inclure.

Paramètres
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Supprimez 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 d'inclusion actuellement suivis.

getExcludeAnnotations

public  getExcludeAnnotations ()

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

Renvoie

getExcludeFilters

public  getExcludeFilters ()

Renvoie l'ERROR(/Set) actuelle des filtres d'exclusion.

Renvoie

getExcludeTestFile

public File getExcludeTestFile ()

Renvoie le fichier contenant les tests exclus.

Renvoie
`File`

getIncludeAnnotations

public  getIncludeAnnotations ()

Renvoie la ERROR(/Set) actuelle des annotations à inclure.

Renvoie

getIncludeFilters

public  getIncludeFilters ()

Renvoie l'ERROR(/Set) actuelle 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 prévue du test en millisecondes. L'heure est utilisée pour équilibrer la charge de l'exécution fractionné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)

Indique 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 filtrage.

Paramètres
`filter`	`String`

Renvoie
`boolean`

Exécuter

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Exécute les tests et transmet les résultats à l'écouteur.

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

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 que vous essayez d'exécuter. Cela est utile pour certains outils d'exécution de tests qui ne peuvent pas toujours prendre une décision arbitraire.

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

Renvoie
	Ensemble de sous-tests à exécuter séparément ou `null` si le test n'est pas actuellement partitionnable

Méthodes protégées

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Paramètres
`runner`	`IRemoteAndroidTestRunner`