W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

Podsumowanie

Pola
`protected Collection<ITestLifeCycleReceiver>`	`mListeners`

Konstruktory publiczne
`UiAutomatorTest()`

Metody publiczne
`void`	`addAllExcludeFilters(Set<String> filters)` Dodaje `Set` filtrów określających, które testy mają zostać wykluczone.
`void`	`addAllIncludeFilters(Set<String> filters)` Dodaje `Set` filtrów, które określają, jakie testy mają być uwzględnione.
`void`	`addClassName(String className)` Dodaj nazwę klasy testowej do uruchomienia.
`void`	`addClassNames(Collection<String> classNames)` Dodaj kolekcję nazw klas testowych do uruchomienia.
`void`	`addExcludeFilter(String filter)` Dodaje filtr określający, które testy mają zostać wykluczone.
`void`	`addIncludeFilter(String filter)` Dodaje filtr określający, które testy mają być uwzględnione.
`void`	`addRunArg(String key, String value)` Dodawanie argumentu do podania podczas uruchamiania testów UI Automator
`void`	`clearExcludeFilters()` Usuń wszystkie obecnie śledzone filtry wykluczeń.
`void`	`clearIncludeFilters()` Usuń wszystkie obecnie śledzone filtry uwzględniania.
`List<String>`	`getClassNames()` Pobiera listę nazw klas testowych, które mają być uruchamiane przez narzędzie.
`ITestDevice`	`getDevice()` Przygotuj urządzenie testowe.
`Set<String>`	`getExcludeFilters()` Zwraca bieżącą `Set` filtrów wykluczeń.
`Set<String>`	`getIncludeFilters()` Zwraca bieżącą `Set` filtrów uwzględniania.
`long`	`getSyncTime()`
`List<String>`	`getTestJarPaths()`
`Map<String, String>`	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Przeprowadza testy i przekazuje wyniki odbiorcy.
`void`	`setCaptureLogs(boolean captureLogs)` Ta metoda została wycofana. użyj w zamian zasady `setLoggingOption(LoggingOption)`. Zachowano ze względu na zgodność z cts-tradefed
`void`	`setDevice(ITestDevice device)` Wstrzyknij testowane urządzenie.
`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)`

Metody chronione
`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()` Sprawdza, czy na urządzeniu są komponenty UI Automator.

Pola

mListeners

protected Collection<ITestLifeCycleReceiver> mListeners

Konstruktory publiczne

UiAutomatorTest

public UiAutomatorTest ()

Metody publiczne

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Dodaje Set filtrów określających, które testy mają zostać wykluczone.

Parametry
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Dodaje Set filtrów, które określają, jakie testy mają być uwzględnione.

Parametry
`filters`	`Set`

addClassName

public void addClassName (String className)

Dodaj nazwę klasy testowej do uruchomienia.

Parametry
`className`	`String`

addClassNames

public void addClassNames (Collection<String> classNames)

Dodaj kolekcję nazw klas testowych do uruchomienia.

Parametry
`classNames`	`Collection`

addExcludeFilter

public void addExcludeFilter (String filter)

Dodaje filtr określający, które testy mają zostać wykluczone.

Parametry
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Dodaje filtr określający, które testy mają być uwzględnione.

Parametry
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

Dodawanie argumentu do podania podczas uruchamiania testów UI Automator

Parametry
`key`	`String`: nazwa argumentu
`value`	`String`: wartość argumentu

clearExcludeFilters

public void clearExcludeFilters ()

Usuń wszystkie obecnie śledzone filtry wykluczeń.

clearIncludeFilters

public void clearIncludeFilters ()

Usuń wszystkie obecnie śledzone filtry uwzględniania.

getClassNames

public List<String> getClassNames ()

Pobiera listę nazw klas testowych, które mają być uruchamiane przez narzędzie.

Zwraca
`List<String>`	lista nazw klas testowych,

getDevice

public ITestDevice getDevice ()

Przygotuj urządzenie testowe.

Zwraca
`ITestDevice`	`ITestDevice`

getExcludeFilters

public Set<String> getExcludeFilters ()

Zwraca bieżącą Set filtrów wykluczeń.

Zwraca
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Zwraca bieżącą Set filtrów uwzględniania.

Zwraca
`Set<String>`

getSyncTime

public long getSyncTime ()

Zwraca
`long`	czasu przeznaczonego na synchronizację testów.

getTestJarPaths

public List<String> getTestJarPaths ()

Zwraca
`List<String>`	ścieżkę do pliku JAR testu.

getTestRunArgMap

public Map<String, String> getTestRunArgMap ()

Zwraca
`Map<String, String>`	argumenty mapy do przekazania do UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Zwraca
`IRemoteAndroidTestRunner`	uruchamiający test.

isInstrumentationTest

public boolean isInstrumentationTest ()

Zwraca
`boolean`

home run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Przeprowadza testy i przekazuje wyniki odbiorcy.

Parametry
`testInfo`	`TestInformation`: obiekt `TestInformation` zawierający przydatne informacje do przeprowadzania testów.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` wyników testu

Zgłasza
`DeviceNotAvailableException`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Ta metoda została wycofana.
Zamiast niej używaj zasady setLoggingOption(LoggingOption).

Zachowano ze względu na zgodność z cts-tradefed

Parametry
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Wstrzyknij testowane urządzenie.

Parametry
`device`	`ITestDevice`: `ITestDevice`, którego chcesz użyć.

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

Parametry
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

Parametry
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Parametry
`runnerName`	`String`

setSyncTime

public void setSyncTime (long syncTime)

Parametry
`syncTime`	`long`: czas synchronizacji plików testowych.

setTestJarPaths

public void setTestJarPaths (List<String> jarPaths)

Parametry
`jarPaths`	`List`: lokalizacje plików JAR testów.

setTestRunArgMap

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

Parametry
`runArgMap`	`Map`: argumenty do przekazania do UiAutomatorRunner.

Metody chronione

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

Zwraca
`IRemoteAndroidTestRunner`

Zgłasza
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

Zwraca
`IRunUtil`

onScreenshotAndBugreport

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

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

onScreenshotAndBugreport

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

Parametry
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTestSetup

protected void preTestSetup ()

Sprawdza, czy na urządzeniu są komponenty UI Automator.

Zgłasza
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`