Catatan rilis Android 17 Camera Image Test Suite

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

Versi Python dan paket

Untuk Android 17 dan yang lebih tinggi, sebaiknya gunakan software pengelolaan paket untuk memaketkan versi paket 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. Buat 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. Instal paket yang tercantum di its_android17_env.txt

    pip install -r its_android17_env.txt
    
  8. Instal FFmpeg versi 7.0.2 dengan ffmpeg downloader

    pip install ffmpeg-downloader
    ffdl install 7.0.2
    

    (opsional) Jika ffmpeg downloader 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. Verifikasi paket 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 diagram kertas test_chart_gen2, 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 kamera tele. Penggunaan penanda akan melewati masalah pengoptimal dan logika ukuran saat ini. Untuk mengetahui informasi selengkapnya, lihat scene3.
flash Pengujian dapat dijalankan menggunakan rig Gen2.

Pengujian 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 snapshot pratinjau JPEG_R JCA dan gambar yang diambil berada dalam nilai minimum 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 di-refactor

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 pengujian 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 Nilai minimum perbedaan RMS dikurangi untuk membantu memastikan bahwa perbedaan warna terkait hue ditandai sebagai kegagalan setiap kali perbedaan tersebut menghasilkan perbedaan yang terlihat bagi pengguna.
3 test_edge_enhancement Menggunakan penanda ArUco untuk memvalidasi keberadaan 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 keberadaan dan orientasi. Status PASS hanya diberikan jika semua penanda terdeteksi dan disejajarkan 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 keberadaan 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 level 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 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 di rig pengujian sensor fusion. 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 rig pengujian sensor fusion.

Pengujian yang tidak digunakan lagi

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

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

Info terbaru tentang rig Gen2

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

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 diagram fisik untuk menghilangkan efek Moiré dan menyediakan 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 rig sensor fusion atau rig Gen2.
sensor_fusion all tests Memigrasikan pengujian sensor_fusion ke rig gen2. Pengguna dapat menjalankan pengujian ini di lingkungan rig sensor fusion atau rig Gen2.

Sebelum menjalankan pengujian yang dimigrasikan, instal diagram rig Gen2 yang diperkenalkan di Android 17. Diagram baru ini memungkinkan Anda menjalankan semua pengujian sensor fusion di rig 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 marginal (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 ruang pandang (FoV) yang lebih luas. 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) berada dalam daftar yang diizinkan untuk tablet. Samsung Galaxy Tab S10 FE disetujui untuk menampilkan diagram pengujian gamut lebar, serta semua adegan berbasis tablet lainnya. Untuk memverifikasi bahwa perangkat Anda berada 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 Camera ITS gabungan untuk persetujuan build menggunakan CTS Verifier APK yang diperbarui.

Sistem agregasi baru ini memberikan peningkatan berikut:

  • Penghematan waktu: Menghilangkan kebutuhan untuk menjalankan ulang adegan yang lulus secara berulang kali di perangkat yang memiliki sidik jari build yang sama.
  • Eksekusi paralel: Memungkinkan pengujian beberapa adegan secara bersamaan 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 perangkat atau pengujian yang berbeda) ke dalam satu pengiriman terpadu.

Untuk mengetahui informasi selengkapnya, lihat Mengirimkan hasil pengujian gabungan.