Glossaire de Developer Device Platform

La Developer Device Platform (DDP) est la plate-forme cloud-first de niveau commercial de Google Cloudpour l'orchestration d'appareils mobiles à distance, les tests par lot automatisés et les workflows de développement agentiques. DDP intègre l'infrastructure de la ferme d'appareils gérés directement dans l'écosystème Google Cloud . Ce glossaire fournit une référence technique alphabétique des concepts clés, des composants architecturaux, des surfaces d'API, des commandes de la CLI et des paradigmes opérationnels qui définissent la DDP.

Consultez la liste sur cette page pour découvrir la terminologie de base de Developer Device Platform et des technologies associées. Voici d'autres sources de définitions de termes clés :

A

Compétence d'agent (compétence d'agent DDP et compétence de migration)

Compétence d'agent DDP

Un ensemble d'instructions Open Source spécifiques à une tâche publié sous Google Cloud Skills sur GitHub /skills/cloud/developer-device-platform-basics. Conçue pour les assistants de codage IA tels qu'Antigravity, ChatGPT et Claude Code, la compétence d'agent DDP permet aux agents de louer des appareils distants de manière programmatique avec l'API Device Streaming, d'initialiser des daemons de transfert ADB, d'exécuter des commandes shell, de capturer des captures d'écran de tampon de trame et de déclencher des suites de tests automatisées à l'aide de la CLI gcloud device-run.

Compétence en migration

Une compétence pour migrer de Firebase Test Lab vers Developer Device Platform qui propose un mappage détaillé des options et d'autres différences, et inclut une version en texte brut destinée spécifiquement aux agents IA.

Android Test Orchestrator

Android Test Orchestrator vous permet d'exécuter chacun des tests de votre application dans son propre appel d'instrumentation. Pour en savoir plus, consultez Utiliser Android Test Orchestrator.

Ensemble d'APK (.apks)

Format d'archive de package généré par bundletool pour les Android App Bundles (AAB). DDP est compatible de manière native avec l'installation de fichiers .apks.

Service AutomationSession (API DeviceRun)

Moteur d'exécution par lot principal de DDP, hébergé sous devicerun.googleapis.com. Le service AutomationSession accepte les binaires d'application et les critères matériels dans un seul appel d'API unifié. Le backend gère l'allocation des appareils, le provisionnement de l'environnement, l'exécution du pilote de test, la collecte des journaux et le démontage en tant qu'opération atomique.

C

Modèle Cloud Storage (buckets appartenant à l'utilisateur)

Architecture de stockage de DDP où tous les artefacts d'entrée de test (APK) et les résultats de sortie sont hébergés dans des buckets de stockage appartenant au projetGoogle Cloud du développeur (par exemple, gs://<project_id>_devicerun).

D

Developer Device Platform (DDP)

Plate-forme d'entreprise deGoogle Cloudpour les tests d'appareils à distance et le développement mobile agentique, hébergée sur Google Cloud. DDP fournit une infrastructure de ferme d'appareils gérée, intégrée de manière native à la console Google Cloud , à IAM, à Cloud Billing et au SDK.

API Catalogue d'appareils

Une surface de découverte d'appareils unifiée et conforme à l'AIP, hébergée sous devicerun.googleapis.com pour les projets et les emplacements. Le catalogue d'appareils présente une collection unique et plate couvrant les appareils Android et iOS physiques et virtuels. Chaque entrée expose un ID d'appareil opaque stable, des spécifications matérielles, ainsi que des signaux de capacité et de disponibilité du parc en temps réel.

Attribut de catalogue Type de données Description
name Chaîne Chemin d'accès à la ressource (projects/my-project/locations/global/devices/device-id).
form Enum Type de matériel (PHYSICAL ou VIRTUAL).
os_version Chaîne Version de l'OS ou niveau du SDK Android (par exemple, 35 ou 17.4).
availability Message Signal de capacité du parc (HIGH, MEDIUM, LOW, NONE).

API Device Run

Le devicerun.googleapis.com global qui regroupe les tests d'appareils à distance, la découverte de catalogues et les workflows agentiques dans un service cloud natif, comme décrit dans la présentation de Device Run.

API Device Streaming

L'offre Google Cloud intégréedevicestreaming.googleapis.com, qui fournit des fonctionnalités de streaming interactif d'appareils à distance. L'API Device Streaming permet aux développeurs de diffuser en temps réel l'écran d'un appareil directement dans Android Studio.

E

Exécution

Niveau le plus bas de la hiérarchie des ressources à trois niveaux de Device Run de Developer Device Platform (Session -> Job -> Execution). Une exécution représente une tentative d'exécution concrète, générée par le système, d'une suite de tests ou d'un segment sur un appareil alloué, en capturant les journaux de sortie bruts, les journaux système et les enregistrements vidéo.

F

Flanc

Un exécuteur de tests côté client Open Source tiers populaire, développé pour optimiser l'exécution et le partitionnement des tests. DDP intègre nativement les fonctionnalités de base de Flank, y compris la configuration basée sur YAML, le partitionnement intelligent historique avancé et les nouvelles tentatives ciblées, ce qui rend les wrappers externes inutiles.

G

gcloud device-run

Interface de ligne de commande principale du SDK Google Cloud pour les tests par lot et les opérations de streaming DDP. Fonctionnant selon un modèle gcloud device-run <resource> <verb> centré sur les ressources, il fournit des commandes pour envoyer des sessions de test, interroger la disponibilité des appareils, interroger l'état d'exécution et télécharger les résultats.

J

Job

Niveau intermédiaire de la hiérarchie des ressources à trois niveaux de Device Run de Developer Device Platform (Session -> Job -> Execution). Un job associe une configuration d'automatisation spécifique (JobAction, comme un test d'instrumentation Android) à une configuration d'appareil cible. Un job unique est automatiquement étendu à plusieurs exécutions lorsque la segmentation ou les nouvelles tentatives sont activées.

N

NO_ACCESS_BLOCKED_BY_ORG_ADMIN

Tag d'état d'accès renvoyé dans le catalogue d'appareils DDP, indiquant qu'un modèle d'appareil ou un laboratoire partenaire spécifique (par exemple, du matériel OEM tiers) a été restreint par un administrateur de l'organisation à l'aide de tags Resource Manager ou de règles d'administration Google Cloud .

O

Groupes de dépendances de l'API One Platform

Fonctionnalité du plan de contrôle du service Google Cloud qui déclenche automatiquement l'activation du backend des API dépendantes. Lorsqu'un développeur active une API DDP, les groupes de dépendances s'activent automatiquement en arrière-plan.

P

Partner Device Labs

Laboratoires d'appareils distants exploités directement par les partenaires OEM de Google (comme Samsung, Xiaomi, OPPO, OnePlus, vivo et Transsion) intégrés à DDP. Les ateliers partenaires élargissent la variété du catalogue d'appareils et nécessitent une activation explicite au niveau du projet dans la consoleGoogle Cloud .

S

Nouvelle tentative séquentielle de test irrégulier

Mécanisme de nouvelle tentative économique dans DDP qui isole et ne relance que les scénarios de test individuels qui échouent dans un segment, en les exécutant de manière séquentielle par défaut plutôt qu'en relançant l'intégralité du segment simultanément.

Agent de service (compte de service)

Compte de service géré par Google Google Cloud créé automatiquement lorsque les API DDP sont activées dans un projet Google Cloud . L'agent de service DDP dispose des autorisations de service IAM pour lire de manière sécurisée les binaires de test d'entrée et écrire les journaux et vidéos de sortie de test dans les buckets Google Cloud Storage appartenant à l'utilisateur, publier des notifications d'état dans les sujets Google Cloud Pub/Sub et orchestrer les allocations de matériel dans les centres de données gérés au nom du projet.

Service Usage/Activation des API

Le sous-système de gestion des services Google Cloud responsable de l'activation et de la configuration des API Google Cloud pour un projet. L'activation de DDP nécessite des autorisations au niveau du projet ou les rôles de service devicerun.googleapis.com, devicestreaming.googleapis.com et testing.googleapis.com.

Session

Conteneur de premier niveau dans la hiérarchie des ressources de Device Run de Developer Device Platform (projects/my-project/locations/global/sessions/session-id). Une session encapsule l'envoi par lot d'un utilisateur, contenant un ou plusieurs jobs exécutés sur des matrices d'appareils ou des modules Gradle, et produit un SessionReport agrégé.

Dans l'API Device Streaming de la Developer Device Platform, un deviceSession représente une seule session de streaming d'appareil distant. Au lieu d'exécuter des scripts par lot jusqu'à leur terme, l'API Device Streaming réserve un seul appareil et ouvre une connexion bidirectionnelle en direct afin qu'un ingénieur ou un agent IA puisse voir l'écran et contrôler l'appareil en temps réel.

Segmentation intelligente

Mécanisme de partitionnement intelligent des tests dans Device Run (--sharding-option=smart) de Developer Device Platform. Le sharding intelligent analyse jusqu'à 30 jours de données d'historique d'exécution des tests, suit les environnements d'exécution par modèle d'appareil spécifique et tient compte de la surcharge de démarrage d'Android Test Orchestrator pour répartir les suites de tests dans des segments équilibrés ciblant une durée spécifiée.

U

Segmentation uniforme

Stratégie de distribution de test (--sharding-option=uniform --uniform-sharding-count=N) dans Device Run de Developer Device Platform qui partitionne une suite de tests d'instrumentation Android sur un nombre fixe de segments ($N$) à l'aide des paramètres natifs -e numShards et -e shardIndex d'AndroidJUnitRunner.