Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

Zusammenfassung

Felder
`protected`	`mListeners`

Öffentliche Konstruktoren
`UiAutomatorTest()`

Öffentliche Methoden
`void`	`addAllExcludeFilters( filters)` Fügt die `ERROR(/Set)` der Filter hinzu, für die Tests ausgeschlossen werden sollen.
`void`	`addAllIncludeFilters( filters)` Fügt die `ERROR(/Set)` der Filter hinzu, für die Tests einbezogen werden sollen.
`void`	`addClassName(String className)` Fügen Sie einen Testklassennamen hinzu, der ausgeführt werden soll.
`void`	`addClassNames( classNames)` Fügen Sie eine Sammlung von Testklassennamen hinzu, die ausgeführt werden sollen.
`void`	`addExcludeFilter(String filter)` Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.
`void`	`addIncludeFilter(String filter)` Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.
`void`	`addRunArg(String key, String value)` Argument hinzufügen, das beim Ausführen der UI Automator-Tests angegeben werden soll
`void`	`clearExcludeFilters()` Löschen Sie alle derzeit erfassten Ausschlussfilter.
`void`	`clearIncludeFilters()` Löschen Sie alle derzeit erfassten Einschlussfilter.
	`getClassNames()` Ruft die Liste der Testklassennamen ab, für die das Harness konfiguriert ist.
`ITestDevice`	`getDevice()` Besorgen Sie sich das zu testende Gerät.
	`getExcludeFilters()` Gibt die aktuelle `ERROR(/Set)` der Ausschlussfilter zurück.
	`getIncludeFilters()` Gibt die aktuelle `ERROR(/Set)` der Einschlussfilter zurück.
`long`	`getSyncTime()`
	`getTestJarPaths()`
	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Führt die Tests aus und meldet das Ergebnis an den Listener.
`void`	`setCaptureLogs(boolean captureLogs)` Diese Methode ist veraltet. Verwenden Sie stattdessen `setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption)`. Zur Kompatibilität mit cts-tradefed beibehalten
`void`	`setDevice(ITestDevice device)` Schließe das zu testende Gerät an.
`void`	`setLoggingOption(UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName(String runName)`
`void`	`setRunnerName(String runnerName)`
`void`	`setSyncTime(long syncTime)`
`void`	`setTestJarPaths( jarPaths)`
`void`	`setTestRunArgMap( runArgMap)`

Geschützte Methoden
`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()` Prüft, ob die UI Automator-Komponenten auf dem Gerät vorhanden sind.

Felder

mListeners

protected  mListeners

Öffentliche Konstruktoren

UiAutomatorTest

public UiAutomatorTest ()

Öffentliche Methoden

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests ausgeschlossen werden sollen.

Parameter
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Fügt die ERROR(/Set) der Filter hinzu, für die Tests einbezogen werden sollen.

Parameter
`filters`

addClassName

public void addClassName (String className)

Fügen Sie einen Testklassennamen hinzu, der ausgeführt werden soll.

Parameter
`className`	`String`

addClassNames

public void addClassNames ( classNames)

Fügen Sie eine Sammlung von Testklassennamen hinzu, die ausgeführt werden sollen.

Parameter
`classNames`

addExcludeFilter

public void addExcludeFilter (String filter)

Fügt einen Filter hinzu, mit dem festgelegt wird, welche Tests ausgeschlossen werden sollen.

Parameter
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Fügt einen Filter hinzu, der angibt, welche Tests einbezogen werden sollen.

Parameter
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

Argument hinzufügen, das beim Ausführen der UI Automator-Tests angegeben werden soll

Parameter
`key`	`String`: der Name des Arguments
`value`	`String`: der Argumentwert

clearExcludeFilters

public void clearExcludeFilters ()

Löschen Sie alle derzeit erfassten Ausschlussfilter.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

getClassNames

public  getClassNames ()

Ruft die Liste der Testklassennamen ab, für die das Harness konfiguriert ist.

Returns
	Liste der Testklassennamen

getDevice

public ITestDevice getDevice ()

Besorgen Sie sich das zu testende Gerät.

Returns
`ITestDevice`	die `ITestDevice`

getExcludeFilters

public  getExcludeFilters ()

Gibt die aktuelle ERROR(/Set) der Ausschlussfilter zurück.

Returns

getIncludeFilters

public  getIncludeFilters ()

Gibt die aktuelle ERROR(/Set) der Einschlussfilter zurück.

Returns

getSyncTime

public long getSyncTime ()

Returns
`long`	die Zeit, die für die Synchronisierung der Tests vorgesehen ist.

getTestJarPaths

public  getTestJarPaths ()

Returns
	den Test-JAR-Pfad.

getTestRunArgMap

public  getTestRunArgMap ()

Returns
	Die Argumentzuordnung, die an UiAutomatorRunner übergeben werden soll.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Returns
`IRemoteAndroidTestRunner`	Test-Ausführer

isInstrumentationTest

public boolean isInstrumentationTest ()

Returns
`boolean`

Homerun

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Führt die Tests aus und meldet das Ergebnis an den Listener.

Parameter
`testInfo`	`TestInformation`: Das `TestInformation`-Objekt mit nützlichen Informationen zum Ausführen von Tests.
`listener`	`ITestInvocationListener`: die `ITestInvocationListener` der Testergebnisse

Ausgabe
`DeviceNotAvailableException`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption).

Zur Kompatibilität mit cts-tradefed beibehalten

Parameter
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Schließe das zu testende Gerät an.

Parameter
`device`	`ITestDevice`: die zu verwendende `ITestDevice`

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

Parameter
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

Parameter
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Parameter
`runnerName`	`String`

setSyncTime

public void setSyncTime (long syncTime)

Parameter
`syncTime`	`long`: Die Zeit, die zum Synchronisieren der Testdateien benötigt wird.

setTestJarPaths

public void setTestJarPaths ( jarPaths)

Parameter
`jarPaths`	: die Speicherorte der Test-Jars.

setTestRunArgMap

public void setTestRunArgMap ( runArgMap)

Parameter
`runArgMap`	: Die Argumente, die an UiAutomatorRunner übergeben werden sollen.

Geschützte Methoden

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

Returns
`IRemoteAndroidTestRunner`

Ausgabe
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

Returns
`IRunUtil`

onScreenshotAndBugreport

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

Parameter
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`
`overrideAction`	`UiAutomatorTest.TestFailureAction`

onScreenshotAndBugreport

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

Parameter
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTestSetup

protected void preTestSetup ()

Prüft, ob die UI Automator-Komponenten auf dem Gerät vorhanden sind.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`