Glossario di Developer Device Platform

La Developer Device Platform (DDP) rappresenta la piattaforma cloud-first di livello commerciale di Google Cloudper l'orchestrazione remota dei dispositivi mobili, i test batch automatizzati e i workflow di sviluppo agentici. DDP integra l'infrastruttura della farm di dispositivi gestiti direttamente nell'ecosistema Google Cloud . Questo glossario fornisce un riferimento tecnico alfabetico dei concetti chiave, dei componenti dell'architettura, delle superfici API, dei comandi dell'interfaccia a riga di comando e dei paradigmi operativi che definiscono la piattaforma DDP.

Consulta l'elenco in questa pagina per conoscere la terminologia di base della Developer Device Platform e delle tecnologie correlate. Ecco altre fonti per le definizioni dei termini chiave:

A

Skill dell'agente (skill dell'agente DDP e skill di migrazione)

Skill dell'agente DDP

Un set di istruzioni open source specifico per le attività pubblicato in Google Cloud Skills su GitHub /skills/cloud/developer-device-platform-basics. Progettata per gli assistenti di coding AI come Antigravity, ChatGPT e Claude Code, la skill dell'agente DDP consente agli agenti di noleggiare in modo programmatico dispositivi remoti con l'API Device Streaming, inizializzare i daemon di forwarding ADB, eseguire comandi shell, acquisire screenshot del frame buffer e attivare suite di test automatizzate utilizzando l'interfaccia a riga di comando gcloud device-run.

Competenze di migrazione

Una skill per la migrazione da Firebase Test Lab a Developer Device Platform che offre una mappatura dettagliata dei flag e di altre differenze e include una versione in testo normale rivolta specificamente agli agenti AI.

Android Test Orchestrator

Android Test Orchestrator ti consente di eseguire ogni test della tua app all'interno della propria chiamata di strumentazione. Scopri di più su Utilizza Android Test Orchestrator.

Set di APK (.apks)

Un formato di archivio di pacchetti generato da bundletool per Android App Bundle (AAB). DDP supporta in modo nativo l'installazione di file .apks.

Servizio AutomationSession (API DeviceRun)

Il motore di esecuzione batch principale di DDP, ospitato in devicerun.googleapis.com. Il servizio AutomationSession accetta i file binari dell'applicazione e i criteri hardware in un'unica chiamata API unificata. Il backend gestisce l'allocazione dei dispositivi, il provisioning dell'ambiente, l'esecuzione dei driver di test, la raccolta dei log e l'eliminazione come operazione atomica.

C

Modello Cloud Storage (bucket di proprietà dell'utente)

L'architettura di archiviazione di DDP, in cui tutti gli artefatti di input dei test (APK) e i risultati di output sono ospitati all'interno di bucket di archiviazione di proprietà del progettoGoogle Cloud dello sviluppatore (ad es. gs://<project_id>_devicerun).

D

Developer Device Platform (DDP)

La piattaforma aziendale diGoogle Cloudper i test dei dispositivi remoti e lo sviluppo mobile basato su agenti, ospitata su Google Cloud. DDP fornisce un'infrastruttura di farm di dispositivi gestiti integrata in modo nativo con la console Google Cloud , IAM, la fatturazione Cloud e l'SDK.

API Catalogo dei dispositivi

Una piattaforma unificata di rilevamento dei dispositivi conforme ad AIP ospitata in devicerun.googleapis.com per progetti e località. Il catalogo dei dispositivi presenta un'unica raccolta piatta che copre i dispositivi Android e i dispositivi iOS fisici e virtuali. Ogni voce espone un ID dispositivo opaco stabile, specifiche hardware e indicatori di capacità e disponibilità del parco risorse in tempo reale.

Attributo catalogo Tipo di dati Descrizione
name Stringa Percorso della risorsa (projects/my-project/locations/global/devices/device-id).
form Enum Tipo di hardware (PHYSICAL o VIRTUAL).
os_version Stringa Release del sistema operativo o livello SDK Android (ad es. 35 o 17.4).
availability Messaggio Indicatore di capacità del parco risorse (HIGH, MEDIUM, LOW, NONE).

API Device Run

La struttura devicerun.googleapis.com che consolida i test dei dispositivi remoti, la scoperta del catalogo e i flussi di lavoro agentici in un servizio cloud-native, come descritto nella panoramica di Device Run.

API Device Streaming

L'offerta integrata Google Cloud devicestreaming.googleapis.com che fornisce funzionalità di streaming interattivo dei dispositivi remoti. L'API Device Streaming consente agli sviluppatori di trasmettere in streaming i display dei dispositivi in tempo reale direttamente in Android Studio.

E

Esecuzione

Il livello più basso nella gerarchia delle risorse a tre livelli di Device Run di Developer Device Platform (Session -> Job -> Execution). Un'esecuzione rappresenta un tentativo di runtime concreto, generato dal sistema, di eseguire una suite di test o uno shard su un dispositivo allocato, acquisendo log di output non elaborati, log di sistema e registrazioni video.

F

Flank

Un popolare test runner lato client open source di terze parti sviluppato per ottimizzare l'esecuzione del test e lo sharding. DDP assorbe in modo nativo le funzionalità principali di Flank, tra cui la configurazione basata su YAML, lo smart sharding storico avanzato e i nuovi tentativi mirati, rendendo superflui i wrapper esterni.

G

gcloud device-run

L'interfaccia a riga di comando principale dell'SDK Google Cloud per le operazioni di test batch e streaming di DDP. Operando su un pattern gcloud device-run <resource> <verb> incentrato sulle risorse, fornisce comandi per inviare sessioni di test, eseguire query sulla disponibilità dei dispositivi, eseguire il polling dello stato di esecuzione e scaricare i risultati.

J

Job

Il livello intermedio nella gerarchia delle risorse a tre livelli di Device Run di Developer Device Platform (Session -> Job -> Execution). Un job associa una configurazione di automazione specifica (JobAction, ad esempio un test di instrumentazione Android) a una configurazione dispositivo di destinazione. Un singolo job si espande automaticamente in più esecuzioni quando sono abilitati lo sharding o i nuovi tentativi.

N

NO_ACCESS_BLOCKED_BY_ORG_ADMIN

Un tag dello stato di accesso restituito nel catalogo dei dispositivi DDP che indica che un modello di dispositivo specifico o un lab partner (ad es. hardware OEM di terze parti) è stato limitato da un Amministratore organizzazione utilizzando i tag di Google Cloud Resource Manager o le policy dell'organizzazione.

O

Gruppi di dipendenze dell'API One Platform

Una funzionalità del control plane del servizio Google Cloud che attiva automaticamente l'attivazione del backend delle API dipendenti. Quando uno sviluppatore attiva un'API DDP, i gruppi di dipendenze si attivano automaticamente in background.

P

Partner Device Labs

Lab di dispositivi remoti gestiti direttamente dai partner OEM di Google (come Samsung, Xiaomi, OPPO, OnePlus, vivo, Transsion) integrati in DDP. I lab dei partner ampliano la varietà del catalogo dei dispositivi e richiedono l'attivazione esplicita a livello di progetto nella consoleGoogle Cloud .

S

Nuovo tentativo di test instabile sequenziale

Un meccanismo di ripetizione dei tentativi in DDP che consente di risparmiare sui costi, isolando e ripetendo solo i singoli scenari di test con errori all'interno di uno shard, eseguendoli in sequenza per impostazione predefinita anziché rieseguire l'intero shard contemporaneamente.

Service agent (service account)

Un service account Google Cloud gestito da Google creato automaticamente quando le API DDP vengono abilitate in un progetto Google Cloud . L'agente di servizio DDP dispone delle autorizzazioni di servizio IAM per leggere in modo sicuro i file binari di test di input e scrivere i log e i video di output dei test nei bucket Google Cloud Storage di proprietà dell'utente, pubblicare notifiche di stato negli argomenti Pub/Sub Google Cloud e orchestrare le allocazioni hardware nei data center gestiti per conto del progetto.

Service Usage/Abilitazione delle API

Il sottosistema di gestione dei servizi Google Cloud responsabile dell'abilitazione e della configurazione delle API Google Cloud per un progetto. L'attivazione di DDP richiede autorizzazioni a livello di progetto o i ruoli di servizio devicerun.googleapis.com, devicestreaming.googleapis.com e testing.googleapis.com.

Sessione

Il contenitore di primo livello nella gerarchia delle risorse di Device Run di Developer Device Platform (projects/my-project/locations/global/sessions/session-id). Una sessione incapsula l'invio in batch di un utente, contenente uno o più job eseguiti su matrici di dispositivi o moduli Gradle, e produce un SessionReport aggregato.

Nell'API Device Streaming di Developer Device Platform, un deviceSession rappresenta una singola sessione di streaming da un dispositivo remoto. Anziché eseguire script batch fino al completamento, l'API Device Streaming prenota un singolo dispositivo e apre una connessione bidirezionale in tempo reale, in modo che un ingegnere o un agente AI possa visualizzare lo schermo e controllare il dispositivo in tempo reale.

Sharding intelligente

Un meccanismo di partizionamento dei test intelligente in Developer Device Platform Device Run (--sharding-option=smart). Lo Smart Sharding analizza fino a 30 giorni di dati storici sull'esecuzione dei test, monitora i runtime per un modello di dispositivo specifico e tiene conto dell'overhead di avvio di Android Test Orchestrator per distribuire le suite di test in shard bilanciati che hanno come target una durata specificata.

U

Sharding uniforme

Una strategia di distribuzione dei test (--sharding-option=uniform --uniform-sharding-count=N) in Device Run di Developer Device Platform che suddivide una suite di test di instrumentazione Android in un numero fisso di shard ($N$) utilizzando i parametri nativi -e numShards e -e shardIndex di AndroidJUnitRunner.