A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco 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, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 no ITS da câmera para Android 17.

Versões do Python e de pacotes

Para o Android 17 e versões mais recentes, recomendamos usar 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 lida com a maioria dos pacotes necessários, consulte a documentação do Python 3 para venv.

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

Instale o Python 3.12 e o python3-venv

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

Verificar a instalação do Python
```
python3.12 --version
```

Atualizar o apt e instalar o pip

sudo apt-get update
sudo apt install python3-pip

Crie um ambiente virtual
```
python3.12 -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.

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

Instalar pacotes listados its_android17_env.txt
```
pip install -r its_android17_env.txt
```
Instalar 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, baixe a versão 7.0.2 de uma fonte on-line.

Verificar a instalação do FFmpeg versão 7.0.2

ffmpeg -version

Se a versão do FFmpeg ainda não for 7.0.2, crie um link simbólico para os 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

Verificar 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.
`3`	Usa marcadores ArUco para detecção de gráficos e melhora a velocidade e a confiabilidade. Essa mudança acomoda a faixa mais ampla de campo de visão e distâncias observadas nos testes de telecâmera. O uso de marcadores evita a lógica de dimensionamento e os problemas do otimizador atuais. Para mais informações, consulte scene3.
`flash`	Os testes podem ser executados usando o rig Gen2.

Novos testes

O Android 17 introduz 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 instantâneo de prévia do JCA JPEG_R 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 foram refatorados para aumentar a cobertura e agrupar os testes de maneira 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 está descontinuada e é usada apenas em dispositivos com 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 RMS é reduzido para garantir que as discrepâncias de cores relacionadas à tonalidade 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 de teleobjetiva.
`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 de teleobjetiva.
`4`	`test_multi_camera_alignment`	Pula o teste se o dispositivo tiver apenas uma câmera grande angular e uma superteleobjetiva.
`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 da JCA.

Atividades de teste separadas

No Android 17, para testes paralelos em dispositivos separados, os testes ITS da câmera são divididos em duas atividades do CTS Verifier, Camera ITS Test e Camera ITS Sensor Fusion Rig Test. A atividade Camera ITS Sensor Fusion Rig Test contém as cenas feature_combination e sensor_fusion, 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 seguintes testes foram descontinuados porque a função de teste é coberta por outros testes:

Cena	Nome do teste	Descrição
`sensor_fusion`	`test_video_stabilization`	Este teste foi descontinuado. Use test_video_stabilization_jca em vez disso.

Atualizações do rig Gen2

No Android 17, os seguintes testes foram migrados para o rig Gen2:

Cena	Nome do teste	Descrição
`7`	`test_multi_camera_switch`	Migramos o teste para a configuração de plataforma gen2 para usar o gráfico Gen2 nas verificações de AE e AWB. Essa transição substitui os alvos baseados em tablets 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`	Testes de scene_flash migrados no rig gen2. Os usuários podem executar esses testes em um ambiente de plataforma de fusão de sensores ou de plataforma Gen2.
`sensor_fusion`	`all tests`	Migramos os testes sensor_fusion para o equipamento de segunda geração. Os usuários podem executar esses testes em um ambiente de plataforma de fusão de sensores ou de plataforma Gen2.

Antes de executar os testes migrados, instale o gráfico de rig Gen2 apresentado no Android 17. Com o novo gráfico, é possível 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 do teste: PASS*

O 17 introduz o status de teste PASS* para detectar testes aprovados por pouco. Para mais informações, consulte Testes aprovados por pouco (status do teste PASS*).

Melhorias no escalonamento de gráficos

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

Novo tablet para suporte a testes de ampla gama

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ão de tablets. O Samsung Galaxy Tab S10 FE é aprovado para exibir gráficos de teste de ampla gama, 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 abaixo.

    '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 do Camera ITS 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 repetidamente cenas de aprovação em dispositivos que compartilham a mesma impressão digital do build.
Execução paralela:permite o teste simultâneo de várias cenas em vários dispositivos, desde que eles compartilhem a mesma impressão digital de build.
Relatórios simplificados:permite agregar 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 agregados de testes.