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.

ClusterClient

public class ClusterClient
extends Object implements IClusterClient

java.lang.Object
↳	com.android.tradefed.cluster.ClusterClient

Uma implementação de IClusterClient para interagir com o back-end do TFC.

Resumo

Construtores públicos
`ClusterClient()`

Métodos públicos
`IClusterEventUploader<ClusterCommandEvent>`	`getCommandEventUploader()` Receba um `IClusterEventUploader` que pode ser usado para fazer upload de `ClusterCommandEvent`s.
`ClusterCommand.State`	`getCommandState(String requestId, String commandId)` Determina o estado de um comando de cluster.
`ClusterCommandStatus`	`getCommandStatus(String requestId, String commandId)` Recebe o status de um comando de cluster (o estado e o motivo do cancelamento, se cancelado).
`IClusterEventUploader<ClusterHostEvent>`	`getHostEventUploader()` Receba um `IClusterEventUploader` que pode ser usado para fazer upload de `ClusterHostEvent`s.
`TestContext`	`getTestContext(String requestId, String commandId)`
`TestEnvironment`	`getTestEnvironment(String requestId)` Receba `TestEnvironment` para uma solicitação.
`List<TestResource>`	`getTestResources(String requestId)` Receba `TestResource`s para uma solicitação.
`List<ClusterCommand>`	`leaseHostCommands(String clusterId, String hostname, List<ClusterDeviceInfo> deviceInfos, List<String> nextClusterIds, int maxTasksTolease)` Locação `ClusterCommand` para o host especificado.
`void`	`updateTestContext(String requestId, String commandId, TestContext testContext)`

Construtores públicos

ClusterClient

public ClusterClient ()

Métodos públicos

getCommandEventUploader

public IClusterEventUploader<ClusterCommandEvent> getCommandEventUploader ()

Receba um IClusterEventUploader que pode ser usado para fazer upload de ClusterCommandEvents.

Retorna
`IClusterEventUploader<ClusterCommandEvent>`

getCommandState

public ClusterCommand.State getCommandState (String requestId, 
                String commandId)

Determina o estado de um comando de cluster.

Parâmetros
`requestId`	`String`: ID da solicitação do cluster
`commandId`	`String`: ID do comando do cluster

Retorna
`ClusterCommand.State`	o estado do comando do cluster ou `ClusterCommand.State.UNKNOWN` se não for possível determinar o estado

getCommandStatus

public ClusterCommandStatus getCommandStatus (String requestId, 
                String commandId)

Recebe o status de um comando de cluster (o estado e o motivo do cancelamento, se cancelado).

Parâmetros
`requestId`	`String`: ID da solicitação do cluster
`commandId`	`String`: ID do comando do cluster

Retorna
`ClusterCommandStatus`	um ClusterCommandStatus que representa o estado e o motivo do cancelamento se o comando for cancelado. O estado é `ClusterCommand.State.UNKNOWN` se não for possível determinar.

getHostEventUploader

public IClusterEventUploader<ClusterHostEvent> getHostEventUploader ()

Receba um IClusterEventUploader que pode ser usado para fazer upload de ClusterHostEvents.

Retorna
`IClusterEventUploader<ClusterHostEvent>`

getTestContext

public TestContext getTestContext (String requestId, 
                String commandId)

Parâmetros
`requestId`	`String`
`commandId`	`String`

Retorna
`TestContext`

Gera
`IOException`
`JSONException`

getTestEnvironment

public TestEnvironment getTestEnvironment (String requestId)

Receba TestEnvironment para uma solicitação.

Retorna
`TestEnvironment`	um objeto `TestEnvironment`.

Gera
`IOException`
`JSONException`

getTestResources

public List<TestResource> getTestResources (String requestId)

Receba TestResources para uma solicitação.

Retorna
`List<TestResource>`	uma lista de `TestResource`.

Gera
`IOException`
`JSONException`

leaseHostCommands

public List<ClusterCommand> leaseHostCommands (String clusterId, 
                String hostname, 
                List<ClusterDeviceInfo> deviceInfos, 
                List<String> nextClusterIds, 
                int maxTasksTolease)

Locação ClusterCommand para o host especificado.

Parâmetros
`clusterId`	`String`: ID do cluster para o host
`hostname`	`String`: nome do host
`deviceInfos`	`List`: deviceInfos que o host tem
`nextClusterIds`	`List`: uma lista de IDs de próximos clusters para comandos de concessão.
`maxTasksTolease`	`int`: o número máximo de tarefas que podem ser alugadas no momento.

Retorna
`List<ClusterCommand>`	uma lista de `ClusterCommand`

Gera
`JSONException`

updateTestContext

public void updateTestContext (String requestId, 
                String commandId, 
                TestContext testContext)

Parâmetros
`requestId`	`String`
`commandId`	`String`
`testContext`	`TestContext`

Gera
`IOException`
`JSONException`