La Developer Device Platform (DDP) reemplaza la consola heredada de Firebase Test Lab
y los flujos de trabajo de la CLI de Test Lab por una CLI de pruebas unificada, segura y de alto rendimiento
que priorizaGoogle Cloud: gcloud beta device-run
En esta guía, se proporcionan traducciones de línea de comandos y asignaciones de marcas de Test Lab (o Flank) a DDP. Usa esta guía para migrar tus pruebas de forma manual. Consulta Migra de Firebase Test Lab a Developer Device Platform para conocer las herramientas de automatización, los beneficios, las diferencias clave y las sugerencias de migración.
Migración de fragmentación
DDP moderniza las configuraciones de fragmentación reemplazando de forma nativa tanto la fragmentación inteligente compleja basada en Cloud Storage de Flank como la fragmentación uniforme de Test Lab.
Fragmentación uniforme
- Establece
--sharding-option=uniform. Establece
--uniform-sharding-count={count}(del 1 al 20 para las físicas y del 1 al 200 para las virtuales).Firebase Test Lab heredado:
--num-uniform-shards {N}CLI de DDP:
--sharding-option=uniform --uniform-sharding-count={N}
Fragmentación inteligente
- Establece
--sharding-option=smart. - Establece
--smart-sharding-target-duration={duration}(p.ej.,2m,10m,1h; rango válido: de2ma1h). - Establece
--smart-sharding-record-name={record_name}(apunta al registro de seguimiento de YAML dentro de--bucket-nameenautomation/smart-sharding/). - Establece
--smart-sharding-max-shard-count={max_count}(límite máximo opcional: de 0 a 20 para dispositivos físicos y de 0 a 200 para dispositivos virtuales).
Usa los metadatos históricos de tiempo de 30 días:
Flank heredado:
max-test-shards: 10 shard-time: 120 smart-flank-gcs-path: gs://my-bucket/smart-sharding/timing-record.yamlCLI de DDP:
--sharding-option=smart \ --smart-sharding-max-shard-count=10 \ --smart-sharding-target-duration=2m \ --smart-sharding-record-name=timing-record \ --bucket-name=my-bucket
Configuración declarativa de YAML (--flags-file)
Para configuraciones complejas o equipos que prefieren mantener archivos con control de versiones
en lugar de comandos de terminal largos, gcloud proporciona un preprocesador de argumentos
--flags-file universal (consulta $ gcloud topic flags-file):
Android
gcloud beta device-run sessions submit instrumentation --flags-file=device-run-flags.yaml
iOS
gcloud alpha device-run sessions submit xctest --flags-file=device-run-flags.yaml
Este es un ejemplo que muestra una lista de varios valores y marcas de diccionario:
Android
# device-run-flags.yaml
--device:
- mediumphone-arm-32
- shiba-36
--apps:
- app-debug.apk
- test-helper.apk
--test: app-debug-androidTest.apk
--bucket-name: my-bucket
--sharding-option: smart
--smart-sharding-target-duration: 2m
--smart-sharding-record-name: timing-record
--paths-to-pull:
- /sdcard/screenshots
- /sdcard/coverage.ec
--additional-test-options:
coverage: "true"
clearPackageData: "true"
iOS
# device-run-flags.yaml
--device:
- iphonese3-18-4
- iphone16pro-18-3
--test: MyTests.zip
--additional-apps:
- helper-app.ipa
--xcode-version: '16.4'
--xctest-timeout: 15m
--other-files-to-push:
/local/path/test-config.json: com.example.app:/Documents/test-config.json
--paths-to-pull:
- com.example.app:/Documents/screenshots
--labels:
env: staging
team: mobile-qa
Ejemplos de traducción de comandos de extremo a extremo
Consulta estas traducciones estándar y complejas para ver ejemplos concretos.
Ejemplo: Ejecuta una prueba de instrumentación estándar
CLI de Firebase heredada:
gcloud firebase test android run \
--app=app-debug.apk \
--test=app-debug-androidTest.apk \
--device model=shiba,version=36 \
--timeout=5m \
--num-flaky-test-attempts=2 \
--directories-to-pull=/sdcard/screenshots \
--environment-variables key=value
Traducción de la CLI de DDP:
gcloud beta device-run sessions submit instrumentation \
--device=shiba-36 \
--apps=app-debug.apk \
--test=app-debug-androidTest.apk \
--instrumentation-timeout=5m \
--flaky-test-attempts=3 \
--paths-to-pull=/sdcard/screenshots \
--additional-test-options key=value
Ejemplo: Migra una configuración de YAML de Flank compleja
Configuración heredada de Flank:
app: app-debug.apk
test: app-debug-androidTest.apk
device:
- model: shiba
version: 36
shard-time: 120
smart-flank-gcs-path: gs://my-bucket/smart-sharding/timing-record.yaml
Traducción de la CLI de DDP:
gcloud beta device-run sessions submit instrumentation \
--device=shiba-36 \
--apps=app-debug.apk \
--test=app-debug-androidTest.apk \
--bucket-name=my-bucket \
--sharding-option=smart \
--smart-sharding-target-duration=2m \
--smart-sharding-record-name=timing-record
Ejecución posterior y recuperación de resultados
Dado que DDP no se inicia con una IU web gráfica (como Firebase console heredada), los desarrolladores deben administrar, describir e inspeccionar los resultados directamente con la CLI o las APIs de REST programáticas:
# 1. List active and completed test sessions
gcloud beta device-run sessions list
# 2. Get a summary and direct Cloud Storage bucket link of a session's results
gcloud beta device-run sessions describe session-number
# 3. Get detailed metadata and print full results
gcloud beta device-run sessions describe session-number --full
# 4. Cancel a running session (replaces console cancellation)
gcloud beta device-run sessions cancel session-number
Referencia de asignación de marcas
Aquí se muestra la asignación de marcas para migrar las configuraciones de prueba de Flank o gcloud
firebase test android/ios run a los nuevos comandos gcloud beta device-run sessions
submit instrumentation y gcloud alpha device-run sessions submit xctest de DDP.
Parámetros y recursos principales
| Parámetro heredado (Test Lab/Flank) | Parámetro de DDP objetivo | Lógica de formato o conversión |
|---|---|---|
Flanco --project |
--project |
La marca global estándar de Google Cloud (--project=PROJECT_ID) o la configuración activa de Google Cloud CLI. |
--client-details |
--labels |
Diccionario de pares key=value que se adjuntarán a la sesión de prueba. |
--other-files |
--other-files-to-push |
Diccionario. Son los archivos auxiliares que se enviarán al dispositivo antes de la ejecución de prueba. Invierte el orden heredado de DEST=SOURCE a SOURCE=DEST (SOURCE=DEVICE_PATH en Android; SOURCE=BUNDLE_ID:DEVICE_PATH en iOS). |
Configuración y segmentación de dispositivos
| Parámetro heredado (Test Lab/Flank) | Parámetro de DDP objetivo | Lógica de formato o conversión |
|---|---|---|
--device model={M},version={V} |
--device={M}-{V} |
Es una cadena OBLIGATORIA que asigna el modelo y la versión del SO a una sola cadena de ID de --device. La marca --device de DDP acepta varios IDs de dispositivo separados por comas (p. ej., --device=shiba-34,tokay-36 o --device=iphone16pro-18-3) o varias marcas --device, cada una con un ID de dispositivo diferente (p. ej., --device=shiba-34 --device=tokay-36). |
Control de ejecución y flakiness
| Parámetro heredado (Test Lab/Flank) | Parámetro de DDP objetivo | Lógica de formato o conversión |
|---|---|---|
--async |
--async |
Booleano. Maps 1:1. De forma predeterminada, el comando se ejecuta de manera síncrona. Pasa este comando para volver a la terminal de inmediato. Sale inmediatamente después de subir el archivo y muestra los IDs de operación y sesión. |
--num-flaky-test-attempts {R} |
--flaky-test-attempts {A} |
Entero. Es la cantidad máxima de intentos de ejecución por fragmento de prueba. Convierte el recuento de reintentos R en el límite de intentos totales A: A = R + 1 (el valor predeterminado es 1). |
Salida y almacenamiento
| Parámetro heredado (Test Lab/Flank) | Parámetro de DDP objetivo | Lógica de formato o conversión |
|---|---|---|
--results-bucket |
--bucket-name |
String. Es el bucket de Cloud Storage en el que se suben los artefactos de prueba, incluidos los archivos de entrada locales, los archivos de salida de prueba y los registros de tiempo de fragmentación inteligente (el valor predeterminado es gs://[PROJECT_ID]-devicerun si no se especifica). |
--results-dir |
Administración automática | No compatible. Las rutas secundarias se organizan automáticamente en Cloud Storage en automation/sessions/{session_id}/. |
--directories-to-pull |
--paths-to-pull |
Lista. Son los archivos o directorios que se descargarán del dispositivo después de la ejecución de prueba (DEVICE_PATH en Android; BUNDLE_ID:DEVICE_PATH en iOS). |
Configuración de fragmentación
| Parámetro heredado (Test Lab/Flank) | Parámetro de DDP objetivo | Lógica de formato o conversión |
|---|---|---|
--num-uniform-shards {N} |
--sharding-option=uniform --uniform-sharding-count={N} |
String y Integer. La configuración de marcas combinadas activa la estrategia de fragmentación uniforme y establece el recuento máximo de fragmentos (rango de recuento válido: de 1 a 20 físicos, de 1 a 200 virtuales). |
Flanco --max-test-shards {N} |
--sharding-option=smart --smart-sharding-max-shard-count={N} |
String y Integer. La configuración de la marca combinada activa la estrategia de fragmentación inteligente y establece el recuento máximo de fragmentos (rango de recuento válido: de 0 a 20 físicos, de 0 a 200 virtuales). |
Flanco --shard-time {S} |
--sharding-option=smart --smart-sharding-target-duration={S} |
OBLIGATORIO String. Activa la fragmentación inteligente con el tiempo de ejecución objetivo (p. ej., 2m, 10m, 1h). El rango válido es de 2m a 1h. |
Flanco --smart-flank-gcs-path |
--smart-sharding-record-name={name} --bucket-name={bucket} |
OBLIGATORIO String. Es el nombre del archivo YAML del registro de fragmentación (sin incluir la extensión de archivo) dentro de --bucket-name en smart-sharding/ en Cloud Storage. |
Marcas específicas de Android
Usa esta tabla para asignar las marcas heredadas de gcloud firebase test android run y Flank para Android a sus nuevos equivalentes de gcloud beta device-run sessions submit
instrumentation:
| Tipo de prueba | Grupo de atributos | Parámetro heredado (firebase android/Flank) |
Parámetro de DDP objetivo | Lógica de formato o conversión |
|---|---|---|---|---|
| Android común | Parámetros y recursos principales | --app |
--apps |
Lista. Si se proporcionan varios APKs o AABs de la aplicación, pásalos todos a --apps en el orden en que se instalarán en el dispositivo. La ruta de acceso puede ser local o en Cloud Storage (gs://...). |
| Android común | Parámetros y recursos principales | --additional-apks |
--apps |
Lista. Combina valores de listas adicionales directamente en la lista principal --apps. |
| Android común | Parámetros y recursos principales | --obb-files |
--other-files-to-push |
Diccionario en formato SOURCE=DEST. Envía archivos OBB directamente a la ruta de acceso del dispositivo de destino (/sdcard/Android/obb/{package_name}/). |
| Android común | Configuración y segmentación de dispositivos | --device locale={L} |
--locale={L} |
String. Asigna la configuración regional del dispositivo a la marca --locale de nivel superior (language-region, p. ej., --locale=en-US) al que se debe cambiar el dispositivo antes de ejecutar la prueba. |
| Android común | Configuración y segmentación de dispositivos | --device orientation={O} |
--orientation={O} |
String. Asigna la orientación del dispositivo a la marca --orientation de nivel superior (portrait o landscape). |
| Android común | Configuración y segmentación de dispositivos | N/A | --coordinates |
String. Simula las coordenadas de ubicación GPS del dispositivo (p. ej., --coordinates=37.4220,-122.0841). |
| Android común | Control de ejecución y flakiness | --grant-permissions |
Configuración predeterminada automatizada | Automatizado. Los permisos de tiempo de ejecución se otorgan automáticamente de forma predeterminada (equivalente a --grant-permissions=all). |
| Android común | Salida y almacenamiento | N/A | --dumpsys |
String. Recopila el estado del sistema con dumpsys (valores: always, on-failure). |
| Android común | Salida y almacenamiento | N/A | --bugreport |
String. Recopila un bugreport completo del dispositivo (valores: always, on-failure). |
| Android común | Salida y almacenamiento | --record-video |
--video |
String. Cuándo grabar un video de la pantalla del dispositivo durante la ejecución de la prueba. Los valores válidos son always o on-failure. |
| Instrumentación de Android | Parámetros y recursos principales | --type=instrumentation |
sessions submit instrumentation |
La estructura del subcomando determina el tipo de prueba en lugar de una marca --type. |
| Instrumentación de Android | Parámetros y recursos principales | --test |
--test |
OBLIGATORIO String. Es la ruta de acceso al APK de prueba que contiene las pruebas de instrumentación, ya sea de forma local o en Cloud Storage. |
| Instrumentación de Android | Control de ejecución y flakiness | --timeout |
--instrumentation-timeout |
Duración (p. ej., 10m, 20s, 1h). El rango válido es de 1m a 3h (el valor predeterminado es 5m). |
| Instrumentación de Android | Control de ejecución y flakiness | N/A | --flaky-test-parallel-retry |
Booleano. Indica si se deben reintentar las pruebas con errores en paralelo (el valor predeterminado es false para la ejecución secuencial). |
| Instrumentación de Android | Control de ejecución y flakiness | N/A | --flaky-test-retry-level |
String. Define si se debe reintentar a nivel de shard o de test individual (el valor predeterminado es shard). |
| Instrumentación de Android | Ejecutor de pruebas y destinos | --test-runner-class |
--test-runner-class |
String. Es la clase de ejecutor de pruebas de instrumentación completamente calificada (p. ej., com.foo.MyRunner) que se usará. Si no se especifica, se determina una clase de ejecutor predeterminada examinando el manifiesto de la aplicación. |
| Instrumentación de Android | Ejecutor de pruebas y destinos | --test-targets |
--test-targets |
Es un diccionario de destinos de prueba o filtros de destino para ejecutar. Cada destino debe estar completamente calificado con el nombre del paquete o de la clase que admite claves como package, notPackage, class, notClass, annotation, notAnnotation y size. No se admiten los formatos testfile ni notTestfile. |
| Instrumentación de Android | Ejecutor de pruebas y destinos | --use-orchestrator |
--orchestrator-version |
Indica si se debe usar Android Test Orchestrator. Toma auto (orquestador predeterminado) o una cadena de versión específica (p. ej., 1.6). Las versiones disponibles se pueden consultar con gcloud beta device-run software-versions list. |
| Instrumentación de Android | Ejecutor de pruebas y destinos | --environment-variables |
--additional-test-options |
Es un diccionario de opciones que se pasan al ejecutor de pruebas de instrumentación. Aquí no se permiten los formatos admitidos en --test-targets. |
Marcas específicas de iOS
Usa esta tabla para asignar las marcas heredadas de gcloud firebase test ios run y Flank para iOS
a sus nuevos equivalentes de gcloud alpha device-run sessions submit xctest:
| Tipo de prueba | Grupo de atributos | Parámetro heredado (firebase ios/Flank) |
Parámetro de DDP objetivo | Lógica de formato o conversión |
|---|---|---|---|---|
| iOS común | Parámetros y recursos principales | --additional-ipas |
--additional-apps |
Es una lista de archivos auxiliares .ipa que se instalarán en el dispositivo antes de la ejecución de prueba. |
| Solo XCTest de iOS | Parámetros y recursos principales | --type=xctest |
sessions submit xctest |
La estructura del subcomando determina el tipo de prueba en lugar de una marca --type (usa gcloud alpha). |
| Solo XCTest de iOS | Parámetros y recursos principales | --test |
--test |
OBLIGATORIO String. Es la ruta de acceso al archivo ZIP que contiene la app para iOS y los archivos de XCTest, ya sea local o en Cloud Storage. |
| Solo XCTest de iOS | Control de ejecución y flakiness | --timeout |
--xctest-timeout |
Duración (p. ej., 5m, 15m, 1h). El rango válido es de 1m a 1h (el valor predeterminado es 5m). |
| Solo XCTest de iOS | Salida y almacenamiento | --record-video |
--video |
Cuándo grabar un video: always o on-failure Se graba un video para cada caso de prueba de IU (iOS 17 o versiones posteriores). |
| Solo XCTest de iOS | Ejecutor de pruebas y destinos | --xctestrun-file |
--xctestrun-file |
String. Es la ruta de acceso a un archivo .xctestrun personalizado, ya sea local o en Cloud Storage. |
| Solo XCTest de iOS | Ejecutor de pruebas y destinos | --xcode-version |
--xcode-version |
String. Es el ID de catálogo o la cadena de versión de Xcode que se usará (p. ej., xcode-16-4 o 16.4). Las versiones disponibles se pueden consultar con gcloud beta device-run software-versions list. |
Comentarios y preguntas
Comunícate con nosotros para informar errores y enviar solicitudes de funciones, o bien únete a nuestro foro de debate.