A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

Resumo

Campos
`protected`	`mListeners`

Construtores públicos
`UiAutomatorTest()`

Métodos públicos
`void`	`addAllExcludeFilters( filters)` Adiciona o `ERROR(/Set)` de filtros de quais testes excluir.
`void`	`addAllIncludeFilters( filters)` Adiciona o `ERROR(/Set)` de filtros de quais testes incluir.
`void`	`addClassName(String className)` Adicione um nome de classe de teste para executar.
`void`	`addClassNames( classNames)` Adicione uma coleção de nomes de classes de teste para executar.
`void`	`addExcludeFilter(String filter)` Adiciona um filtro de quais testes excluir.
`void`	`addIncludeFilter(String filter)` Adiciona um filtro de quais testes incluir.
`void`	`addRunArg(String key, String value)` Adicionar um argumento para fornecer ao executar os testes do UI Automator
`void`	`clearExcludeFilters()` Exclui todos os filtros de exclusão rastreados no momento.
`void`	`clearIncludeFilters()` Exclui todos os filtros de inclusão rastreados no momento.
	`getClassNames()` Recebe a lista de nomes de classes de teste que o harness está configurado para executar.
`ITestDevice`	`getDevice()` Pegue o dispositivo em teste.
	`getExcludeFilters()` Retorna o `ERROR(/Set)` atual dos filtros de exclusão.
	`getIncludeFilters()` Retorna o `ERROR(/Set)` atual dos filtros de inclusão.
`long`	`getSyncTime()`
	`getTestJarPaths()`
	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Executa os testes e informa o resultado ao listener.
`void`	`setCaptureLogs(boolean captureLogs)` Esse método foi descontinuado. use `setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption)`. Mantido para compatibilidade com o cts-tradefed
`void`	`setDevice(ITestDevice device)` Injete o dispositivo em teste.
`void`	`setLoggingOption(UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName(String runName)`
`void`	`setRunnerName(String runnerName)`
`void`	`setSyncTime(long syncTime)`
`void`	`setTestJarPaths( jarPaths)`
`void`	`setTestRunArgMap( 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()` Verifica se os componentes do UI Automator estão presentes no dispositivo.

Campos

mListeners

protected  mListeners

Construtores públicos

UiAutomatorTest

public UiAutomatorTest ()

Métodos públicos

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros de quais testes excluir.

Parâmetros
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Adiciona o ERROR(/Set) de filtros de quais testes incluir.

Parâmetros
`filters`

addClassName

public void addClassName (String className)

Adicione um nome de classe de teste para executar.

Parâmetros
`className`	`String`

addClassNames

public void addClassNames ( classNames)

Adicione uma coleção de nomes de classes de teste para executar.

Parâmetros
`classNames`

addExcludeFilter

public void addExcludeFilter (String filter)

Adiciona um filtro de quais testes excluir.

Parâmetros
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Adiciona um filtro de quais testes incluir.

Parâmetros
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

Adicionar um argumento para fornecer ao executar os testes do UI Automator

Parâmetros
`key`	`String`: o nome do argumento
`value`	`String`: o valor do argumento

clearExcludeFilters

public void clearExcludeFilters ()

Exclui todos os filtros de exclusão rastreados no momento.

clearIncludeFilters

public void clearIncludeFilters ()

Exclui todos os filtros de inclusão rastreados no momento.

getClassNames

public  getClassNames ()

Recebe a lista de nomes de classes de teste que o harness está configurado para executar.

Retorna
	lista de nomes de classes de teste

getDevice

public ITestDevice getDevice ()

Pegue o dispositivo em teste.

Retorna
`ITestDevice`	o `ITestDevice`

getExcludeFilters

public  getExcludeFilters ()

Retorna o ERROR(/Set) atual dos filtros de exclusão.

Retorna

getIncludeFilters

public  getIncludeFilters ()

Retorna o ERROR(/Set) atual dos filtros de inclusão.

Retorna

getSyncTime

public long getSyncTime ()

Retorna
`long`	o tempo alocado para a sincronização dos testes.

getTestJarPaths

public  getTestJarPaths ()

Retorna
	o caminho do jar de teste.

getTestRunArgMap

public  getTestRunArgMap ()

Retorna
	o mapa de argumentos a ser transmitido para o UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Retorna
`IRemoteAndroidTestRunner`	o executor de teste.

isInstrumentationTest

public boolean isInstrumentationTest ()

Retorna
`boolean`

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Executa os testes e informa o resultado ao listener.

Parâmetros
`testInfo`	`TestInformation`: o objeto `TestInformation` que contém informações úteis para executar testes.
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` dos resultados do teste

Gera
`DeviceNotAvailableException`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Esse método foi descontinuado.
use setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption).

Mantido para compatibilidade com cts-tradefed.

Parâmetros
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Injete o dispositivo em teste.

Parâmetros
`device`	`ITestDevice`: o `ITestDevice` a ser usado

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`: o tempo para sincronização dos arquivos de teste.

setTestJarPaths

public void setTestJarPaths ( jarPaths)

Parâmetros
`jarPaths`	: os locais dos jars de teste.

setTestRunArgMap

public void setTestRunArgMap ( runArgMap)

Parâmetros
`runArgMap`	: os argumentos a serem transmitidos para o UiAutomatorRunner.

Métodos protegidos

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

Retorna
`IRemoteAndroidTestRunner`

Gera
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

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

Verifica se os componentes do UI Automator estão presentes no dispositivo.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`