Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an 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

Zusammenfassung

Felder
`protected Collection<ITestLifeCycleReceiver>`	`mListeners`

Öffentliche Konstruktoren
`UiAutomatorTest()`

Öffentliche Methoden
`void`	`addAllExcludeFilters(Set<String> filters)` Fügt die `Set` der Filter hinzu, anhand derer Tests ausgeschlossen werden sollen.
`void`	`addAllIncludeFilters(Set<String> filters)` Fügt die `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(Collection<String> 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()` Alle derzeit erfassten Ausschlussfilter löschen.
`void`	`clearIncludeFilters()` Löschen Sie alle derzeit erfassten Einschlussfilter.
`List<String>`	`getClassNames()` Ruft die Liste der Testklassennamen ab, für die das Harness konfiguriert ist.
`ITestDevice`	`getDevice()` Besorgen Sie sich das zu testende Gerät.
`Set<String>`	`getExcludeFilters()` Gibt die aktuelle `Set` der Ausschlussfilter zurück.
`Set<String>`	`getIncludeFilters()` Gibt die aktuelle `Set` der Einschlussfilter zurück.
`long`	`getSyncTime()`
`List<String>`	`getTestJarPaths()`
`Map<String, String>`	`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 wurde eingestellt. Verwenden Sie stattdessen `setLoggingOption(LoggingOption)`. Zur Kompatibilität mit cts-tradefed beibehalten
`void`	`setDevice(ITestDevice device)` Schleusen Sie das zu testende Gerät ein.
`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)`

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 Collection<ITestLifeCycleReceiver> mListeners

Öffentliche Konstruktoren

UiAutomatorTest

public UiAutomatorTest ()

Öffentliche Methoden

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Fügt die Set der Filter hinzu, anhand derer Tests ausgeschlossen werden sollen.

Parameter
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

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

Parameter
`filters`	`Set`

addClassName

public void addClassName (String className)

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

Parameter
`className`	`String`

addClassNames

public void addClassNames (Collection<String> classNames)

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

Parameter
`classNames`	`Collection`

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

Alle derzeit erfassten Ausschlussfilter löschen.

clearIncludeFilters

public void clearIncludeFilters ()

Löschen Sie alle derzeit erfassten Einschlussfilter.

getClassNames

public List<String> getClassNames ()

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

Gibt Folgendes zurück:
`List<String>`	Liste der Testklassennamen

getDevice

public ITestDevice getDevice ()

Besorgen Sie sich das zu testende Gerät.

Gibt Folgendes zurück:
`ITestDevice`	die `ITestDevice`

getExcludeFilters

public Set<String> getExcludeFilters ()

Gibt die aktuelle Set der Ausschlussfilter zurück.

Gibt Folgendes zurück:
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Gibt die aktuelle Set der Einschlussfilter zurück.

Gibt Folgendes zurück:
`Set<String>`

getSyncTime

public long getSyncTime ()

Gibt Folgendes zurück:
`long`	die für die Synchronisierung der Tests vorgesehene Zeit.

getTestJarPaths

public List<String> getTestJarPaths ()

Gibt Folgendes zurück:
`List<String>`	den Pfad zur Test-JAR-Datei.

getTestRunArgMap

public Map<String, String> getTestRunArgMap ()

Gibt Folgendes zurück:
`Map<String, String>`	Die Argumentzuordnung, die an UiAutomatorRunner übergeben werden soll.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Gibt Folgendes zurück:
`IRemoteAndroidTestRunner`	Test-Ausführer

isInstrumentationTest

public boolean isInstrumentationTest ()

Gibt Folgendes zurück:
`boolean`

run

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

Löst aus
`DeviceNotAvailableException`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen setLoggingOption(LoggingOption).

Zur Kompatibilität mit cts-tradefed beibehalten

Parameter
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Schleusen Sie das zu testende Gerät ein.

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

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

setTestRunArgMap

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

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

Geschützte Methoden

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

Gibt Folgendes zurück:
`IRemoteAndroidTestRunner`

Löst aus
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

Gibt Folgendes zurück:
`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.

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`