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

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

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Configure-se para usar a plataforma de dispositivos para desenvolvedores, um pacote de última geração de nível comercial para orquestração remota de dispositivos.

Se você estiver migrando do Firebase Test Lab para a Developer Device Platform, consulte nosso guia de migração, a tradução de comandos e flags e a habilidade de migração para agentes de IA.

Antes de começar

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

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

Configuração doGoogle Cloud

Observação: a API Cloud Testing é obrigatória para a API Device Streaming durante a prévia.

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho sem custos financeiros.

Instale a CLI do Google Cloud.

Observação:se você já instalou a CLI gcloud, execute o comando gcloud components update para verificar se tem a versão mais recente.

Ao usar um provedor de identidade (IdP) externo, primeiro faça 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 projeto do Google Cloud .

Ative as APIs Device Run, Device Streaming e Cloud Testing, se alguma delas ainda não estiver ativada:

Funções necessárias para ativar APIs

Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com

Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário:

gcloud auth application-default login

Não é necessário fazer isso se você estiver usando o Cloud Shell.

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.

Instale a CLI do Google Cloud.

Observação:se você já instalou a CLI gcloud, execute o comando gcloud components update para verificar se tem a versão mais recente.

Ao usar um provedor de identidade (IdP) externo, primeiro faça 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 projeto do Google Cloud .

Ative as APIs Device Run, Device Streaming e Cloud Testing, se alguma delas ainda não estiver ativada:

Funções necessárias para ativar APIs

Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

gcloud services enable devicerun.googleapis.com devicestreaming.googleapis.com testing.googleapis.com

Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário:

gcloud auth application-default login

Não é necessário fazer isso se você estiver usando o Cloud Shell.

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 Plataforma de Dispositivos para Desenvolvedores, peça ao administrador para conceder a você os seguintes papéis do IAM no seu projeto:

• Todos:
  • Leitor de papéis (roles/viewer)
  • Administrador do Device Run (roles/devicerun.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 usando 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 beta device-run devices list

Em seguida, filtre os dispositivos que executam um sistema operacional específico:

Android

gcloud beta device-run devices list --filter="PLATFORM=ANDROID"

iOS

gcloud beta device-run devices list --filter="PLATFORM=iOS"

Por fim, liste todas as sessões do projeto (provavelmente não há nenhuma, tente mais tarde):

gcloud beta device-run sessions list

Agora, siga as instruções do recurso em Próximas etapas.

Documentação de apoio

• Google Cloud README de habilidades
• Repositório de habilidades do agente do Developer Device Platform

Entre em contato

Acesse o Fórum de desenvolvedores do DDP para receber ajuda e oferecer sugestões.

Para reportar bugs e registrar solicitações de recursos para a Developer Device Platform, crie um problema.

Limpar

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

A seguir

• Catálogo de dispositivos: descreva todos os tipos de dispositivo no laboratório da Developer Device Platform e analise cada tipo.
• Device Run: execute testes em dispositivos no laboratório Developer Device Platform usando dispositivos Android e iOS.
• Share Storage: conceda à plataforma de dispositivos para desenvolvedores acesso aos seus buckets atuais do Cloud Storage.
• Encontrar registros: confira os resultados na linha de comando e no console do 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 agêntico com streaming de dispositivos: use a habilidade de agente da Developer Device Platform para encontrar, reservar e conectar dispositivos na Developer Device Platform.