Glosario de Developer Device Platform

La Developer Device Platform (DDP) representa la plataforma de nivel comercial y centrada en la nube de Google Cloudpara la organización remota de dispositivos móviles, las pruebas por lotes automatizadas y los flujos de trabajo de desarrollo basados en agentes. DDP integra la infraestructura de granjas de dispositivos administrados directamente en el ecosistema de Google Cloud . En este glosario, se proporciona una referencia técnica alfabética de los conceptos clave, los componentes de la arquitectura, las plataformas de la API, los comandos de la CLI y los paradigmas operativos que definen la DDP.

Consulta la lista de esta página para conocer la terminología básica de Developer Device Platform y las tecnologías relacionadas. A continuación, se incluyen otras fuentes para las definiciones de términos clave:

A

Habilidad de agente (habilidad de agente de DDP y habilidad de migración)

Habilidad de agente de DDP

Un conjunto de instrucciones específico para tareas de código abierto publicado en Google Cloud Skills en GitHub /skills/cloud/developer-device-platform-basics. Diseñada para asistentes de programación con IA, como Antigravity, ChatGPT y Claude Code, la habilidad de agente de DDP permite que los agentes alquilen dispositivos remotos de forma programática con la API de Device Streaming, inicialicen daemons de reenvío de ADB, ejecuten comandos de shell, capturen capturas de pantalla del búfer de fotogramas y activen paquetes de pruebas automatizados con la CLI de gcloud device-run.

Habilidad de migración

Una habilidad para migrar de Firebase Test Lab a Developer Device Platform que ofrece una asignación detallada de marcas y otras diferencias, y que incluye una versión de texto sin formato dirigida específicamente a agentes de IA.

Android Test Orchestrator

Android Test Orchestrator te permite ejecutar cada una de las pruebas de tu app dentro de su propia invocación de instrumentación. Para obtener más detalles, consulta Cómo usar Android Test Orchestrator.

Conjunto de APK (.apks)

Es un formato de archivo de paquete que genera bundletool para Android App Bundles (AAB). DDP admite de forma nativa la instalación de archivos .apks.

Servicio AutomationSession (API de DeviceRun)

Es el motor de ejecución de lotes principal de DDP, alojado en devicerun.googleapis.com. El servicio AutomationSession acepta objetos binarios de la aplicación y criterios de hardware en una sola llamada a la API unificada. El backend controla la asignación de dispositivos, el aprovisionamiento del entorno, la ejecución del controlador de pruebas, la recopilación de registros y la eliminación como una operación atómica.

C

Modelo de Cloud Storage (buckets propiedad del usuario)

La arquitectura de almacenamiento de DDP, en la que todos los artefactos de entrada de prueba (APK) y los resultados de salida se alojan en buckets de almacenamiento que pertenecen al proyecto deGoogle Cloud del desarrollador (p.ej., gs://<project_id>_devicerun).

D

Developer Device Platform (DDP)

Es la plataforma empresarial deGoogle Cloudpara pruebas de dispositivos remotos y desarrollo de dispositivos móviles con agentes, alojada en Google Cloud. DDP proporciona una infraestructura de granja de dispositivos administrada que se integra de forma nativa en la consola de Google Cloud , IAM, la Facturación de Cloud y el SDK.

API de catálogo de dispositivos

Una plataforma de descubrimiento de dispositivos unificada y que cumple con la AIP alojada en devicerun.googleapis.com para proyectos y ubicaciones. El catálogo de dispositivos presenta una sola colección plana que abarca dispositivos iOS y Android físicos y virtuales. Cada entrada expone un ID de dispositivo opaco estable, especificaciones de hardware y señales de capacidad y disponibilidad de la flota en tiempo real.

Atributo de catálogo Tipo de datos Descripción
name String Ruta de acceso al recurso (projects/my-project/locations/global/devices/device-id).
form Enum Tipo de hardware (PHYSICAL o VIRTUAL)
os_version String Versión del SO o nivel del SDK de Android (p. ej., 35 o 17.4)
availability Mensaje Señal de capacidad de la flota (HIGH, MEDIUM, LOW, NONE).

API de Device Run

Es el servicio general devicerun.googleapis.com que consolida las pruebas de dispositivos remotos, el descubrimiento de catálogos y los flujos de trabajo de agentes en un servicio nativo de la nube, como se describe en la descripción general de Device Run.

API de Device Streaming

La oferta integrada de Google Cloud devicestreaming.googleapis.com que proporciona capacidades de transmisión interactiva de dispositivos remotos. La API de Device Streaming permite que los desarrolladores transmitan pantallas de dispositivos en tiempo real directamente a Android Studio.

E

Ejecución

Es el nivel más bajo de la jerarquía de recursos de tres niveles de Device Run de Developer Device Platform (Session -> Job -> Execution). Una ejecución representa un intento de tiempo de ejecución concreto generado por el sistema para ejecutar un paquete de pruebas o un fragmento en un dispositivo asignado, lo que captura registros de salida sin procesar, registros del sistema y grabaciones de video.

F

Flank

Es un ejecutor de pruebas del cliente de código abierto de terceros popular que se desarrolló para optimizar la ejecución de pruebas y la fragmentación. DDP absorbe de forma nativa las funciones principales de Flank, incluidas la configuración basada en YAML, la fragmentación inteligente histórica avanzada y los reintentos orientados, lo que hace que los wrappers externos sean innecesarios.

G

gcloud device-run

La interfaz de línea de comandos principal del SDK de Google Cloud para las operaciones de transmisión y pruebas por lotes de DDP. Opera con un patrón gcloud device-run <resource> <verb> centrado en los recursos y proporciona comandos para enviar sesiones de prueba, consultar la disponibilidad de los dispositivos, sondear el estado de ejecución y descargar los resultados.

J

Trabajo

Es el nivel intermedio en la jerarquía de recursos de tres niveles de Device Run de Developer Device Platform (Session -> Job -> Execution). Un trabajo vincula una configuración de automatización específica (JobAction, como una prueba de instrumentación de Android) con una configuración de dispositivo de destino. Un solo trabajo se expande automáticamente en varias ejecuciones cuando se habilitan la fragmentación o los reintentos.

N

NO_ACCESS_BLOCKED_BY_ORG_ADMIN

Es una etiqueta de estado de acceso que se muestra en el catálogo de dispositivos del DDP y que indica que un administrador de la organización restringió un modelo de dispositivo o un lab de socios específico (p.ej., hardware de OEM de terceros) con etiquetas de Resource Manager o políticas de la organización de Google Cloud .

O

Grupos de dependencias de la API de One Platform

Es una función del plano de control de servicios de Google Cloud que activa automáticamente el backend de las APIs dependientes. Cuando un desarrollador habilita una API de DDP, los grupos de dependencias se activan automáticamente en segundo plano.

P

Partner Device Labs

Laboratorios de dispositivos remotos operados directamente por socios OEM de Google (como Samsung, Xiaomi, OPPO, OnePlus, vivo y Transsion) integrados en DDP. Los laboratorios de socios amplían la variedad del catálogo de dispositivos y requieren una habilitación explícita a nivel del proyecto en la consola deGoogle Cloud .

S

Reintento de prueba inestable secuencial

Es un mecanismo de reintento que ahorra costos en DDP y que aísla y reintenta solo los casos de prueba individuales que fallan dentro de un fragmento, ejecutándolos de forma secuencial de forma predeterminada en lugar de volver a ejecutar todo el fragmento de forma simultánea.

Agente de servicio (cuenta de servicio)

Es una cuenta de servicio de Google Cloud administrada por Google que se crea automáticamente cuando se habilitan las APIs de DDP en un proyecto de Google Cloud . El agente de servicio de DDP tiene permisos de servicio de IAM para leer de forma segura los objetos binarios de prueba de entrada y escribir registros y videos de salida de prueba en buckets de Google Cloud Storage de propiedad del usuario, publicar notificaciones de estado en temas de Google Cloud Pub/Sub y organizar asignaciones de hardware en centros de datos administrados en nombre del proyecto.

Service Usage/Habilitación de la API

El subsistema de administración de servicios de Google Cloud responsable de habilitar y configurar las APIs de Google Cloud para un proyecto. Para habilitar la DDP, se necesitan permisos a nivel del proyecto o los roles de servicio devicerun.googleapis.com, devicestreaming.googleapis.com y testing.googleapis.com.

Sesión

Es el contenedor de nivel superior en la jerarquía de recursos de Device Run de Developer Device Platform (projects/my-project/locations/global/sessions/session-id). Una sesión encapsula el envío por lotes de un usuario, que contiene uno o más trabajos ejecutados en matrices de dispositivos o módulos de Gradle, y produce un SessionReport agregado.

En la API de Device Streaming de Developer Device Platform, un deviceSession representa una sola sesión de transmisión de dispositivo remoto. En lugar de ejecutar secuencias de comandos por lotes hasta su finalización, la API de Device Streaming reserva un solo dispositivo y abre una conexión bidireccional en vivo para que un ingeniero o agente de IA pueda ver la pantalla y controlar el dispositivo en tiempo real.

Fragmentación inteligente

Es un mecanismo inteligente de partición de pruebas en Device Run de Developer Device Platform (--sharding-option=smart). La fragmentación inteligente analiza hasta 30 días de datos históricos de ejecución de pruebas, hace un seguimiento de los tiempos de ejecución por modelo de dispositivo específico y tiene en cuenta la sobrecarga de inicio de Android Test Orchestrator para distribuir los paquetes de pruebas en fragmentos equilibrados que se orientan a una duración especificada.

U

Fragmentación uniforme

Es una estrategia de distribución de pruebas (--sharding-option=uniform --uniform-sharding-count=N) en Device Run de Developer Device Platform que divide un paquete de pruebas de instrumentación de Android en una cantidad fija de fragmentos ($N$) con los parámetros nativos -e numShards y -e shardIndex de AndroidJUnitRunner.