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, te recomendamos que utilices android-latest-release en lugar de aosp-main. 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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 en ITS de la cámara para Android 17.

Versiones de Python y de paquetes

En el caso de Android 17 y versiones posteriores, recomendamos usar software de administración de paquetes para incluir las versiones correctas de los paquetes y crear un entorno virtual para el desarrollo de versiones de Android. Para ver un ejemplo de herramienta de administración de paquetes que controla la mayoría de los paquetes necesarios, consulta la documentación de Python 3 para venv.

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

Instala Python 3.12 y python3-venv

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

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

Actualiza apt e instala pip

sudo apt-get update
sudo apt install python3-pip

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

Crea its_android17_env.txt con la lista de paquetes obligatorios

contourpy==1.3.1
cycler==0.12.1
fonttools==4.56.0
imagecodecs==2026.3.6
ImageIO==2.37.3
kiwisolver==1.4.8
lazy-loader==0.5
matplotlib==3.10.0
mobly==1.12.3
mobly-android-partner-tools==1.5.2
networkx==3.6.1
numpy==2.2.2
opencv-python==4.11.0.86
packaging==24.2
pillow==11.1.0
portpicker==1.6.0
protobuf==6.33.6
psutil==6.1.1
pyparsing==3.2.1
pyserial==3.5
python-dateutil==2.9.0.post0
pyudev==0.24.4
PyYAML==6.0.2
scikit-image==0.26.0
scipy==1.15.1
six==1.17.0
snippet-uiautomator==1.1.2
tifffile==2026.3.3

Instala los paquetes que se indican 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 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 a 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 introduce las siguientes escenas:

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

Nuevas pruebas

Android 17 introduce 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 JPEG_R de la JCA y las imágenes capturadas esté dentro del umbral elegido.
`wide_gamut`	`test_display_p3`	Verifica que el resultado JPEG de 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 refactorizaron 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 disminuyó el umbral de diferencia del RMS para garantizar que las discrepancias de color relacionadas con el tono se marquen como errores siempre que 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 ultra gran angular (UW) hasta aplicaciones de teleobjetivo.
`3`	`test_flip_mirror`	Usa marcadores ArUco para validar la presencia y la orientación. El estado `PASS` solo se otorga si se detectan todos los marcadores y se alinean correctamente. La prueba falla para los gráficos desplazados o rotados.
`3`	`test_landscape_to_portrait`	Carga el gráfico de escena3 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 ultra gran angular (UW) hasta aplicaciones de teleobjetivo.
`4`	`test_multi_camera_alignment`	Se omite la prueba si el dispositivo solo tiene una cámara gran angular y una cámara súper telefónica.
`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 discrepancia del FoV. Se agregó una verificación de `not_yet_mandated` para la diferencia de renderización del color entre la app de cámara predeterminada y las capturas de JCA.

Actividades de prueba separadas

En Android 17, para realizar pruebas en paralelo en dispositivos separados, las pruebas de 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 actividad Camera ITS Sensor Fusion Rig Test contiene las escenas feature_combination y sensor_fusion, 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 banco de pruebas de ITS integrado en la cámara y el banco de pruebas 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 en desuso

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

Escena	Nombre de prueba	Descripción
`sensor_fusion`	`test_video_stabilization`	Esta prueba dejó de estar disponible. En su lugar, usa test_video_stabilization_jca.

Actualizaciones del soporte Gen2

En Android 17, se migraron las siguientes pruebas a la plataforma Gen2:

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

Antes de ejecutar las pruebas migradas, instala el gráfico de la estructura de soporte de 2ª gen. que se introdujo en Android 17. El nuevo gráfico te permite ejecutar todas las pruebas de fusión de sensores en el equipo Gen2. Para obtener más información, consulta Cómo configurar el gráfico para realizar pruebas.

Nuevo estado de la prueba: APROBADA*

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

Mejoras en el ajuste de escala de los gráficos

Android 17 agrega el parámetro chart_scaling en config.yml para que TEST_BED_TABLET_SCENES controle los problemas de ajuste de escala del gráfico con dispositivos de telecámara con un campo visual (FoV) más amplio. Para obtener más información, consulta Mejoras en el ajuste de escala de los gráficos: parámetro chart_scaling.

Nueva tablet para la compatibilidad con pruebas de gama amplia

En Android 17 y versiones posteriores, la Samsung Galaxy Tab S10 FE (modelos Wi-Fi y 5G) se encuentra en la lista de dispositivos permitidos para tablets. La Samsung Galaxy Tab S10 FE está aprobada para mostrar gráficos de prueba de gama amplia, 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 se indica 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 compilaciones

Android 17 introduce un proceso para enviar los resultados agregados de las pruebas de 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 de aprobación en dispositivos que comparten la misma huella digital de compilación.
Ejecución paralela: Permite probar varias escenas de forma simultánea en varios dispositivos, siempre que compartan la misma huella digital de compilación.
Informes simplificados: Permite agregar los resultados de las pruebas de varios informes del verificador del CTS (recopilados de diferentes ejecuciones de pruebas o dispositivos) en un solo envío unificado.

Para obtener más información, consulta Cómo enviar resultados de pruebas agregados.