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.

Guia de início rápido: preparar-se para a Developer Device Platform

Configure-se para usar a Developer Device Platform, um pacote de nível comercial de última geração para orquestração de dispositivos remotos.

Antes de começar

A Developer Device Platform funciona em qualquer estação de trabalho com um terminal e acesso à Internet seguindo as instruções desta página.

Estes documentos pressupõem que você é um Google Cloud usuário com projetos e contas, conforme descrito em Introdução Google Cloud encontrado na Visão geral guia deste site.

Google Cloud configuração

Instale a Google Cloud CLI.

Observação: se você já tiver instalado a CLI gcloud anteriormente, verifique se você tem a versão mais recente executando gcloud components update.
Configure a CLI gcloud para usar sua identidade federada.

Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.
Para inicializar a CLI gcloud, execute o seguinte comando:
```
gcloud init
```
Verifique se você tem as permissões necessárias para concluir este guia.
Verifique se o faturamento está ativado para o Google Cloud projeto.
Ative as APIs Device Run, Device Streaming e Cloud Testing:
Funções necessárias para ativar APIs
Para ativar as APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pela função de proprietário (roles/owner). Caso contrário, você pode receber essa permissão pela função de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder funções.
```
gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com
```

Crie credenciais de autenticação local para sua conta de usuário:
```
gcloud auth application-default login
```
Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

Funções exigidas

Para receber as permissões necessárias para usar a Developer Device Platform, peça que o administrador conceda a você as seguintes funções do IAM no projeto:

Todas:
- Leitor de papéis (roles/viewer)
- Administrador do Device Run (roles/devicerun.googleapis.com/admin)
- Administrador do Device Streaming (roles/devicestreaming.admin)
- Consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Exemplos de comandos

Agora que você tem o serviço Device Run, execute os comandos a seguir para testar o catálogo.

Primeiro, liste todos os dispositivos no seu projeto:

gcloud device-run devices list

Em seguida, liste todas as sessões no seu projeto (provavelmente nenhuma):

gcloud device-run sessions

Agora, continue com as instruções de recursos em Próximas etapas ou siga a próxima seção para usar a habilidade do agente da Developer Device Platform.

Instalar a habilidade do agente da Developer Device Platform

Além de estabelecer o Google Cloud ambiente descrito nesta página, você precisará instalar estes pacotes para a habilidade do agente da Developer Device Platform:

ADB para executar comandos no dispositivo Android remoto
um ambiente Python para ativar o encaminhamento de ADB
Antigravity ou qualquer outro agente de codificação de IA que ofereça suporte a habilidades de agente
Node.js e o pacote NPM para instalar a habilidade do agente usando npx

Agora instale a habilidade do agente da Developer Device Platform com:

npx skills add https://github.com/google/skills --skill developer-device-platform-basics

Agora, continue com as instruções de recursos em Próximas etapas.

Documentação de apoio

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, exclua o Google Cloud projeto do e os recursos.

A seguir

Catálogo de dispositivos: descreva todos os tipos de dispositivos no laboratório DDP e aprofunde-se em cada tipo
Device Run: execute testes em dispositivos no laboratório DDP e confira os resultados em Google Cloud
API Device Streaming: conecte-se a dispositivos Android físicos remotos e interaja com seu app como se ele estivesse conectado à sua máquina local
Desenvolvimento de agentes com o Device Streaming: use a habilidade do agente da Developer Device Platform para encontrar, reservar e conectar-se a dispositivos no DDP