Firebase Test Lab to Developer Device Platform Command and Flag Translation

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: de 2m a 1h).
  • Establece --smart-sharding-record-name={record_name} (apunta al registro de seguimiento de YAML dentro de --bucket-name en automation/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.yaml
    
  • CLI 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.