从零搭建Camera ITS测试环境Ubuntu 20.04全流程避坑指南当Android相机模块需要验证成像质量时ITSImage Test Suite测试框架是开发者绕不开的标准化工具。但许多工程师在Ubuntu 20.04环境下搭建测试环境时往往会陷入Python依赖地狱——那些看似简单的apt-get install命令突然报出Package has no installation candidate的错误让整个工作流程戛然而止。本文将彻底解决这些痛点不仅提供Python3环境的完整配置方案还会分享测试过程中那些手册上不会写的实战技巧。1. 环境准备构建Python3兼容的ITS基础1.1 系统级依赖安装Ubuntu 20.04默认已不再维护Python2的软件源这就是为什么直接安装python-scipy等包会失败。正确的做法是使用Python3版本的包# 更新软件源 sudo apt-get update sudo apt-get upgrade -y # 安装Python3核心依赖 sudo apt-get install -y python3-numpy python3-scipy python3-matplotlib python3-opencv # 安装其他必要工具 sudo apt-get install -y adb openjdk-11-jdk git wget注意如果遇到Unable to locate package错误可尝试添加universe仓库sudo add-apt-repository universe1.2 Android SDK配置从官方镜像站下载最新版SDK Platform Tools后需要正确配置环境变量# 解压到/usr/local目录 sudo tar -xzf platform-tools-latest-linux.zip -C /usr/local/ # 编辑环境变量配置文件 echo export ANDROID_HOME/usr/local/android-sdk export PATH$PATH:$ANDROID_HOME/platform-tools | sudo tee -a /etc/profile # 立即生效 source /etc/profile验证安装是否成功adb version # 应显示类似Android Debug Bridge version 1.0.412. ITS测试框架部署2.1 获取测试套件从Android兼容性测试套件页面下载CTS Verifier包建议选择与待测设备Android版本匹配的发布包wget https://dl.google.com/dl/android/cts/android-cts-verifier-10.0_r10-linux_x86-x86.zip unzip android-cts-verifier-*.zip -d ~/CameraITS2.2 设备端APK安装编译并安装CtsVerifier应用到测试设备# 进入项目目录 cd ~/CameraITS/cts/apps/CtsVerifier # 编译APK需要已配置Android构建环境 mma -j32 # 安装到设备 adb install -r -g $OUT/system/app/CtsVerifier/CtsVerifier.apk提示如果跳过编译步骤也可以直接安装预编译的APKadb install -r -g ~/CameraITS/android-cts-verifier/CtsVerifier.apk3. Python3环境适配方案3.1 依赖包版本冲突解决原始ITS脚本是为Python2设计的在Python3环境下运行时会出现语法错误。以下是主要修改点print语句转换# 原代码 print Starting test... # 修改为 print(Starting test...)除法运算修正# 在文件开头添加 from __future__ import divisionOpenCV API更新# 原代码 cv.CV_AA # 修改为 cv.LINE_AA3.2 虚拟环境配置为避免污染系统Python环境建议使用virtualenv创建隔离环境# 安装虚拟环境工具 sudo apt-get install -y python3-venv # 创建并激活环境 python3 -m venv ~/CameraITS/venv source ~/CameraITS/venv/bin/activate # 安装所需Python包 pip install numpy scipy matplotlib opencv-python4. 测试执行与问题排查4.1 标准测试流程完整的ITS测试包含六个标准场景通过以下命令启动cd ~/CameraITS/tools python3 run_all_tests.py --camera0 --scene1各场景对应参数场景编号测试内容标准目标物0任意场景日常物体1灰卡测试18%中性灰卡2人像测试多肤色人像3解析力测试ISO12233测试卡4色彩还原测试标准色卡5镜头眩光测试点光源4.2 常见错误解决方案问题1adb devices找不到设备检查USB调试是否开启尝试重新插拔USB线运行adb kill-server adb start-server问题2OpenCV无法加载测试图像确认测试图片路径正确检查文件权限chmod -R 755 ~/CameraITS/tests/data/更新OpenCV版本pip install --upgrade opencv-python问题3数值计算精度差异导致测试失败在assert语句中添加公差范围# 原代码 assert abs(actual - expected) 0.1 # 修改为 assert abs(actual - expected) 0.5 # 放宽阈值5. 测试结果分析与报告生成测试完成后系统会在~/CameraITS/results目录下生成原始数据文件。使用以下命令生成可视化报告python3 analyze_results.py \ --input_dir./results \ --output_filereport.html \ --formatinteractive报告包含三个关键指标通过率各测试项的通过比例偏差分析实测值与期望值的标准差趋势图表不同场景下的性能表现对于失败测试项可以单独重新运行python3 test_single.py --testtest_ev_compensation --camera0 --scene2在实际项目中我们通常会遇到色彩还原测试的偏差问题。这时可以尝试调整相机3A参数后重新测试比直接修改测试标准更为规范。