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

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.UiAutomatorTest

Résumé

Champs
`protected Collection<ITestLifeCycleReceiver>`	`mListeners`

Constructeurs publics
`UiAutomatorTest()`

Méthodes publiques
`void`	`addAllExcludeFilters(Set<String> filters)` Ajoute le `Set` des filtres des tests à exclure.
`void`	`addAllIncludeFilters(Set<String> filters)` Ajoute le `Set` de filtres pour les tests à inclure.
`void`	`addClassName(String className)` Ajoutez un nom de classe de test à exécuter.
`void`	`addClassNames(Collection<String> classNames)` Ajoutez une collection de noms de classes de test à exécuter.
`void`	`addExcludeFilter(String filter)` Ajoute un filtre pour exclure certains tests.
`void`	`addIncludeFilter(String filter)` Ajoute un filtre pour inclure certains tests.
`void`	`addRunArg(String key, String value)` Ajoutez un argument à fournir lors de l'exécution des tests UI Automator.
`void`	`clearExcludeFilters()` Supprimez tous les filtres d'exclusion actuellement suivis.
`void`	`clearIncludeFilters()` Supprimez tous les filtres d'inclusion actuellement suivis.
`List<String>`	`getClassNames()` Obtient la liste des noms de classes de test que le harnais est configuré pour exécuter.
`ITestDevice`	`getDevice()` Obtenez l'appareil soumis aux tests.
`Set<String>`	`getExcludeFilters()` Renvoie le `Set` actuel des filtres d'exclusion.
`Set<String>`	`getIncludeFilters()` Renvoie le `Set` actuel des filtres d'inclusion.
`long`	`getSyncTime()`
`List<String>`	`getTestJarPaths()`
`Map<String, String>`	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et signale le résultat à l'écouteur.
`void`	`setCaptureLogs(boolean captureLogs)` Cette méthode est obsolète. Utilisez plutôt `setLoggingOption(LoggingOption)`. Conservé pour la compatibilité avec cts-tradefed
`void`	`setDevice(ITestDevice device)` Injectez l'appareil soumis aux tests.
`void`	`setLoggingOption(UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName(String runName)`
`void`	`setRunnerName(String runnerName)`
`void`	`setSyncTime(long syncTime)`
`void`	`setTestJarPaths(List<String> jarPaths)`
`void`	`setTestRunArgMap(Map<String, String> runArgMap)`

Méthodes protégées
`IRemoteAndroidTestRunner`	`createTestRunner()`
`IRunUtil`	`getRunUtil()`
`void`	`onScreenshotAndBugreport(ITestDevice device, ITestInvocationListener listener, String prefix, UiAutomatorTest.TestFailureAction overrideAction)`
`void`	`onScreenshotAndBugreport(ITestDevice device, ITestInvocationListener listener, String prefix)`
`void`	`preTestSetup()` Vérifie si les composants UI Automator sont présents sur l'appareil.

Champs

mListeners

protected Collection<ITestLifeCycleReceiver> mListeners

Constructeurs publics

UiAutomatorTest

public UiAutomatorTest ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Ajoute le Set des filtres des tests à exclure.

Paramètres
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Ajoute le Set de filtres pour les tests à inclure.

Paramètres
`filters`	`Set`

addClassName

public void addClassName (String className)

Ajoutez un nom de classe de test à exécuter.

Paramètres
`className`	`String`

addClassNames

public void addClassNames (Collection<String> classNames)

Ajoutez une collection de noms de classes de test à exécuter.

Paramètres
`classNames`	`Collection`

addExcludeFilter

public void addExcludeFilter (String filter)

Ajoute un filtre pour exclure certains tests.

Paramètres
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Ajoute un filtre pour inclure certains tests.

Paramètres
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

Ajoutez un argument à fournir lors de l'exécution des tests UI Automator.

Paramètres
`key`	`String` : nom de l'argument
`value`	`String` : valeur de l'argument

clearExcludeFilters

public void clearExcludeFilters ()

Supprimez tous les filtres d'exclusion actuellement suivis.

clearIncludeFilters

public void clearIncludeFilters ()

Supprimez tous les filtres d'inclusion actuellement suivis.

getClassNames

public List<String> getClassNames ()

Obtient la liste des noms de classes de test que le harnais est configuré pour exécuter.

Renvoie
`List<String>`	Liste des noms de classes de test

getDevice

public ITestDevice getDevice ()

Obtenez l'appareil soumis aux tests.

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

getExcludeFilters

public Set<String> getExcludeFilters ()

Renvoie le Set actuel des filtres d'exclusion.

Renvoie
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Renvoie le Set actuel des filtres d'inclusion.

Renvoie
`Set<String>`

getSyncTime

public long getSyncTime ()

Renvoie
`long`	le temps alloué à la synchronisation des tests.

getTestJarPaths

public List<String> getTestJarPaths ()

Renvoie
`List<String>`	le chemin d'accès au fichier JAR de test.

getTestRunArgMap

public Map<String, String> getTestRunArgMap ()

Renvoie
`Map<String, String>`	La carte des arguments à transmettre à UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Renvoie
`IRemoteAndroidTestRunner`	le lanceur de test.

isInstrumentationTest

public boolean isInstrumentationTest ()

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`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Cette méthode est obsolète.
utilisez plutôt setLoggingOption(LoggingOption).

Conservé pour la compatibilité avec cts-tradefed

Paramètres
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Injectez l'appareil soumis aux tests.

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

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

Paramètres
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

Paramètres
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Paramètres
`runnerName`	`String`

setSyncTime

public void setSyncTime (long syncTime)

Paramètres
`syncTime`	`long` : temps nécessaire à la synchronisation des fichiers de test.

setTestJarPaths

public void setTestJarPaths (List<String> jarPaths)

Paramètres
`jarPaths`	`List` : emplacements des fichiers JAR de test.

setTestRunArgMap

public void setTestRunArgMap (Map<String, String> runArgMap)

Paramètres
`runArgMap`	`Map` : arguments à transmettre à UiAutomatorRunner.

Méthodes protégées

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

Renvoie
`IRemoteAndroidTestRunner`

Génère
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

Renvoie
`IRunUtil`

onScreenshotAndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix, 
                UiAutomatorTest.TestFailureAction overrideAction)

Paramètres
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`
`overrideAction`	`UiAutomatorTest.TestFailureAction`

onScreenshotAndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix)

Paramètres
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTestSetup

protected void preTestSetup ()

Vérifie si les composants UI Automator sont présents sur l'appareil.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`