Glossário da Developer Device Platform

A Developer Device Platform (DDP) é a plataforma de nível comercial e priorização da nuvem do Google Cloudpara orquestração remota de dispositivos móveis, testes em lote automatizados e fluxos de trabalho de desenvolvimento com agentes. O DDP integra a infraestrutura de farm de dispositivos gerenciados diretamente ao ecossistema do Google Cloud . Este glossário fornece uma referência técnica em ordem alfabética dos principais conceitos, componentes arquitetônicos, superfícies de API, comandos da CLI e paradigmas operacionais que definem o DDP.

Confira a lista nesta página para saber mais sobre a terminologia básica da Developer Device Platform e tecnologias relacionadas. Veja outras fontes para definições de termos-chave:

A

Habilidade do agente (habilidade do agente de DDP e habilidade de migração)

Habilidade do agente de DDP

Um conjunto de instruções de código aberto específico para tarefas publicado em Google Cloud Skills no GitHub /skills/cloud/developer-device-platform-basics. Projetada para assistentes de programação com IA, como Antigravity, ChatGPT e Claude Code, a habilidade de agente do DDP permite que os agentes aluguem dispositivos remotos de forma programática com a API Device Streaming, inicializem daemons de encaminhamento do ADB, executem comandos shell, capturem capturas de tela do buffer de frames e acionem pacotes de testes automatizados usando a CLI gcloud device-run.

Habilidade de migração

Uma habilidade para migrar do Firebase Test Lab para a Developer Device Platform que oferece um mapeamento detalhado de flags e outras diferenças e inclui uma versão em texto simples voltada especificamente para agentes de IA.

Android Test Orchestrator

O Android Test Orchestrator permite executar cada um dos testes do app na própria invocação de instrumentação. Confira mais detalhes em Usar o Android Test Orchestrator.

Conjunto de APKs (.apks)

Um formato de arquivo empacotado gerado por bundletool para Android App Bundles (AAB). O DDP oferece suporte nativo à instalação de arquivos .apks.

Serviço AutomationSession (API DeviceRun)

O mecanismo principal de execução em lote do DDP, hospedado em devicerun.googleapis.com. O serviço AutomationSession aceita binários de aplicativos e critérios de hardware em uma única chamada de API unificada. O back-end lida com a alocação de dispositivos, o provisionamento de ambiente, a execução do driver de teste, a coleta de registros e a desmontagem como uma operação atômica.

C

Modelo do Cloud Storage (buckets de propriedade do usuário)

A arquitetura de armazenamento do DDP, em que todos os artefatos de entrada de teste (APKs) e resultados de saída são hospedados em buckets de armazenamento do projeto doGoogle Cloud do desenvolvedor (por exemplo, gs://<project_id>_devicerun).

D

Developer Device Platform (DDP)

Plataforma empresarial doGoogle Cloudpara testes de dispositivos remotos e desenvolvimento de agentes para dispositivos móveis, hospedada no Google Cloud. O DDP oferece infraestrutura de farm de dispositivos gerenciados integrada de forma nativa ao console do Google Cloud , ao IAM, ao Cloud Billing e ao SDK.

API do Catálogo de Dispositivos

Uma superfície unificada de descoberta de dispositivos compatível com AIP hospedada em devicerun.googleapis.com para projetos e locais. O Catálogo de dispositivos apresenta uma única coleção simples que abrange dispositivos Android e iOS físicos e virtuais. Cada entrada expõe um ID de dispositivo opaco estável, especificações de hardware e indicadores de capacidade e disponibilidade da frota em tempo real.

Atributo de catálogo Tipo de dados Descrição
name String Caminho do recurso (projects/my-project/locations/global/devices/device-id).
form Enum Tipo de hardware (PHYSICAL ou VIRTUAL).
os_version String Versão do SO ou nível do SDK do Android (por exemplo, 35 ou 17.4).
availability Mensagem Sinal de capacidade da frota (HIGH, MEDIUM, LOW, NONE).

API Device Run

O guarda-chuva devicerun.googleapis.com que consolida testes de dispositivos remotos, descoberta de catálogos e fluxos de trabalho agênticos em um serviço nativo da nuvem, conforme descrito na visão geral do Device Run.

API Device Streaming

A oferta integrada do Google Cloud devicestreaming.googleapis.com que oferece recursos interativos de streaming de dispositivos remotos. A API Device Streaming permite que os desenvolvedores transmitam telas de dispositivos em tempo real diretamente para o Android Studio.

E

Execução

O nível mais baixo na hierarquia de recursos de três níveis do Device Run da Developer Device Platform (Session -> Job -> Execution). Uma execução representa uma tentativa de execução concreta, gerada pelo sistema, para executar um pacote de testes ou fragmento em um dispositivo alocado, capturando registros de saída brutos, registros do sistema e gravações de vídeo.

F

Flanco

Um executor de testes de código aberto terceirizado e conhecido, desenvolvido para otimizar a execução e a fragmentação de testes. O DDP absorve nativamente os principais recursos do Flank, incluindo configuração baseada em YAML, fragmentação inteligente histórica avançada e novas tentativas direcionadas, tornando desnecessários os wrappers externos.

G

gcloud device-run

A interface de linha de comando principal do SDK do Google Cloud para testes em lote e operações de streaming do DDP. Operando em um padrão gcloud device-run <resource> <verb> centrado em recursos, ele fornece comandos para enviar sessões de teste, consultar a disponibilidade do dispositivo, pesquisar o status de execução e fazer o download dos resultados.

J

Job

O nível intermediário na hierarquia de recursos de três níveis do Device Run da Developer Device Platform (Session -> Job -> Execution). Um job combina uma configuração de automação específica (JobAction, como um teste de instrumentação do Android) com uma configuração de dispositivo de destino. Um único job é expandido automaticamente em várias execuções quando a fragmentação ou as novas tentativas estão ativadas.

N

NO_ACCESS_BLOCKED_BY_ORG_ADMIN

Uma tag de status de acesso retornada no catálogo de dispositivos do DDP que indica que um modelo de dispositivo específico ou laboratório de parceiro (por exemplo, hardware OEM de terceiros) foi restringido por um administrador da organização usando tags do Resource Manager Google Cloud ou políticas da organização.

O

Grupos de dependência da API One Platform

Um recurso do plano de controle de serviço do Google Cloud que aciona automaticamente a ativação de back-end de APIs dependentes. Quando um desenvolvedor ativa uma API DDP, os grupos de dependência são ativados automaticamente em segundo plano.

P

Laboratórios de dispositivos de parceiros

Laboratórios de dispositivos remotos operados diretamente por parceiros OEM do Google (como Samsung, Xiaomi, OPPO, OnePlus, vivo, Transsion) integrados ao DDP. Os laboratórios de parceiros expandem a variedade do catálogo de dispositivos e exigem ativação explícita para envolvidos no projeto no console doGoogle Cloud .

S

Nova tentativa de teste instável sequencial

Um mecanismo de nova tentativa econômico na DDP que isola e tenta novamente apenas casos de teste com falha individuais em um fragmento, executando-os sequencialmente por padrão, em vez de executar novamente todo o fragmento ao mesmo tempo.

Agente de serviço (conta de serviço)

Uma conta de serviço do Google Cloud gerenciada pelo Google criada automaticamente quando as APIs do DDP são ativadas em um projeto do Google Cloud . O agente de serviço do DDP tem permissões de serviço do IAM para ler com segurança binários de teste de entrada e gravar registros e vídeos de saída de teste em buckets do Google Cloud Storage de propriedade do usuário, publicar notificações de status em tópicos do Google Cloud Pub/Sub e orquestrar alocações de hardware em data centers gerenciados em nome do projeto.

Service Usage / Ativação de API

O subsistema de gerenciamento de serviços do Google Cloud responsável por ativar e configurar as APIs do Google Cloud para um projeto. A ativação do DDP requer permissões para envolvidos no projeto ou os papéis de serviço devicerun.googleapis.com, devicestreaming.googleapis.com e testing.googleapis.com.

Sessão

O contêiner de nível superior na hierarquia de recursos do Device Run da Developer Device Platform (projects/my-project/locations/global/sessions/session-id). Uma sessão encapsula o envio em lote de um usuário, contendo um ou mais jobs executados em matrizes de dispositivos ou módulos do Gradle, e produz um SessionReport agregado.

Na API Device Streaming da Plataforma de Dispositivos para Desenvolvedores, um deviceSession representa uma única sessão de streaming de dispositivo remoto. Em vez de executar scripts em lote até a conclusão, a API Device Streaming reserva um único dispositivo e abre uma conexão bidirecional em tempo real para que um engenheiro ou agente de IA possa visualizar a tela e controlar o dispositivo em tempo real.

Fragmentação inteligente

Um mecanismo inteligente de particionamento de testes no Device Run (--sharding-option=smart) da Developer Device Platform. A fragmentação inteligente analisa até 30 dias de dados históricos de execução do teste, rastreia os tempos de execução por modelo de dispositivo específico e considera a sobrecarga de inicialização do Android Test Orchestrator para distribuir pacotes de testes em fragmentos equilibrados que visam uma duração especificada.

U

Fragmentação uniforme

Uma estratégia de distribuição de teste (--sharding-option=uniform --uniform-sharding-count=N) no Device Run da Developer Device Platform que particiona um pacote de testes de instrumentação do Android em um número fixo de fragmentos ($N$) usando os parâmetros nativos -e numShards e -e shardIndex do AndroidJUnitRunner.