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.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

CtsTestLauncher

public class CtsTestLauncher
extends Object implements IBuildReceiver, IConfigurationReceiver, IDeviceTest, IInvocationContextReceiver, IMetricCollectorReceiver, IRemoteTest, IShardableTest

java.lang.Object
↳	com.google.android.tradefed.testtype.CtsTestLauncher

Um IRemoteTest para executar testes em uma instalação separada do CTS.

Inicia um processo Java externo para executar os testes. Usado para executar uma versão específica baixada do CTS e da configuração dele. Ele vai usar a versão atual do tradefed que o inicia para concluir os jars ausentes.

Resumo

Construtores públicos
`CtsTestLauncher()`
`CtsTestLauncher(int shardCount, int shardIndex)`

Métodos públicos
`String`	`buildClasspath()` Cria o classpath usado pelo subprocesso para executar o CTS.
`List<String>`	`buildJavaCmd(String classpath)` Cria a linha de comando Java que será executada em um subprocesso.
`String`	`getConfigName()`
`ITestDevice`	`getDevice()` Pega o dispositivo em teste.
`CommandResult`	`getResult()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Executa os testes e informa o resultado ao listener.
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setConfigName(String config)`
`void`	`setConfiguration(IConfiguration configuration)` Injeta a `IConfiguration` em uso.
`void`	`setCtsVersion(int version)`
`void`	`setDevice(ITestDevice device)` Injeta o dispositivo em teste.
`void`	`setInvocationContext(IInvocationContext invocationContext)`
`void`	`setMetricCollectors(List<IMetricCollector> collectors)` Define a lista de `IMetricCollector`s definidos para a execução do teste.
`Collection<IRemoteTest>`	`split(int shardCountHint)` Versão alternativa de `split()` que também fornece o shardCount, cuja tentativa de execução está em andamento.

Métodos protegidos
`IRunUtil`	`getRunUtil()`
`String`	`getSystemJava()`
`void`	`setRunAsRoot(boolean runAsRoot)`

Construtores públicos

CtsTestLauncher

public CtsTestLauncher ()

CtsTestLauncher

public CtsTestLauncher (int shardCount, 
                int shardIndex)

Parâmetros
`shardCount`	`int`
`shardIndex`	`int`

Métodos públicos

buildClasspath

public String buildClasspath ()

Cria o classpath usado pelo subprocesso para executar o CTS.

Retorna
`String`	Uma string com o caminho de classe completo.

Gera
`IOException`

buildJavaCmd

public List<String> buildJavaCmd (String classpath)

Cria a linha de comando Java que será executada em um subprocesso.

Parâmetros
`classpath`	`String`: classpath Java para os arquivos JAR necessários para a execução do CTS/XTS.

Retorna
`List<String>`	Um ArrayList com a linha de comando e os parâmetros do Java.

Gera
`DeviceNotAvailableException`

getConfigName

public String getConfigName ()

Retorna
`String`

getDevice

public ITestDevice getDevice ()

Pega o dispositivo em teste.

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

getResult

public CommandResult getResult ()

Retorna
`CommandResult`

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`

setBuild

public void setBuild (IBuildInfo buildInfo)

Parâmetros
`buildInfo`	`IBuildInfo`

setConfigName

public void setConfigName (String config)

Parâmetros
`config`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injeta a IConfiguration em uso.

Parâmetros
`configuration`	`IConfiguration`

setCtsVersion

public void setCtsVersion (int version)

Parâmetros
`version`	`int`

setDevice

public void setDevice (ITestDevice device)

Injeta o dispositivo em teste.

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

setInvocationContext

public void setInvocationContext (IInvocationContext invocationContext)

Parâmetros
`invocationContext`	`IInvocationContext`

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> collectors)

Define a lista de IMetricCollectors definidos para a execução do teste.

Parâmetros
`collectors`	`List`

dividir

public Collection<IRemoteTest> split (int shardCountHint)

Versão alternativa de split() que também fornece o shardCount, cuja tentativa de execução está em andamento. Isso é útil para alguns executores de teste que, em alguns cenários, não conseguem decidir sem um critério explícito.

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

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

getRunUtil

protected IRunUtil getRunUtil ()

Retorna
`IRunUtil`

getSystemJava

protected String getSystemJava ()

Retorna
`String`

setRunAsRoot

protected void setRunAsRoot (boolean runAsRoot)

Parâmetros
`runAsRoot`	`boolean`