Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável 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, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

DeviceTestCase

public class DeviceTestCase
extends MetricTestCase implements IDeviceTest, IRemoteTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	com.android.tradefed.testtype.MetricTestCase
			↳	com.android.tradefed.testtype.DeviceTestCase

Caso de teste JUnit auxiliar que fornece os serviços IRemoteTest e IDeviceTest.

Isso é útil se você quiser implementar testes que seguem o padrão JUnit de definição de testes e ainda ter suporte total para outros recursos do tradefed, como Options.

Resumo

Campos
`protected Set<String>`	`mExcludeAnnotation` As anotações de exclusão do teste a ser executado
`protected Set<String>`	`mExcludeFilters` Os filtros de exclusão do nome do teste a ser executado
`protected Set<String>`	`mIncludeAnnotation` As anotações de inclusão do teste a ser executado
`protected Set<String>`	`mIncludeFilters` Os filtros de inclusão do nome do teste a ser executado

Construtores públicos
`DeviceTestCase()`
`DeviceTestCase(String name)`

Métodos públicos
`void`	`addAllExcludeAnnotation(Set<String> notAnnotations)` Adiciona um `Set` de anotações a serem excluídas se um teste for marcado com ele.
`void`	`addAllExcludeFilters(Set<String> filters)` Adiciona o `Set` de filtros de quais testes excluir.
`void`	`addAllIncludeAnnotation(Set<String> annotations)` Adiciona um `Set` de anotações para incluir se um teste for marcado com ele.
`void`	`addAllIncludeFilters(Set<String> filters)` Adiciona o `Set` de filtros de quais testes incluir.
`void`	`addExcludeAnnotation(String notAnnotation)` 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.
`int`	`countTestCases()`
`ITestDevice`	`getDevice()` Pega o dispositivo em teste.
`Set<String>`	`getExcludeAnnotations()` Retorna o `Set` atual de anotações a serem excluídas.
`Set<String>`	`getExcludeFilters()` Retorna o `Set` atual dos filtros de exclusão.
`Set<String>`	`getIncludeAnnotations()` Retorna o `Set` atual das anotações a serem incluídas.
`Set<String>`	`getIncludeFilters()` Retorna o `Set` atual dos filtros de inclusão.
`void`	`run(TestResult result)` Substitua o método principal para executar todos os métodos de teste se o método de teste a ser executado for nulo.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Executa os testes e informa o resultado ao listener.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Ativa ou desativa o modo de coleta de testes.
`void`	`setDevice(ITestDevice device)` Injeta o dispositivo em teste.

Campos

mExcludeAnnotation

protected Set<String> mExcludeAnnotation

As anotações de exclusão do teste a ser executado

mExcludeFilters

protected Set<String> mExcludeFilters

Os filtros de exclusão do nome do teste a ser executado

mIncludeAnnotation

protected Set<String> mIncludeAnnotation

As anotações de inclusão do teste a ser executado

mIncludeFilters

protected Set<String> mIncludeFilters

Os filtros de inclusão do nome do teste a ser executado

Construtores públicos

DeviceTestCase

public DeviceTestCase ()

DeviceTestCase

public DeviceTestCase (String name)

Parâmetros
`name`	`String`

Métodos públicos

addAllExcludeAnnotation

public void addAllExcludeAnnotation (Set<String> notAnnotations)

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

Parâmetros
`notAnnotations`	`Set`

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Adiciona o Set de filtros de quais testes excluir.

Parâmetros
`filters`	`Set`

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

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

Parâmetros
`annotations`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Adiciona o Set de filtros de quais testes incluir.

Parâmetros
`filters`	`Set`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

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

Parâmetros
`notAnnotation`	`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.

countTestCases

public int countTestCases ()

Retorna
`int`

getDevice

public ITestDevice getDevice ()

Pega o dispositivo em teste.

Retorna
`ITestDevice`	a solicitação `ITestDevice`

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

Retorna o Set atual de anotações a serem excluídas.

Retorna
`Set<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

Retorna o Set atual dos filtros de exclusão.

Retorna
`Set<String>`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

Retorna o Set atual das anotações a serem incluídas.

Retorna
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Retorna o Set atual dos filtros de inclusão.

Retorna
`Set<String>`

run

public void run (TestResult result)

Substitua o método principal para executar todos os métodos de teste se o método de teste a ser executado for nulo.

O framework JUnit só é compatível com a execução de todos os testes em um TestCase ao encapsular em um TestSuite. Infelizmente, com esse mecanismo, os chamadores não podem controlar o ciclo de vida dos próprios casos de teste, o que impossibilita ações como fazer com que a estrutura de configuração do tradefed injete opções em um caso de teste.

Parâmetros
`result`	`TestResult`

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`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Ativa ou desativa o modo de coleta de testes.

setDevice

public void setDevice (ITestDevice device)

Injeta o dispositivo em teste.

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