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.

HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IDiscoverTestClasses, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

Subclasses diretas conhecidas

JarHostTest

JarHostTest Executor de testes para testes JUnit do lado do host.

Um executor de testes para testes baseados em host do JUnit. Se o teste a ser executado implementar IDeviceTest esse executor vai transmitir uma referência ao dispositivo.

Resumo

Constantes
`String`	`SET_OPTION_DESC`
`String`	`SET_OPTION_NAME`

Construtores públicos
`HostTest()`

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 estiver 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()` Retorna o número de casos de teste em todas as classes que fazem parte dos testes
`IAbi`	`getAbi()`
`Set<String>`	`getClassNames()`
`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.
`long`	`getRuntimeHint()` Retorna o tempo de execução esperado do teste em milissegundos.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Executa os testes e informa o resultado ao listener.
`void`	`setAbi(IAbi abi)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Ativa ou desativa o modo de coleta de testes.
`void`	`setConfiguration(IConfiguration configuration)` Injeta a `IConfiguration` em uso.
`void`	`setDevice(ITestDevice device)` Injeta o dispositivo em teste.
`static void`	`setOptionToLoadedObject(Object testObj, List<String> keyValueOptions)` Auxiliar para os executores de dispositivos usarem para definir opções da mesma forma que o HostTest, de set-option.
`void`	`setTestInformation(TestInformation testInfo)`
`Collection<IRemoteTest>`	`split(Integer shardCount, TestInformation testInfo)` Dividimos por indivíduo por classe ou método de teste.

Métodos protegidos
`HostTest`	`createHostTest(Class<?> classObj)` Auxiliar para criar uma instância HostTest ao fazer sharding.
`IBuildInfo`	`getBuild()` Receba as informações de build recebidas pelo HostTest.
`ClassLoader`	`getClassLoader()` Retorna o carregador de classes padrão.
`final List<Class<?>>`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` Inspecione vários locais onde o artefato geralmente está localizado para diferentes casos de uso e encontre nosso jar.
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Ajuda a determinar se estamos lidando com uma classe de teste com anotações do Junit4.
`Object`	`loadObject(Class<?> classObj)` carregue o objeto da classe e defina as informações de teste (dispositivo, build).
`void`	`setClassName(String className)` Limpe e defina um nome de classe para ser executado.
`void`	`setMethodName(String methodName)` Defina o nome do método a ser executado.
`boolean`	`shouldTestRun(AnnotatedElement annotatedElement)` Verifique se um elemento com anotação passa pelo filtro.

Constantes

SET_OPTION_DESC

public static final String SET_OPTION_DESC

Valor constante: "Opções a serem transmitidas para a classe em teste. A chave e o valor precisam ser separados por dois pontos ":". Por exemplo, se a classe em teste aceitar "--iteration 1" de uma linha de comando, ela precisará ser transmitida como "--set-option iteration:1" ou "--set-option iteration:key=value" para transmitir opções ao mapa. Valores que contêm ":" ou "=" podem ser escapados com uma barra invertida. É possível segmentar uma classe específica ao especificá-la. " --set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Valor da constante: "set-option"

Construtores públicos

HostTest

public HostTest ()

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 o número de casos de teste em todas as classes que fazem parte dos testes

Retorna
`int`

getAbi

public IAbi getAbi ()

Retorna
`IAbi`

getClassNames

public Set<String> getClassNames ()

Retorna
`Set<String>`

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>`

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`

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`

setAbi

public void setAbi (IAbi abi)

Parâmetros
`abi`	`IAbi`

setBuild

public void setBuild (IBuildInfo buildInfo)

Parâmetros
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Ativa ou desativa o modo de coleta de testes.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta a IConfiguration em uso.

Parâmetros
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

Injeta o dispositivo em teste.

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

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                List<String> keyValueOptions)

Auxiliar para os executores de dispositivos usarem para definir opções da mesma forma que o HostTest, de set-option.

Parâmetros
`testObj`	`Object`: o objeto que vai receber as opções.
`keyValueOptions`	`List`: a lista de opções formatada conforme exigido por HostTest set-option.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parâmetros
`testInfo`	`TestInformation`

dividir

public Collection<IRemoteTest> split (Integer shardCount, 
                TestInformation testInfo)

Dividimos por indivíduo por classe ou método de teste.

Parâmetros
`shardCount`	`Integer`: a contagem de fragmentos tentada.
`testInfo`	`TestInformation`: o `TestInformation` principal

Retorna
`Collection<IRemoteTest>`	Uma coleção de subtestes a serem executados separadamente ou `null` se o teste não puder ser fragmentado no momento.

Métodos protegidos

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Auxiliar para criar uma instância HostTest ao fazer sharding. Substituição para retornar qualquer filho de HostTest.

Parâmetros
`classObj`	`Class`

Retorna
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Receba as informações de build recebidas pelo HostTest.

Retorna
`IBuildInfo`	a solicitação `IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

Retorna o carregador de classes padrão.

Retorna
`ClassLoader`

getClasses

protected final List<Class<?>> getClasses ()

Retorna
`List<Class<?>>`

Gera
`IllegalArgumentException`

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Inspecione vários locais onde o artefato geralmente está localizado para diferentes casos de uso e encontre nosso jar.

Parâmetros
`jarName`	`String`
`testInfo`	`TestInformation`

Retorna
`File`

Gera
`FileNotFoundException`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Ajuda a determinar se estamos lidando com uma classe de teste com anotações do Junit4.

Parâmetros
`classObj`	`Class`

Retorna
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

carregue o objeto da classe e defina as informações de teste (dispositivo, build).

Parâmetros
`classObj`	`Class`

Retorna
`Object`

setClassName

protected void setClassName (String className)

Limpe e defina um nome de classe para ser executado.

Parâmetros
`className`	`String`

setMethodName

protected void setMethodName (String methodName)

Defina o nome do método a ser executado.

Usado para executar um método de teste específico de uma classe de teste.

Parâmetros
`methodName`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Verifique se um elemento com anotação passa pelo filtro. Exposto para testes de unidade.

Retorna
`boolean`	false se o teste não puder ser executado.