À 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.

DeviceTestCase

public class DeviceTestCase
extends MetricTestCase implements IDeviceTest, IRemoteTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	com.android.tradefed.testtype.MetricTestCase
			↳	com.android.tradefed.testtype.DeviceTestCase

Cas de test JUnit d'assistance qui fournit les services IRemoteTest et IDeviceTest.

Cela est utile si vous souhaitez implémenter des tests qui suivent le modèle JUnit de définition des tests, tout en étant entièrement compatible avec d'autres fonctionnalités de tradefed telles que les Option.

Résumé

Champs
`protected`	`mExcludeAnnotation` Les annotations à exclure du test à exécuter
`protected`	`mExcludeFilters` Filtres d'exclusion du nom du test à exécuter
`protected`	`mIncludeAnnotation` Inclure les annotations du test à exécuter
`protected`	`mIncludeFilters` Filtres d'inclusion du nom du test à exécuter

Constructeurs publics
`DeviceTestCase()`
`DeviceTestCase(String name)`

Méthodes publiques
`void`	`addAllExcludeAnnotation( notAnnotations)` 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 notAnnotation)` 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.
`int`	`countTestCases()`
`ITestDevice`	`getDevice()` Obtenez l'appareil à tester.
	`getExcludeAnnotations()` Renvoie l'`ERROR(/Set)` actuel des annotations à exclure.
	`getExcludeFilters()` Renvoie l'`ERROR(/Set)` actuelle des filtres d'exclusion.
	`getIncludeAnnotations()` Renvoie la `ERROR(/Set)` actuelle des annotations à inclure.
	`getIncludeFilters()` Renvoie l'`ERROR(/Set)` actuelle des filtres d'inclusion.
`void`	`run(TestResult result)` Remplacez la méthode parente pour exécuter toutes les méthodes de test si la méthode de test à exécuter est nulle.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et transmet les résultats à l'écouteur.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Active ou désactive le mode de collecte des tests
`void`	`setDevice(ITestDevice device)` Injectez l'appareil testé.

Champs

mExcludeAnnotation

protected  mExcludeAnnotation

Les annotations à exclure du test à exécuter

mExcludeFilters

protected  mExcludeFilters

Filtres d'exclusion du nom du test à exécuter

mIncludeAnnotation

protected  mIncludeAnnotation

Inclure les annotations du test à exécuter

mIncludeFilters

protected  mIncludeFilters

Filtres d'inclusion du nom du test à exécuter

Constructeurs publics

DeviceTestCase

public DeviceTestCase ()

DeviceTestCase

public DeviceTestCase (String name)

Paramètres
`name`	`String`

Méthodes publiques

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

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

Paramètres
`notAnnotations`

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

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

Paramètres
`notAnnotation`	`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.

countTestCases

public int countTestCases ()

Renvoie
`int`

getDevice

public ITestDevice getDevice ()

Obtenez l'appareil à tester.

Renvoie
`ITestDevice`	l'/le/la `ITestDevice`

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

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

Exécuter

public void run (TestResult result)

Remplacez la méthode parente pour exécuter toutes les méthodes de test si la méthode de test à exécuter est nulle.

Le framework JUnit n'autorise l'exécution de tous les tests d'un TestCase que par l'encapsulation dans un TestSuite. Malheureusement, avec ce mécanisme, les appelants ne peuvent pas contrôler le cycle de vie de leurs propres cas de test, ce qui rend impossible, par exemple, d'injecter des options dans un cas de test par le framework de configuration de tradefed.

Paramètres
`result`	`TestResult`

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`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Active ou désactive le mode de collecte des tests

setDevice

public void setDevice (ITestDevice device)

Injectez l'appareil testé.

Paramètres
`device`	`ITestDevice`: `ITestDevice` à utiliser