Catatan rilis Android 17 Camera Image Test Suite

Rilis Android 17 mencakup sejumlah perubahan pada ITS Kamera. Halaman ini merangkum perubahan ITS Kamera untuk Android 17.

Versi Python dan paket

Untuk Android 17 dan yang lebih tinggi, sebaiknya gunakan software pengelolaan paket untuk menggabungkan paket versi yang benar guna membuat lingkungan virtual untuk pengembangan rilis Android. Untuk contoh alat pengelolaan paket yang menangani sebagian besar paket yang diperlukan, lihat dokumentasi Python 3 untuk venv.

Untuk membuat lingkungan virtual dengan venv, ikuti langkah-langkah berikut:

  1. Instal Python 3.12 dan python3-venv

    sudo apt install python3.12
    sudo apt install python3.12-venv python3.12-dev
    
  2. Verifikasi penginstalan python

    python3.12 --version
    
  3. Update apt dan instal pip

    sudo apt-get update
    sudo apt install python3-pip
    
  4. Membuat lingkungan virtual

    python3.12 -m venv its_android17_env
    
  5. Aktifkan lingkungan virtual

    source its_android17_env/bin/activate
    
  6. Buat its_android17_env.txt dengan daftar paket yang diperlukan

    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
    
  7. Menginstal paket yang tercantum its_android17_env.txt

    pip install -r its_android17_env.txt
    
  8. Menginstal FFmpeg versi 7.0.2 dengan pengunduh ffmpeg

    pip install ffmpeg-downloader
    ffdl install 7.0.2
    

    (opsional) Jika downloader ffmpeg tidak berfungsi, download 7.0.2 dari sumber online.

  9. Verifikasi penginstalan FFmpeg versi 7.0.2

    ffmpeg -version
    

    Jika versi FFmpeg masih bukan 7.0.2, buat symlink biner (sesuaikan PATH berdasarkan tempat Anda menyimpan 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
    
  10. Memverifikasi paket mana yang diinstal

    pip freeze
    
  11. (Opsional) Perintah untuk menonaktifkan lingkungan:

    deactivate
    

Adegan baru atau yang diperbarui

Android 17 memperkenalkan adegan berikut:

Adegan Deskripsi
gen2_chart Adegan baru yang menggunakan test_chart_gen2 diagram kertas, bukan adegan tablet, untuk meningkatkan konsistensi dan keandalan pengujian . test_chart_gen2 juga digunakan di scene_ip.
wide_gamut Adegan baru untuk tablet dengan dukungan gamut lebar.
3 Menggunakan penanda ArUco untuk deteksi diagram guna meningkatkan kecepatan dan keandalan. Perubahan ini mengakomodasi rentang FoV dan jarak yang lebih luas yang terlihat dalam pengujian telekamera. Penggunaan penanda melewati logika penentuan ukuran dan masalah pengoptimal saat ini. Untuk mengetahui informasi selengkapnya, lihat scene3.
flash Pengujian dapat dijalankan menggunakan rig Gen2.

Tes baru

Android 17 memperkenalkan pengujian berikut:

Adegan Test name Deskripsi
gen2_chart test_tonemap_sequence Memverifikasi bahwa parameter android.tonemap.mode diterapkan dengan benar untuk distribusi seragam dan tidak seragam.
ip test_jca_jpegr_ip Memverifikasi bahwa perbedaan white balance antara pratinjau JCA JPEG_R snapshot dan gambar yang diambil berada dalam batas yang dipilih.
wide_gamut test_display_p3 Memverifikasi output JPEG P3 memiliki profil icc yang sesuai dan berisi lebih dari 1 persen warna di luar gamut sRGB.

Pengujian yang difaktorkan ulang

Di Android 17, pengujian berikut di-refactor untuk meningkatkan cakupan pengujian dan mengelompokkan pengujian secara lebih logis:

Adegan Test name Deskripsi
1_2 tests_param_tonemap_mode Versi scene1_2 dari tes tests_param_tonemap_mode tidak digunakan lagi dan hanya digunakan di perangkat yang menjalankan Android 16 atau yang lebih lama.
1_2 test_tonemap_sequence Versi scene1_2 dari pengujian test_tonemap_sequence hanya digunakan di perangkat yang menjalankan Android 16 atau yang lebih lama.
2_b test_yuv_jpeg_capture_sameness Perbedaan RMS yang lebih kecil akan membantu memastikan bahwa perbedaan warna terkait hue ditandai sebagai kegagalan setiap kali perbedaan tersebut menghasilkan perbedaan yang terlihat oleh pengguna.
3 test_edge_enhancement Menggunakan penanda ArUco untuk memvalidasi kehadiran dan orientasi. Metode ini memberikan deteksi yang stabil untuk kamera dari aplikasi Ultra-Wide (UW) hingga tele.
3 test_flip_mirror Menggunakan penanda ArUco untuk memvalidasi kehadiran dan orientasi. Status PASS hanya diberikan jika semua penanda terdeteksi dan diselaraskan dengan benar. Pengujian gagal untuk diagram yang dipindahkan atau diputar.
3 test_landscape_to_portrait Memuat diagram scene3 yang diperbarui dengan penanda ArUco.
3 test_lens_movement_report Menggunakan penanda ArUco untuk memvalidasi kehadiran dan orientasi. Metode ini memberikan deteksi yang stabil untuk kamera dari aplikasi Ultra-Wide (UW) hingga tele.
4 test_multi_camera_alignment Melewati pengujian jika perangkat hanya memiliki satu kamera lebar dan satu kamera TELE super.
flash test_auto_flash Memperbarui pengujian untuk memverifikasi bahwa flash berfungsi dengan baik pada berbagai tingkat zoom.
ip test_default_jca_ip Mewajibkan pemeriksaan yang ada: perbedaan kecerahan, perbedaan white balance, dan ketidakcocokan FoV. Menambahkan pemeriksaan not_yet_mandated untuk perbedaan rendering warna antara aplikasi kamera default dan pengambilan gambar JCA.

Aktivitas pengujian terpisah

Di Android 17, untuk pengujian paralel di perangkat terpisah, pengujian ITS kamera dipisahkan menjadi dua aktivitas CTS Verifier, Camera ITS Test dan Camera ITS Sensor Fusion Rig Test. Aktivitas Camera ITS Sensor Fusion Rig Test berisi adegan feature_combination dan sensor_fusion, dan dapat dijalankan secara terpisah dalam platform pengujian penggabungan sensor. Tabel berikut menjelaskan adegan yang disertakan dalam setiap aktivitas.

Aktivitas Adegan Deskripsi
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 Adegan yang berjalan di rig pengujian ITS-in-a-box kamera dan rig pengujian Gen2.
Camera ITS Sensor Fusion Rig Test feature_combination, sensor_fusion Adegan yang berjalan di rangkaian pengujian sensor fusion.

Pengujian yang tidak digunakan lagi

Di Android 17, pengujian berikut tidak digunakan lagi karena fungsi pengujiannya tercakup oleh pengujian lain:

Adegan Test name Deskripsi
sensor_fusion test_video_stabilization Pengujian ini tidak digunakan lagi. Gunakan test_video_stabilization_jca sebagai gantinya.

Pembaruan rig Gen2

Di Android 17, pengujian berikut telah dimigrasikan ke Gen2 rig:

Adegan Test name Deskripsi
7 test_multi_camera_switch Memigrasikan pengujian ke penyiapan rig gen2 untuk menggunakan diagram Gen2 untuk pemeriksaan AE dan AWB. Transisi ini menggantikan target berbasis tablet dengan kartu fisik untuk menghilangkan efek Moiré dan memberikan lingkungan pengujian yang lebih stabil dan dapat direproduksi.
flash all tests Memigrasikan pengujian scene_flash di rig gen2. Pengguna dapat menjalankan pengujian ini di lingkungan sensor fusion rig atau Gen2 rig.
sensor_fusion all tests Memigrasikan pengujian sensor_fusion ke platform gen2. Pengguna dapat menjalankan pengujian ini di lingkungan sensor fusion rig atau Gen2 rig.

Sebelum menjalankan pengujian yang dimigrasikan, instal diagram rig Gen2 yang diperkenalkan di Android 17. Dengan diagram baru, Anda dapat menjalankan semua pengujian penggabungan sensor di platform Gen2. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan diagram untuk pengujian.

Status pengujian baru: LULUS*

17 memperkenalkan status pengujian PASS* untuk mendeteksi pengujian yang lulus secara marginal. Untuk mengetahui informasi selengkapnya, lihat Pengujian yang lulus secara marjinal (status pengujian LULUS*).

Peningkatan penskalaan diagram

Android 17 menambahkan parameter chart_scaling di config.yml untuk TEST_BED_TABLET_SCENES guna menangani masalah penskalaan diagram dengan perangkat kamera tele yang memiliki ruang pandang (FoV) lebih lebar. Untuk mengetahui informasi selengkapnya, lihat Peningkatan penskalaan diagram: parameter chart_scaling.

Tablet baru untuk dukungan pengujian gamut lebar

Untuk Android 17 dan yang lebih tinggi, Samsung Galaxy Tab S10 FE (model Wi-Fi dan 5G) ada dalam daftar perangkat tablet yang diizinkan. Samsung Galaxy Tab S10 FE disetujui untuk menampilkan diagram uji gamut lebar, serta semua adegan berbasis tablet lainnya. Untuk memverifikasi bahwa perangkat Anda ada dalam daftar yang diizinkan, gunakan perintah adb shell getprop ro.product.device untuk mengonfirmasi bahwa ID produk cocok dengan nilai yang tercantum dalam daftar berikut.

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

Pengiriman hasil gabungan untuk persetujuan build

Android 17 memperkenalkan proses untuk mengirimkan hasil pengujian ITS Kamera gabungan untuk persetujuan build menggunakan APK CTS Verifier yang telah diupdate.

Sistem agregasi baru memberikan peningkatan berikut:

  • Penghematan waktu: Menghilangkan kebutuhan untuk menjalankan ulang adegan yang sama berulang kali di perangkat yang memiliki sidik jari build yang sama.
  • Eksekusi paralel: Memungkinkan pengujian serentak beberapa adegan di beberapa perangkat, asalkan perangkat tersebut memiliki sidik jari build yang sama.
  • Pelaporan yang disederhanakan: Memungkinkan penggabungan hasil pengujian dari beberapa laporan CTS Verifier (yang dikumpulkan dari berbagai pengujian atau perangkat) ke dalam satu pengiriman terpadu.

Untuk mengetahui informasi selengkapnya, lihat Mengirimkan hasil pengujian gabungan.