Android 17 相机图像测试套件版本说明

Android 17 版包含对 相机 ITS 的多项更改。本页中总结了 Android 17 的相机 ITS 更改。

Python 和软件包版本

对于 Android 17 及更高版本，我们强烈建议使用软件包管理软件将正确版本的软件包捆绑在一起，以便为 Android 版本开发创建虚拟环境。如需查看处理所需大多数软件包的示例软件包 管理工具，请参阅有关 venv 的 Python 3 文档。

如需使用 venv 创建虚拟环境，请按以下步骤操作：

  1. 安装 Python 3.12 和 python3-venv

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

  2. 验证 Python 安装

    python3.12 --version

  3. 更新 apt 并安装 pip

    sudo apt-get update
sudo apt install python3-pip

  4. 创建虚拟环境

    python3.12 -m venv its_android17_env

  5. 激活虚拟环境

    source its_android17_env/bin/activate

  6. 使用所需软件包列表创建 its_android17_env.txt

    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. 安装 its_android17_env.txt 中列出的软件包

    pip install -r its_android17_env.txt

  8. 使用 ffmpeg 下载器安装 FFmpeg 7.0.2 版

    pip install ffmpeg-downloader
ffdl install 7.0.2

    （可选）如果 ffmpeg 下载器无法正常运行，请从在线来源下载 7.0.2 版。

  9. 验证 FFmpeg 7.0.2 版的安装

    ffmpeg -version

    如果 FFmpeg 版本仍然不是 7.0.2，请对二进制文件进行符号链接（根据您保存 its_android17_env 的位置调整 PATH）。

    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. 验证已安装的软件包

    pip freeze

  11. （可选）停用环境的命令：

    deactivate

新增场景或更新后的场景

Android 17 引入了以下场景：

场景 说明
gen2_chart 新场景，使用 test_chart_gen2 纸质图表而不是平板电脑场景，以提高测试一致性和可靠性。scene_ip 中也使用了 test_chart_gen2。
wide_gamut 适用于支持广色域的平板电脑的新场景。
3 使用 ArUco 标记进行图表检测，以提高速度和可靠性。 此更改适用于远摄相机测试中看到的更广泛的 FoV 和距离。使用标记可绕过当前的尺寸调整逻辑和优化器问题。如需了解详情，请参阅 scene3。
flash 可以使用 Gen2 装置运行测试。

新测试

Android 17 引入了以下测试：

场景 测试名称 说明
gen2_chart test_tonemap_sequence 验证 android.tonemap.mode 参数是否正确应用于均匀和非均匀分布。
ip test_jca_jpegr_ip 验证 JPEG_R JCA 预览快照与拍摄的图像之间的白平衡差异是否在所选阈值范围内。
wide_gamut test_display_p3 验证 P3 JPEG 输出是否具有适当的 icc 色彩特性文件，并且包含超过 1% 的 sRGB 色域之外的颜色。

重构的测试

在 Android 17 中，下列测试已被重构，以扩大测试覆盖率并更合理地将测试分组：

场景 测试名称 说明
1_2 tests_param_tonemap_mode tests_param_tonemap_mode 测试的 scene1_2 版本已废弃，仅在搭载 Android 16 或更低版本的设备上使用。
1_2 test_tonemap_sequence test_tonemap_sequence 测试的 scene1_2 版本仅在搭载 Android 16 或更低版本的设备上使用。
2_b test_yuv_jpeg_capture_sameness 降低了 RMS 差异阈值，以帮助确保每当色调相关的颜色差异导致用户看到可见差异时，都会将这些差异标记为失败。
3 test_edge_enhancement 使用 ArUco 标记来验证存在性和方向。此方法 为从超广角 (UW) 到 远摄应用的相机提供稳定的检测。
3 test_flip_mirror 使用 ArUco 标记来验证存在性和方向。 只有在检测到所有标记并 正确对齐时，才会授予 PASS 状态。对于移位或旋转的图表，测试会失败。
3 test_landscape_to_portrait 加载带有 ArUco 标记的更新后的 scene3 图表。
3 test_lens_movement_report 使用 ArUco 标记来验证存在性和方向。此方法 为从超广角 (UW) 到 远摄应用的相机提供稳定的检测。
4 test_multi_camera_alignment 如果设备只有一个广角相机和一个超远摄相机，则跳过测试。
flash test_auto_flash 更新测试，以验证闪光灯在各种缩放级别下是否正常工作。
ip test_default_jca_ip 强制执行现有检查：亮度差异、白平衡差异和 FoV 不匹配。为默认相机应用和 JCA 拍摄之间的颜色呈现差异添加 not_yet_mandated 检查。

分离的测试 activity

在 Android 17 中，为了在单独的设备上进行并行测试，相机 ITS 测试被分为两个 CTS 验证程序 activity：Camera ITS Test 和 Camera ITS Sensor Fusion Rig Test。The Camera ITS Sensor Fusion Rig Test activity 包含 feature_combination 和 sensor_fusion 场景，并且可以在传感器融合测试装置中 单独运行。下表介绍了每个 activity 中包含的场景。

activity 场景 说明
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 在 相机盒装 ITS 测试装置和 Gen2 测试装置中运行的场景。
Camera ITS Sensor Fusion Rig Test feature_combination、sensor_fusion 在 传感器融合测试装置中运行的场景。

已废弃的测试

在 Android 17 中，以下测试已废弃，因为相应的测试功能已涵盖在其他测试中：

场景 测试名称 说明
sensor_fusion test_video_stabilization 此测试已废弃。请改用 test_video_stabilization_jca 。

Gen2 装置更新

在 Android 17 中，以下测试已迁移到 Gen2 装置：

场景 测试名称 说明
7 test_multi_camera_switch 将测试迁移到 Gen2 装置设置，以使用 Gen2 图表进行 AE 和 AWB 检查。此转换将基于平板电脑的目标替换为实体图表，以消除莫尔效应并提供更稳定、可重现的测试环境。
flash all tests 在 Gen2 装置中迁移了 scene_flash 测试。用户可以在传感器融合装置或 Gen2 装置环境中执行这些测试。
sensor_fusion all tests 将 sensor_fusion 测试迁移到 Gen2 装置。用户可以在传感器融合装置或 Gen2 装置环境中执行这些测试。

在运行迁移的测试之前，请安装 Android 17 中引入的 Gen2 装置图表。借助新图表，您可以在 Gen2 装置中运行所有传感器融合测试。如需了解详情，请参阅设置图表以进行 测试。

新测试状态：PASS*

17 引入了测试状态 PASS*，用于检测勉强通过的测试。如需了解详情，请参阅勉强通过的测试 （PASS* 测试状态）。

图表缩放改进

Android 17 在 config.yml 中为 TEST_BED_TABLET_SCENES 添加了 chart_scaling 参数，以处理具有更广视野范围 (FoV) 的远摄相机设备的图表缩放问题。如需了解详情，请参阅 图表缩放改进：chart_scaling 参数。

支持广色域测试的新平板电脑

对于 Android 17 及更高版本，Samsung Galaxy Tab S10 FE（Wi-Fi 和 5G 型号）在平板电脑许可名单中。Samsung Galaxy Tab S10 FE 已获准显示广色域测试图表以及所有其他基于平板电脑的场景。如需验证您的设备是否在许可名单中，请使用命令 adb shell getprop ro.product.device 确认产品 ID 与以下列表中列出的值匹配。

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

提交汇总结果以进行 build 审批

Android 17 引入了一个流程，用于使用更新后的 CTS 验证程序 APK 提交汇总的相机 ITS 测试结果以进行 build 审批。

新的汇总系统提供了以下改进：

  • 节省时间 ：无需在共享同一 build 指纹的设备上重复重新运行通过的场景。
  • 并行执行 ：允许跨多个设备同时测试多个场景，前提是这些设备共享同一 build 指纹。
  • 简化报告 ：能够将来自多个 CTS 验证程序报告（从不同的测试运行或设备收集）的测试结果汇总到单个统一提交中。

如需了解详情，请参阅提交汇总测试结果。