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

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

Résumé

Champs
`protected`	`mListeners`

Constructeurs publics
`UiAutomatorTest()`

Méthodes publiques
`void`	`addAllExcludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des tests à exclure.
`void`	`addAllIncludeFilters( filters)` Ajoute le `ERROR(/Set)` des filtres des tests à inclure.
`void`	`addClassName(String className)` Ajoutez un nom de classe de test à exécuter.
`void`	`addClassNames( 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 "Inclure" actuellement suivis.
	`getClassNames()` Obtient la liste des noms de classes de test que le harness est configuré pour exécuter.
`ITestDevice`	`getDevice()` Obtenez l'appareil à tester.
	`getExcludeFilters()` Renvoie le `ERROR(/Set)` actuel des filtres d'exclusion.
	`getIncludeFilters()` Renvoie le `ERROR(/Set)` actuel des filtres d'inclusion.
`long`	`getSyncTime()`
	`getTestJarPaths()`
	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Exécute les tests et communique les résultats au listener.
`void`	`setCaptureLogs(boolean captureLogs)` Cette méthode est obsolète. Utilisez plutôt `setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption)`. Conservé pour la compatibilité avec cts-tradefed
`void`	`setDevice(ITestDevice device)` Injectez l'appareil à tester.
`void`	`setLoggingOption(UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName(String runName)`
`void`	`setRunnerName(String runnerName)`
`void`	`setSyncTime(long syncTime)`
`void`	`setTestJarPaths( jarPaths)`
`void`	`setTestRunArgMap( 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  mListeners

Constructeurs publics

UiAutomatorTest

public UiAutomatorTest ()

Méthodes publiques

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

Paramètres
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Paramètres
`filters`

addClassName

public void addClassName (String className)

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

Paramètres
`className`	`String`

addClassNames

public void addClassNames ( classNames)

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

Paramètres
`classNames`

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 "Inclure" actuellement suivis.

getClassNames

public  getClassNames ()

Récupère la liste des noms de classes de test que le harnais est configuré pour exécuter.

Renvoie
	Liste des noms de classes de test

getDevice

public ITestDevice getDevice ()

Obtenez l'appareil à tester.

Renvoie
`ITestDevice`	le `ITestDevice`

getExcludeFilters

public  getExcludeFilters ()

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

Renvoie

getIncludeFilters

public  getIncludeFilters ()

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

Renvoie

getSyncTime

public long getSyncTime ()

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

getTestJarPaths

public  getTestJarPaths ()

Renvoie
	chemin d'accès au fichier JAR de test.

getTestRunArgMap

public  getTestRunArgMap ()

Renvoie
	La carte des arguments à transmettre à UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Renvoie
`IRemoteAndroidTestRunner`	le lanceur de test.

isInstrumentationTest

public boolean isInstrumentationTest ()

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`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Cette méthode est obsolète.
utilisez plutôt setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption).

Conservé pour la compatibilité avec cts-tradefed

Paramètres
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Injectez l'appareil à tester.

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

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

setTestRunArgMap

public void setTestRunArgMap ( runArgMap)

Paramètres
`runArgMap`	: 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`