Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Notas da versão do pacote de testes de imagens da câmera do Android 17

A versão do Android 17 inclui várias mudanças no Camera ITS. Esta página resume as mudanças do Camera ITS para o Android 17.

Versões do Python e do pacote

Para o Android 17 e versões mais recentes, recomendamos o uso de um software de gerenciamento de pacotes para agrupar as versões corretas dos pacotes e criar um ambiente virtual para o desenvolvimento de versões do Android. Para um exemplo de ferramenta de gerenciamento de pacotes que processa a maioria dos pacotes necessários, consulte a documentação do Python 3 para venv.

Para criar o ambiente virtual com o venv, siga estas etapas:

Instale o Python 3.14 e o python3-venv.

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

Verifique a instalação do Python.
```
python3.14 --version
```

Atualize o apt e instale o pip.

sudo apt-get update
sudo apt install python3-pip

Crie um ambiente virtual.
```
python3.14 -m venv its_android17_env
```
Ative o ambiente virtual.
```
source its_android17_env/bin/activate
```

Crie its_android17_env.txt com a lista de pacotes necessários.

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

Instale os pacotes listados em its_android17_env.txt.
```
pip install -r its_android17_env.txt
```
Instale a versão 7.0.2 do FFmpeg com o downloader do ffmpeg.
```
pip install ffmpeg-downloader
ffdl install 7.0.2
```
(Opcional) Se o downloader do ffmpeg não funcionar, faça o download da versão 7.0.2 de uma fonte on-line.

Verifique a instalação da versão 7.0.2 do FFmpeg.

ffmpeg -version

Se a versão do FFmpeg ainda não for a 7.0.2, crie um link simbólico dos binários (ajuste PATH com base em onde você salva 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

Verifique quais pacotes estão instalados.
```
pip freeze
```
(Opcional) Comando para desativar o ambiente:
```
deactivate
```

Cenas novas ou atualizadas

O Android 17 apresenta as seguintes cenas:

Cena	Descrição
`gen2_chart`	Nova cena que usa o gráfico de papel `test_chart_gen2` em vez de cenas de tablet para melhorar a consistência e a confiabilidade do teste. O `test_chart_gen2` também é usado em `scene_ip`.
`wide_gamut`	Nova cena para tablets com suporte a ampla gama de cores.
`3`	Usa marcadores ArUco para detecção de gráficos para melhorar a velocidade e a confiabilidade. Essa mudança acomoda a maior variedade de campo de visão e distâncias vistas nos testes de câmera tele. O uso de marcadores ignora a lógica de dimensionamento atual e os problemas do otimizador. Para mais informações, consulte scene3.
`flash`	Os testes podem ser executados usando o equipamento Gen2.

Novos testes

O Android 17 apresenta os seguintes testes:

Cena	Nome do teste	Descrição
`gen2_chart`	`test_tonemap_sequence`	Verifica se o parâmetro `android.tonemap.mode` é aplicado corretamente para distribuição uniforme e não uniforme.
`ip`	`test_jca_jpegr_ip`	Verifica se a diferença de equilíbrio de branco entre o snapshot de visualização do JPEG_R JCA e as imagens capturadas está dentro do limite escolhido.
`wide_gamut`	`test_display_p3`	Verifica se a saída JPEG P3 tem um perfil icc adequado e contém mais de 1% de cores fora da gama sRGB.

Testes refatorados

No Android 17, os testes a seguir são refatorados para aumentar a cobertura de testes e agrupar os testes de forma mais lógica:

Cena	Nome do teste	Descrição
`1_2`	`tests_param_tonemap_mode`	A versão scene1_2 do teste tests_param_tonemap_mode foi descontinuada e é usada apenas em dispositivos com o Android 16 ou versões anteriores.
`1_2`	`test_tonemap_sequence`	A versão scene1_2 do teste test_tonemap_sequence é usada apenas em dispositivos com o Android 16 ou versões anteriores.
`2_b`	`test_yuv_jpeg_capture_sameness`	O limite de diferença de RMS é reduzido para ajudar a garantir que as discrepâncias de cor relacionadas ao matiz sejam sinalizadas como falhas sempre que resultarem em uma diferença visível para o usuário.
`3`	`test_edge_enhancement`	Usa marcadores ArUco para validar a presença e a orientação. Esse método oferece uma detecção estável para câmeras de ultra-wide (UW) a aplicativos tele.
`3`	`test_flip_mirror`	Usa marcadores ArUco para validar a presença e a orientação. Um status `PASS` só é concedido se todos os marcadores forem detectados e alinhados corretamente. O teste falha para gráficos deslocados ou girados.
`3`	`test_landscape_to_portrait`	Carrega o gráfico scene3 atualizado com marcadores ArUco.
`3`	`test_lens_movement_report`	Usa marcadores ArUco para validar a presença e a orientação. Esse método oferece uma detecção estável para câmeras de ultra-wide (UW) a aplicativos tele.
`4`	`test_multi_camera_alignment`	Ignora o teste se o dispositivo tiver apenas uma câmera ampla e uma câmera super tele.
`flash`	`test_auto_flash`	Atualiza o teste para verificar se o flash funciona corretamente em vários níveis de zoom.
`ip`	`test_default_jca_ip`	Exige as verificações atuais: diferença de brilho, diferença de equilíbrio de branco e incompatibilidade de campo de visão. Adiciona uma verificação `not_yet_mandated` para a diferença de renderização de cores entre o app de câmera padrão e as capturas do JCA.

Atividades de teste separadas

No Android 17, para testes paralelos em dispositivos separados, os testes ITS da câmera são separados em duas atividades do CTS Verifier: Camera ITS Test e Camera ITS Sensor Fusion Rig Test. A Camera ITS Sensor Fusion Rig Test atividade contém as feature_combination e sensor_fusion cenas e pode ser executada separadamente em um equipamento de teste de fusão de sensores. A tabela a seguir descreve as cenas incluídas em cada atividade.

Atividade	Cenas	Descrição
`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`	Cenas executadas no equipamento de teste ITS-in-a-box da câmera e no equipamento de teste Gen2.
`Camera ITS Sensor Fusion Rig Test`	`feature_combination`, `sensor_fusion`	Cenas executadas no equipamento de teste de fusão de sensores.

Testes descontinuados

No Android 17, os testes a seguir foram descontinuados porque a função de teste é coberta por outros testes:

Cena	Nome do teste	Descrição
`sensor_fusion`	`test_video_stabilization`	Esse teste foi descontinuado. Use test_video_stabilization_jca instead.

Atualizações do equipamento Gen2

No Android 17, os testes a seguir foram migrados para o equipamento Gen2:

Cena	Nome do teste	Descrição
`7`	`test_multi_camera_switch`	Migrou o teste para a configuração do equipamento Gen2 para usar o gráfico Gen2 para verificações de AE e AWB. Essa transição substitui os destinos baseados em tablet por gráficos físicos para eliminar os efeitos Moiré e oferecer um ambiente de teste mais estável e reproduzível.
`flash`	`all tests`	Migrou os testes scene_flash no equipamento Gen2. Os usuários podem executar esses testes em um equipamento de fusão de sensores ou em um ambiente de equipamento Gen2.
`sensor_fusion`	`all tests`	Migrou os testes sensor_fusion para o equipamento Gen2. Os usuários podem executar esses testes em um equipamento de fusão de sensores ou em um ambiente de equipamento Gen2.

Antes de executar os testes migrados, instale o gráfico do equipamento Gen2 introduzido no Android 17. O novo gráfico permite executar todos os testes de fusão de sensores no equipamento Gen2. Para mais informações, consulte Configurar o gráfico para testes.

Novo status de teste: PASS*

O Android 17 apresenta o status de teste PASS* para detectar testes marginalmente aprovados. Para mais informações, consulte Testes marginalmente aprovados (status de teste PASS*).

Melhorias no dimensionamento de gráficos

O Android 17 adiciona o parâmetro chart_scaling em config.yml para TEST_BED_TABLET_SCENES para lidar com os problemas de dimensionamento de gráficos com dispositivos de câmera tele de campo de visão (FoV) mais amplo. Para mais informações, consulte Melhorias no dimensionamento de gráficos: parâmetro chart_scaling.

Novo tablet para suporte a testes de ampla gama de cores

Para o Android 17 e versões mais recentes, o Samsung Galaxy Tab S10 FE (modelos Wi-Fi e 5G) está na lista de permissões de tablets. O Samsung Galaxy Tab S10 FE foi aprovado para exibir gráficos de teste de ampla gama de cores, bem como todas as outras cenas baseadas em tablet. Para verificar se o dispositivo está na lista de permissões, use o comando adb shell getprop ro.product.device para confirmar se o ID do produto corresponde ao valor listado na lista a seguir.

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

Envio de resultados agregados para aprovações de build

O Android 17 apresenta um processo para enviar resultados agregados de testes ITS da câmera para aprovação de build usando o APK atualizado do CTS Verifier.

O novo sistema de agregação oferece as seguintes melhorias:

Economia de tempo:elimina a necessidade de executar novamente cenas aprovadas em dispositivos que compartilham a mesma impressão digital do build.
Execução paralela:permite testes simultâneos de várias cenas em vários dispositivos, desde que eles compartilhem a mesma impressão digital de build.
Relatórios simplificados:permite a agregação de resultados de testes de vários relatórios do CTS Verifier (coletados de diferentes execuções de teste ou dispositivos) em um único envio unificado.

Para mais informações, consulte Enviar resultados de testes agregados.