A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en el 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

Resumen

Campos
`protected Collection<ITestLifeCycleReceiver>`	`mListeners`

Constructores públicos
`UiAutomatorTest()`

Métodos públicos
`void`	`addAllExcludeFilters(Set<String> filters)` Agrega el `Set` de los filtros de las pruebas que se excluirán.
`void`	`addAllIncludeFilters(Set<String> filters)` Agrega el `Set` de los filtros de las pruebas que se incluirán.
`void`	`addClassName(String className)` Agrega un nombre de clase de prueba para ejecutar.
`void`	`addClassNames(Collection<String> classNames)` Agrega una colección de nombres de clases de prueba para ejecutar.
`void`	`addExcludeFilter(String filter)` Agrega un filtro de qué pruebas se deben excluir.
`void`	`addIncludeFilter(String filter)` Agrega un filtro de las pruebas que se incluirán.
`void`	`addRunArg(String key, String value)` Agrega un argumento para proporcionar cuando se ejecuten las pruebas de UI Automator
`void`	`clearExcludeFilters()` Borra todos los filtros de exclusión que se rastrean actualmente.
`void`	`clearIncludeFilters()` Borra todos los filtros de inclusión que se rastrean actualmente.
`List<String>`	`getClassNames()` Obtiene la lista de nombres de clases de prueba para las que se configuró el arnés para ejecutar
`ITestDevice`	`getDevice()` Obtén el dispositivo que se probará.
`Set<String>`	`getExcludeFilters()` Devuelve el `Set` actual de los filtros de exclusión.
`Set<String>`	`getIncludeFilters()` Devuelve el `Set` actual de los filtros de inclusión.
`long`	`getSyncTime()`
`List<String>`	`getTestJarPaths()`
`Map<String, String>`	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Ejecuta las pruebas y le informa el resultado al objeto de escucha.
`void`	`setCaptureLogs(boolean captureLogs)` Este método dejó de estar disponible. En su lugar, usa `setLoggingOption(LoggingOption)`. Se retuvo para garantizar la compatibilidad con cts-tradefed
`void`	`setDevice(ITestDevice device)` Inserta el dispositivo en prueba.
`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étodos protegidos
`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()` Comprueba si los componentes de UI Automator están presentes en el dispositivo

Campos

mListeners

protected Collection<ITestLifeCycleReceiver> mListeners

Constructores públicos

UiAutomatorTest

public UiAutomatorTest ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Agrega el Set de los filtros de las pruebas que se excluirán.

Parámetros
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Agrega el Set de los filtros de las pruebas que se incluirán.

Parámetros
`filters`	`Set`

addClassName

public void addClassName (String className)

Agrega un nombre de clase de prueba para ejecutar.

Parámetros
`className`	`String`

addClassNames

public void addClassNames (Collection<String> classNames)

Agrega una colección de nombres de clases de prueba para ejecutar.

Parámetros
`classNames`	`Collection`

addExcludeFilter

public void addExcludeFilter (String filter)

Agrega un filtro de qué pruebas se deben excluir.

Parámetros
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Agrega un filtro de las pruebas que se incluirán.

Parámetros
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

Agrega un argumento para proporcionar cuando se ejecuten las pruebas de UI Automator

Parámetros
`key`	`String`: El nombre del argumento
`value`	`String`: El valor del argumento

clearExcludeFilters

public void clearExcludeFilters ()

Borra todos los filtros de exclusión que se rastrean actualmente.

clearIncludeFilters

public void clearIncludeFilters ()

Borra todos los filtros de inclusión que se rastrean actualmente.

getClassNames

public List<String> getClassNames ()

Obtiene la lista de nombres de clases de prueba para las que se configuró el arnés para ejecutar

Muestra
`List<String>`	Lista de nombres de clases de prueba

getDevice

public ITestDevice getDevice ()

Obtén el dispositivo que se probará.

Muestra
`ITestDevice`	`ITestDevice`

getExcludeFilters

public Set<String> getExcludeFilters ()

Devuelve el Set actual de los filtros de exclusión.

Muestra
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Devuelve el Set actual de los filtros de inclusión.

Muestra
`Set<String>`

getSyncTime

public long getSyncTime ()

Muestra
`long`	Es el tiempo asignado para que se sincronicen las pruebas.

getTestJarPaths

public List<String> getTestJarPaths ()

Muestra
`List<String>`	Es la ruta del JAR de prueba.

getTestRunArgMap

public Map<String, String> getTestRunArgMap ()

Muestra
`Map<String, String>`	Es el mapa de argumentos que se pasará a UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Muestra
`IRemoteAndroidTestRunner`	el ejecutor de pruebas.

isInstrumentationTest

public boolean isInstrumentationTest ()

Muestra
`boolean`

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Ejecuta las pruebas y le informa el resultado al objeto de escucha.

Parámetros
`testInfo`	`TestInformation`: Es el objeto `TestInformation` que contiene información útil para ejecutar pruebas.
`listener`	`ITestInvocationListener`: El `ITestInvocationListener` de los resultados de la prueba

Arroja
`DeviceNotAvailableException`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Este método dejó de estar disponible.
En su lugar, usa setLoggingOption(LoggingOption).

Se retuvo para la compatibilidad con cts-tradefed

Parámetros
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Inserta el dispositivo en prueba.

Parámetros
`device`	`ITestDevice`: Es el `ITestDevice` que se usará.

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

Parámetros
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

Parámetros
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Parámetros
`runnerName`	`String`

setSyncTime

public void setSyncTime (long syncTime)

Parámetros
`syncTime`	`long`: Es el tiempo que tardan en sincronizarse los archivos de prueba.

setTestJarPaths

public void setTestJarPaths (List<String> jarPaths)

Parámetros
`jarPaths`	`List`: Son las ubicaciones de los archivos JAR de prueba.

setTestRunArgMap

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

Parámetros
`runArgMap`	`Map`: Son los argumentos que se pasarán a UiAutomatorRunner.

Métodos protegidos

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

Muestra
`IRemoteAndroidTestRunner`

Arroja
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

Muestra
`IRunUtil`

onScreenshotAndBugreport

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

Parámetros
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`
`overrideAction`	`UiAutomatorTest.TestFailureAction`

onScreenshotAndBugreport

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

Parámetros
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTestSetup

protected void preTestSetup ()

Comprueba si los componentes de UI Automator están presentes en el dispositivo

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`