A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Note di rilascio della suite di test delle immagini della fotocamera di Android 17

La release di Android 17 include una serie di modifiche a Camera ITS. Questa pagina riassume le modifiche di Camera ITS per Android 17.

Versioni di Python e dei pacchetti

Per Android 17 e versioni successive, ti consigliamo vivamente di utilizzare un software di gestione dei pacchetti per raggruppare le versioni corrette dei pacchetti e creare un ambiente virtuale per lo sviluppo della release di Android. Per un esempio di strumento di gestione dei pacchetti che gestisce la maggior parte dei pacchetti richiesti, consulta la documentazione di Python 3 per venv.

Per creare l'ambiente virtuale con venv:

Installa Python 3.14 e python3-venv

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

Verifica l'installazione di Python
```
python3.14 --version
```

Aggiorna apt e installa pip

sudo apt-get update
sudo apt install python3-pip

Crea un ambiente virtuale
```
python3.14 -m venv its_android17_env
```
Attiva l'ambiente virtuale
```
source its_android17_env/bin/activate
```

Crea its_android17_env.txt con l'elenco dei pacchetti richiesti

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

Installa i pacchetti elencati in its_android17_env.txt
```
pip install -r its_android17_env.txt
```
Installa FFmpeg versione 7.0.2 con il downloader di FFmpeg
```
pip install ffmpeg-downloader
ffdl install 7.0.2
```
(Facoltativo) Se il downloader di FFmpeg non funziona, scarica la versione 7.0.2 da una fonte online.

Verifica l'installazione di FFmpeg versione 7.0.2

ffmpeg -version

Se la versione di FFmpeg non è ancora 7.0.2, crea un link simbolico ai file binari (modifica PATH in base alla posizione in cui salvi 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 quali pacchetti sono installati
```
pip freeze
```
(Facoltativo) Comando per disattivare l'ambiente:
```
deactivate
```

Scene nuove o aggiornate

Android 17 introduce le seguenti scene:

Scena	Descrizione
`gen2_chart`	Nuova scena che utilizza il grafico cartaceo `test_chart_gen2` anziché le scene del tablet per migliorare la coerenza e l'affidabilità dei test. Il grafico `test_chart_gen2` viene utilizzato anche in `scene_ip`.
`wide_gamut`	Nuova scena per i tablet con supporto per la gamma cromatica estesa.
`3`	Utilizza i marcatori ArUco per il rilevamento dei grafici per migliorare la velocità e l'affidabilità. Questa modifica supporta la gamma più ampia di FoV e distanze osservate nei test della fotocamera con teleobiettivo. L'utilizzo dei marcatori aggira la logica di ridimensionamento e i problemi di ottimizzazione attuali. Per ulteriori informazioni, consulta scene3.
`flash`	I test possono essere eseguiti utilizzando il rig Gen2.

Nuovi test

Android 17 introduce i seguenti test:

Scena	Nome del test	Descrizione
`gen2_chart`	`test_tonemap_sequence`	Verifica che il parametro `android.tonemap.mode` venga applicato correttamente per la distribuzione uniforme e non uniforme.
`ip`	`test_jca_jpegr_ip`	Verifica che la differenza di bilanciamento del bianco tra l'anteprima JPEG_R JCA e le immagini acquisite rientri nella soglia scelta.
`wide_gamut`	`test_display_p3`	Verifica che l'output JPEG P3 abbia un profilo ICC appropriato e contenga più dell'1% di colori al di fuori della gamma sRGB.

Test sottoposti a refactoring

In Android 17, i seguenti test sono stati sottoposti a refactoring per aumentare la copertura dei test e raggrupparli in modo più logico:

Scena	Nome del test	Descrizione
`1_2`	`tests_param_tonemap_mode`	La versione scene1_2 del test tests_param_tonemap_mode è obsoleta e viene utilizzata solo sui dispositivi con Android 16 o versioni precedenti.
`1_2`	`test_tonemap_sequence`	La versione scene1_2 del test test_tonemap_sequence viene utilizzata solo sui dispositivi con Android 16 o versioni precedenti.
`2_b`	`test_yuv_jpeg_capture_sameness`	La soglia di differenza RMS è stata ridotta per garantire che le discrepanze di colore correlate alla tonalità vengano segnalate come errori ogni volta che comportano una differenza visibile per l'utente.
`3`	`test_edge_enhancement`	Utilizza i marcatori ArUco per convalidare sia la presenza sia l'orientamento. Questo metodo fornisce un rilevamento stabile per le fotocamere, dalle applicazioni ultra-grandangolari (UW) a quelle con teleobiettivo.
`3`	`test_flip_mirror`	Utilizza i marcatori ArUco per convalidare sia la presenza sia l'orientamento. Lo stato `PASS` viene concesso solo se tutti i marcatori vengono rilevati e allineati correttamente. Il test non riesce per i grafici spostati o ruotati.
`3`	`test_landscape_to_portrait`	Carica il grafico scene3 aggiornato con i marcatori ArUco.
`3`	`test_lens_movement_report`	Utilizza i marcatori ArUco per convalidare sia la presenza sia l'orientamento. Questo metodo fornisce un rilevamento stabile per le fotocamere, dalle applicazioni ultra-grandangolari (UW) a quelle con teleobiettivo.
`4`	`test_multi_camera_alignment`	Salta il test se il dispositivo ha una sola fotocamera grandangolare e una sola fotocamera con super teleobiettivo.
`flash`	`test_auto_flash`	Aggiorna il test per verificare che il flash funzioni correttamente a vari livelli di zoom.
`ip`	`test_default_jca_ip`	Impone i controlli esistenti: differenza di luminosità, differenza di bilanciamento del bianco e mancata corrispondenza del FoV. Aggiunge un controllo `not_yet_mandated` per la differenza di rendering dei colori tra l'app Fotocamera predefinita e le acquisizioni JCA.

Attività di test separate

In Android 17, per i test paralleli su dispositivi separati, i test di Camera ITS sono suddivisi in due attività di CTS Verifier, Camera ITS Test e Camera ITS Sensor Fusion Rig Test. L' Camera ITS Sensor Fusion Rig Test attività contiene le scene feature_combination e sensor_fusion e può essere eseguita separatamente in un rig di test di fusione dei sensori. La tabella seguente descrive le scene incluse in ogni attività.

Attività	Scene	Descrizione
`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`	Scene eseguite nel rig di test di Camera ITS-in-a-box e nel rig di test Gen2.
`Camera ITS Sensor Fusion Rig Test`	`feature_combination`, `sensor_fusion`	Scene eseguite nel rig di test di fusione dei sensori.

Test obsoleti

In Android 17, i seguenti test sono obsoleti perché la funzione di test è coperta da altri test:

Scena	Nome del test	Descrizione
`sensor_fusion`	`test_video_stabilization`	Questo test è obsoleto. Utilizza test_video_stabilization_jca invece.

Aggiornamenti del rig Gen2

In Android 17, i seguenti test sono stati migrati a il rig Gen2:

Scena	Nome del test	Descrizione
`7`	`test_multi_camera_switch`	È stata eseguita la migrazione del test alla configurazione del rig Gen2 per utilizzare il grafico Gen2 per i controlli AE e AWB. Questa transizione sostituisce i target basati su tablet con grafici fisici per eliminare gli effetti moiré e fornire un ambiente di test più stabile e riproducibile.
`flash`	`all tests`	È stata eseguita la migrazione dei test scene_flash nel rig Gen2. Gli utenti possono eseguire questi test in un ambiente di rig di fusione dei sensori o di rig Gen2.
`sensor_fusion`	`all tests`	È stata eseguita la migrazione dei test sensor_fusion al rig Gen2. Gli utenti possono eseguire questi test in un ambiente di rig di fusione dei sensori o di rig Gen2.

Prima di eseguire i test migrati, installa il grafico del rig Gen2 introdotto in Android 17. Il nuovo grafico ti consente di eseguire tutti i test di fusione dei sensori nel rig Gen2. Per ulteriori informazioni, consulta Configurare il grafico per i test.

Nuovo stato del test: PASS*

Android 17 introduce lo stato del test PASS* per rilevare i test che superano il test di poco. Per ulteriori informazioni, consulta Test che superano il test di poco (stato del test PASS*).

Miglioramenti al ridimensionamento dei grafici

Android 17 aggiunge il parametro chart_scaling in config.yml per TEST_BED_TABLET_SCENES per gestire i problemi di ridimensionamento dei grafici con i dispositivi con fotocamera con teleobiettivo con campo visivo (FoV) più ampio. Per ulteriori informazioni, consulta Miglioramenti al ridimensionamento dei grafici: parametro chart_scaling.

Nuovo tablet per il supporto dei test con gamma cromatica estesa

Per Android 17 e versioni successive, Samsung Galaxy Tab S10 FE (modelli Wi-Fi e 5G) è incluso nella lista consentita dei tablet. Samsung Galaxy Tab S10 FE è approvato per la visualizzazione dei grafici di test con gamma cromatica estesa, nonché di tutte le altre scene basate su tablet. Per verificare che il tuo dispositivo sia nella lista consentita, utilizza il comando adb shell getprop ro.product.device per verificare che l'ID prodotto corrisponda al valore elencato nell'elenco seguente.

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

Invio dei risultati aggregati per le approvazioni delle build

Android 17 introduce una procedura per l'invio dei risultati aggregati dei test di Camera ITS per l'approvazione delle build utilizzando l'APK di CTS Verifier aggiornato.

Il nuovo sistema di aggregazione offre i seguenti miglioramenti:

Risparmio di tempo: elimina la necessità di eseguire ripetutamente le scene che superano il test sui dispositivi che condividono la stessa fingerprint build.
Esecuzione parallela: consente di eseguire test simultanei di più scene su più dispositivi, a condizione che condividano la stessa impronta digitale della build.
Report semplificati: consente di aggregare i risultati dei test di più report di CTS Verifier (raccolti da esecuzioni o dispositivi di test diversi) in un unico invio unificato.

Per ulteriori informazioni, consulta Inviare i risultati dei test aggregati.