A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en el AOSP.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Notas de la versión del paquete de pruebas de imágenes de la cámara de Android 17

La versión de Android 17 incluye varios cambios en el ITS de la cámara. En esta página, se resumen los cambios del ITS de la cámara para Android 17.

Versiones de Python y del paquete

Para Android 17 y versiones posteriores, te recomendamos usar un software de administración de paquetes para agrupar las versiones correctas de los paquetes y crear un entorno virtual para el desarrollo de versiones de Android. Para obtener un ejemplo de una herramienta de administración de paquetes que controla la mayoría de los paquetes requeridos, consulta la documentación de Python 3 para venv.

Para crear el entorno virtual con venv, sigue estos pasos:

Instala Python 3.14 y python3-venv.

sudo apt install python3.14
sudo apt install python3.14-venv python3.14-dev

Verifica la instalación de Python.
```
python3.14 --version
```

Actualiza apt e instala pip.

sudo apt-get update
sudo apt install python3-pip

Crea un entorno virtual.
```
python3.14 -m venv its_android17_env
```
Activa el entorno virtual.
```
source its_android17_env/bin/activate
```

Crea its_android17_env.txt con la lista de paquetes requeridos.

ImageIO==2.5.0
PyYAML==6.0.2
contourpy==1.3.3
cycler==0.12.1
fonttools==4.56.0
imagecodecs==2023.9.18
kiwisolver==1.5.0
lazy-loader==0.5
matplotlib==3.10.9
mobly==1.13.0
mobly-android-partner-tools==1.5.2
networkx==3.4.2
numpy==2.4.6
opencv-python==4.13.0.*
packaging==26.0.0
pillow==12.3
portpicker==1.6.0
protobuf<=7.37.0
psutil==5.9.4
pyparsing==3.2.1
pyserial==3.5.0
python-dateutil==2.9.0.post0
pyudev==0.22.0
scikit-image==0.22.0
scipy==1.17.1
six==1.17.0
snippet-uiautomator==1.1.2
tifffile==2026.2.16

Instala los paquetes que se muestran en its_android17_env.txt.
```
pip install -r its_android17_env.txt
```
Instala la versión 7.0.2 de FFmpeg con el descargador de ffmpeg.
```
pip install ffmpeg-downloader
ffdl install 7.0.2
```
(Opcional) Si el descargador de ffmpeg no funciona, descarga la versión 7.0.2 de una fuente en línea.

Verifica la instalación de FFmpeg de la versión 7.0.2.

ffmpeg -version

Si la versión de FFmpeg aún no es 7.0.2, crea un vínculo simbólico de los archivos binarios (ajusta PATH según dónde guardes its_android17_env).

ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffmpeg ~/PATH/its_android17_env/bin/ffmpeg
ln -s ~/.local/share/ffmpeg-downloader/ffmpeg/ffprobe ~/PATH/its_android17_env/bin/ffprobe

Verifica qué paquetes están instalados.
```
pip freeze
```
(Opcional) Comando para desactivar el entorno:
```
deactivate
```

Escenas nuevas o actualizadas

Android 17 presenta las siguientes escenas:

Escena	Descripción
`gen2_chart`	Es una escena nueva que usa el gráfico de papel `test_chart_gen2` en lugar de escenas de tablets para mejorar la coherencia y la confiabilidad de las pruebas. El `test_chart_gen2` también se usa en `scene_ip`.
`wide_gamut`	Es una escena nueva para tablets con compatibilidad con una amplia gama de colores.
`3`	Usa marcadores ArUco para la detección de gráficos para mejorar la velocidad y la confiabilidad. Este cambio se adapta al rango más amplio de FoV y distancias que se ven en las pruebas de la cámara teleobjetivo. El uso de marcadores omite la lógica de tamaño actual y los problemas del optimizador. Para obtener más información, consulta scene3.
`flash`	Las pruebas se pueden ejecutar con el equipo de Gen2.

Nuevas pruebas

Android 17 presenta las siguientes pruebas:

Escena	Nombre de prueba	Descripción
`gen2_chart`	`test_tonemap_sequence`	Verifica que el parámetro `android.tonemap.mode` se aplique correctamente para la distribución uniforme y no uniforme.
`ip`	`test_jca_jpegr_ip`	Verifica que la diferencia de balance de blancos entre la instantánea de vista previa de JCA JPEG_R y las imágenes capturadas esté dentro del umbral elegido.
`wide_gamut`	`test_display_p3`	Verifica que el resultado de JPEG P3 tenga un perfil icc adecuado y contenga más del 1% de colores fuera de la gama sRGB.

Pruebas refactorizadas

En Android 17, se refactorizan las siguientes pruebas para aumentar la cobertura de las pruebas y agruparlas de forma más lógica:

Escena	Nombre de prueba	Descripción
`1_2`	`tests_param_tonemap_mode`	La versión scene1_2 de la prueba tests_param_tonemap_mode está obsoleta y solo se usa en dispositivos con Android 16 o versiones anteriores.
`1_2`	`test_tonemap_sequence`	La versión scene1_2 de la prueba test_tonemap_sequence solo se usa en dispositivos con Android 16 o versiones anteriores.
`2_b`	`test_yuv_jpeg_capture_sameness`	Se disminuye el umbral de diferencia RMS para garantizar que las discrepancias de color relacionadas con el tono se marquen como fallas cuando generen una diferencia visible para el usuario.
`3`	`test_edge_enhancement`	Usa marcadores ArUco para validar la presencia y la orientación. Este método proporciona una detección estable para cámaras desde aplicaciones ultra gran angular (UW) hasta teleobjetivo.
`3`	`test_flip_mirror`	Usa marcadores ArUco para validar la presencia y la orientación. Solo se otorga un estado `PASS` si se detectan todos los marcadores y están alineados correctamente. La prueba falla para los gráficos desplazados o rotados.
`3`	`test_landscape_to_portrait`	Carga el gráfico scene3 actualizado con marcadores ArUco.
`3`	`test_lens_movement_report`	Usa marcadores ArUco para validar la presencia y la orientación. Este método proporciona una detección estable para cámaras desde aplicaciones ultra gran angular (UW) hasta teleobjetivo.
`4`	`test_multi_camera_alignment`	Omite la prueba si el dispositivo tiene solo una cámara gran angular y una cámara súper teleobjetivo.
`flash`	`test_auto_flash`	Actualiza la prueba para verificar que el flash funcione correctamente en varios niveles de zoom.
`ip`	`test_default_jca_ip`	Exige las verificaciones existentes: diferencia de brillo, diferencia de balance de blancos y falta de coincidencia de FoV. Agrega una verificación `not_yet_mandated` para la diferencia de representación de color entre la app de cámara predeterminada y las capturas de JCA.

Actividades de prueba separadas

En Android 17, para las pruebas en paralelo en dispositivos separados, las pruebas del ITS de la cámara se separan en dos actividades del Verificador de CTS, Camera ITS Test y Camera ITS Sensor Fusion Rig Test. La Camera ITS Sensor Fusion Rig Test actividad contiene las feature_combination y sensor_fusion escenas, y se puede ejecutar por separado en un equipo de prueba de fusión de sensores. En la siguiente tabla, se describen las escenas incluidas en cada actividad.

Actividad	Escenas	Descripción
`Camera ITS Test`	`gen2_chart`, `scene0`, `scene1_1`, `scene1_2`, `scene1_3`, `scene2_a`, `scene2_b`, `scene2_c`, `scene2_d`, `scene2_e`, `scene2_f`, `scene2_g`, `scene3`, `scene4`, `scene5`, `scene6`, `scene8`, `scene9`, `scene_flash`, `scene_hdr`, `scene_ip`, `scene_low_light`, `scene_video`, `wide_gamut`	Escenas que se ejecutan en el equipo de prueba de ITS integrado en la cámara y el equipo de Gen2.
`Camera ITS Sensor Fusion Rig Test`	`feature_combination`, `sensor_fusion`	Escenas que se ejecutan en el equipo de prueba de fusión de sensores.

Pruebas obsoletas

En Android 17, las siguientes pruebas están obsoletas porque la función de prueba está cubierta por otras pruebas:

Escena	Nombre de prueba	Descripción
`sensor_fusion`	`test_video_stabilization`	Esta prueba está obsoleta. En su lugar, usa test_video_stabilization_jca.

Actualizaciones del equipo de Gen2

En Android 17, las siguientes pruebas se migraron a l equipo de Gen2:

Escena	Nombre de prueba	Descripción
`7`	`test_multi_camera_switch`	Se migró la prueba a la configuración del equipo de Gen2 para usar el gráfico de Gen2 para las verificaciones de AE y AWB. Esta transición reemplaza los objetivos basados en tablets por gráficos físicos para eliminar los efectos Moiré y proporcionar un entorno de prueba más estable y reproducible.
`flash`	`all tests`	Se migraron las pruebas scene_flash en el equipo de Gen2. Los usuarios pueden ejecutar estas pruebas en un equipo de fusión de sensores o en un entorno de equipo de Gen2.
`sensor_fusion`	`all tests`	Se migraron las pruebas sensor_fusion al equipo de Gen2. Los usuarios pueden ejecutar estas pruebas en un equipo de fusión de sensores o en un entorno de equipo de Gen2.

Antes de ejecutar las pruebas migradas, instala el gráfico del equipo de Gen2 que se introdujo en Android 17. El nuevo gráfico te permite ejecutar todas las pruebas de fusión de sensores en el equipo de Gen2. Para obtener más información, consulta Configura el gráfico para las pruebas.

Nuevo estado de prueba: PASS*

17 presenta el estado de prueba PASS* para detectar pruebas que se aprobaron de forma marginal. Para obtener más información, consulta Pruebas que se aprobaron de forma marginal (estado de prueba PASS*).

Mejoras en el escalamiento de gráficos

Android 17 agrega el parámetro chart_scaling en config.yml para TEST_BED_TABLET_SCENES para controlar los problemas de escalamiento de gráficos con dispositivos de cámara teleobjetivo de campo visual (FoV) más amplio. Para obtener más información, consulta Mejoras en el escalamiento de gráficos: parámetro chart_scaling.

Nueva tablet para la compatibilidad con pruebas de amplia gama de colores

Para Android 17 y versiones posteriores, la Samsung Galaxy Tab S10 FE (modelos Wi-Fi y 5G) está en la lista de tablets permitidas. La Samsung Galaxy Tab S10 FE está aprobada para mostrar gráficos de prueba de amplia gama de colores, así como todas las demás escenas basadas en tablets. Para verificar que tu dispositivo esté en la lista de entidades permitidas, usa el comando adb shell getprop ro.product.device para confirmar que el ID del producto coincida con el valor que aparece en la siguiente lista.

    'gts10fewifi',  # Samsung Galaxy Tab S10 FE
    'gts10fe',  # Samsung Galaxy Tab S10 FE 5G

Envío de resultados agregados para aprobaciones de compilación

Android 17 presenta un proceso para enviar resultados agregados de pruebas del ITS de la cámara para la aprobación de la compilación con el APK actualizado del Verificador de CTS.

El nuevo sistema de agregación proporciona las siguientes mejoras:

Ahorro de tiempo: Elimina la necesidad de volver a ejecutar repetidamente las escenas aprobadas en dispositivos que comparten la misma huella digital de compilación.
Ejecución en paralelo: Permite realizar pruebas simultáneas de varias escenas en varios dispositivos, siempre que compartan la misma huella digital de compilación.
Informes simplificados: Permite la agregación de resultados de pruebas de varios informes del Verificador de CTS (recopilados de diferentes ejecuciones de pruebas o dispositivos) en un solo envío unificado.

Para obtener más información, consulta Envía resultados de pruebas agregados.