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.

AndroidJUnitTest

public class AndroidJUnitTest
extends InstrumentationTest implements IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestFileFilterReceiver, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.InstrumentationTest
	↳	com.android.tradefed.testtype.AndroidJUnitTest

Um teste que executa um pacote de teste de instrumentação no dispositivo especificado usando o android.support.test.runner.AndroidJUnitRunner.

Resumo

Constantes
`String`	`EXCLUDE_COLLECTOR_FILTER_KEY`
`String`	`INCLUDE_COLLECTOR_FILTER_KEY` Opções da biblioteca auxiliar do lado do coletor.
`String`	`NEW_RUN_LISTENER_ORDER_KEY` Argumento do executor de teste de instrumentação usado para ativar a nova ordem `RunListener` no lado do dispositivo.
`String`	`USE_TEST_STORAGE_SERVICE`

Construtores públicos
`AndroidJUnitTest()`

Métodos públicos
`void`	`addAllExcludeAnnotation( excludeAnnotations)` Adiciona um `ERROR(/Set)` de anotações a serem excluídas se um teste for marcado com ele.
`void`	`addAllExcludeFilters( filters)` Adiciona o `ERROR(/Set)` de filtros de quais testes excluir.
`void`	`addAllIncludeAnnotation( annotations)` Adiciona um `ERROR(/Set)` de anotações para incluir se um teste for marcado com ele.
`void`	`addAllIncludeFilters( filters)` Adiciona o `ERROR(/Set)` de filtros de quais testes incluir.
`void`	`addExcludeAnnotation(String excludeAnnotation)` Adiciona uma anotação para excluir se um teste for marcado com ela.
`void`	`addExcludeFilter(String filter)` Adiciona um filtro de quais testes excluir.
`void`	`addIncludeAnnotation(String annotation)` Adiciona uma anotação para incluir se um teste for marcado com ela.
`void`	`addIncludeFilter(String filter)` Adiciona um filtro de quais testes incluir.
`void`	`clearExcludeAnnotations()` Exclui todas as anotações de exclusão rastreadas no momento.
`void`	`clearExcludeFilters()` Exclui todos os filtros de exclusão rastreados no momento.
`void`	`clearIncludeAnnotations()` Exclui todas as anotações de inclusão rastreadas no momento.
`void`	`clearIncludeFilters()` Exclui todos os filtros de inclusão rastreados no momento.
	`getExcludeAnnotations()` Retorna o `ERROR(/Set)` atual de anotações a serem excluídas.
	`getExcludeFilters()` Retorna o `ERROR(/Set)` atual dos filtros de exclusão.
`File`	`getExcludeTestFile()` Retorna o arquivo com os testes excluídos.
	`getIncludeAnnotations()` Retorna o `ERROR(/Set)` atual de anotações a serem incluídas.
	`getIncludeFilters()` Retorna o `ERROR(/Set)` atual dos filtros de inclusão.
`File`	`getIncludeTestFile()` Retorna o arquivo que contém os testes incluídos.
`long`	`getRuntimeHint()` Retorna o tempo de execução esperado do teste em milissegundos.
`boolean`	`isClassOrMethod(String filter)` Retorna se uma string é o nome de uma classe ou de um método.
`boolean`	`isParameterizedTest(String filter)` Retorna se uma string é um teste parametrizado.
`boolean`	`isRegex(String filter)` Retorna se uma string é uma regex para filtro.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Executa os testes e informa o resultado ao listener.
`void`	`setExcludeTestFile(File testFile)` Define o arquivo de teste de exclusões.
`void`	`setIncludeTestFile(File testFile)` Define o arquivo de teste de inclusões.
	`split(int shardCount)` Versão alternativa de `split()` que também fornece o shardCount que está sendo tentado executar.

Métodos protegidos
`void`	`setRunnerArgs(IRemoteAndroidTestRunner runner)`

Constantes

EXCLUDE_COLLECTOR_FILTER_KEY

public static final String EXCLUDE_COLLECTOR_FILTER_KEY

Valor da constante: "exclude-filter-group"

INCLUDE_COLLECTOR_FILTER_KEY

public static final String INCLUDE_COLLECTOR_FILTER_KEY

Opções da biblioteca auxiliar do lado do coletor.

Valor da constante: "include-filter-group"

NEW_RUN_LISTENER_ORDER_KEY

public static final String NEW_RUN_LISTENER_ORDER_KEY

Argumento do executor de teste de instrumentação usado para ativar a nova ordem RunListener no lado do dispositivo.

Valor da constante: "newRunListenerMode"

USE_TEST_STORAGE_SERVICE

public static final String USE_TEST_STORAGE_SERVICE

Valor da constante: "useTestStorageService"

Construtores públicos

AndroidJUnitTest

public AndroidJUnitTest ()

Métodos públicos

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( excludeAnnotations)

Adiciona um ERROR(/Set) de anotações a serem excluídas se um teste for marcado com ele.

Parâmetros
`excludeAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

Parâmetros
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Adiciona um ERROR(/Set) de anotações para incluir se um teste for marcado com ele.

Parâmetros
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Parâmetros
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String excludeAnnotation)

Adiciona uma anotação para excluir se um teste for marcado com ela.

Parâmetros
`excludeAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Adiciona um filtro de quais testes excluir.

Parâmetros
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Adiciona uma anotação para incluir se um teste for marcado com ela.

Parâmetros
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Adiciona um filtro de quais testes incluir.

Parâmetros
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Exclui todas as anotações de exclusão rastreadas no momento.

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Exclui todas as anotações de inclusão rastreadas no momento.

clearIncludeFilters

public void clearIncludeFilters ()

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

getExcludeAnnotations

public  getExcludeAnnotations ()

Retorna o ERROR(/Set) atual de anotações a serem excluídas.

Retorna

getExcludeFilters

public  getExcludeFilters ()

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

Retorna

getExcludeTestFile

public File getExcludeTestFile ()

Retorna o arquivo que contém os testes excluídos.

Retorna
`File`

getIncludeAnnotations

public  getIncludeAnnotations ()

Retorna o ERROR(/Set) atual de anotações a serem incluídas.

Retorna

getIncludeFilters

public  getIncludeFilters ()

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

Retorna

getIncludeTestFile

public File getIncludeTestFile ()

Retorna o arquivo que contém os testes incluídos.

Retorna
`File`

getRuntimeHint

public long getRuntimeHint ()

Retorna o tempo de execução esperado do teste em milissegundos. O tempo é usado para balancear a carga da execução fragmentada.

Retorna
`long`

isClassOrMethod

public boolean isClassOrMethod (String filter)

Retorna se uma string é o nome de uma classe ou de um método.

Parâmetros
`filter`	`String`

Retorna
`boolean`

isParameterizedTest

public boolean isParameterizedTest (String filter)

Retorna se uma string é um teste parametrizado.

Parâmetros
`filter`	`String`

Retorna
`boolean`

isRegex

public boolean isRegex (String filter)

Retorna se uma string é uma regex para filtro.

Parâmetros
`filter`	`String`

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`

setExcludeTestFile

public void setExcludeTestFile (File testFile)

Define o arquivo de teste de exclusões. Não garante que testFile exista ou seja um arquivo.

Parâmetros
`testFile`	`File`

setIncludeTestFile

public void setIncludeTestFile (File testFile)

Define o arquivo de teste de inclusões. Não garante que testFile exista ou seja um arquivo.

Parâmetros
`testFile`	`File`

dividido

public  split (int shardCount)

Versão alternativa de split() que também fornece o shardCount que está sendo tentado executar. Isso é útil para alguns executores de teste que não podem decidir arbitrariamente às vezes.

Parâmetros
`shardCount`	`int`: a contagem de fragmentos tentada.

Retorna
	uma coleção de subtestes a serem executados separadamente ou `null` se o teste não puder ser fragmentado no momento.

Métodos protegidos

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parâmetros
`runner`	`IRemoteAndroidTestRunner`