2. 开发环境搭建：Camera HAL源码获取与编译、模拟器与真机调试环境配置、adb与logcat基础使用

Camera HAL 开发环境的搭建是后续所有工程排查与案例调试的基础。本章将系统性地讲解从源码获取、编译环境配置，到模拟器与真机调试环境的搭建，以及 adb 和 logcat 的核心使用方法。一个稳定、可复现的开发环境能够大幅提升问题定位与修复的效率。

2.1 Camera HAL 源码获取与编译

Camera HAL 源码通常集成在 Android 开源项目（AOSP）中，位于 hardware/interfaces/camera 或 hardware/qcom/camera（高通平台）等路径下。获取源码的方式取决于开发目标：是进行通用 HAL 开发，还是针对特定芯片平台（如 Qualcomm、MediaTek、Rockchip）进行适配。

2.1.1 源码获取方式对比

2.1.2 编译环境配置与构建流程

编译 Camera HAL 需要完整的 Android 编译环境。以下为基于 Ubuntu 22.04 的标准配置步骤：

1. 安装依赖包：sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 libncurses5 lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig
2. 配置 Java 环境：Android 14 需要 OpenJDK 17，使用 sudo apt-get install openjdk-17-jdk 安装并设置 JAVA_HOME。
3. 初始化编译环境：在 AOSP 根目录执行 source build/envsetup.sh。
4. 选择目标：lunch aosp_arm64-userdebug（模拟器）或 lunch <device>-userdebug（真机）。
5. 编译 Camera HAL 模块：make camera.device@3.4 -j$(nproc) 或 make libcameraservice -j$(nproc)。

2.2 模拟器与真机调试环境配置

调试环境的选择直接影响 Camera HAL 问题的复现与定位效率。模拟器适合早期功能验证和 CTS 测试，真机则用于硬件相关问题的排查。

2.2.1 模拟器调试环境

Android 模拟器支持虚拟 Camera 设备，可以通过 -camera-back 和 -camera-front 参数指定虚拟摄像头源。对于 HAL 调试，推荐使用 emulator -avd <avd_name> -camera-back virtualscene -camera-front webcam0 来模拟不同场景。

2.2.2 真机调试环境

真机调试是 Camera HAL 开发的主要场景。以下为关键配置步骤：

• 解锁 Bootloader：不同厂商解锁方式不同，通常需要申请解锁码或使用 fastboot 命令。
• 刷入 userdebug 或 eng 版本：只有 userdebug/eng 版本才支持 root 权限和完整的调试功能。
• 关闭 SELinux 或设置为 permissive 模式：adb shell setenforce 0，避免权限策略干扰 HAL 调试。
• 替换 HAL 库：adb root 后 adb remount，将编译好的 camera.<platform>.so push 到 /vendor/lib64/hw/ 或 /system/lib64/hw/。
• 重启 HAL 服务：adb shell killall cameraserver 或 adb shell stop; adb shell start。

2.3 adb 与 logcat 基础使用

adb（Android Debug Bridge）和 logcat 是 Camera HAL 调试中最核心的工具。熟练使用这两个工具，能够快速获取设备状态、捕获日志、定位崩溃点。

2.3.1 adb 常用命令速查

2.3.2 logcat 过滤与 Camera HAL 日志分析

Camera HAL 的日志输出通常使用 ALOGV/ALOGD/ALOGE 宏，对应的 logcat tag 为 CameraHAL、Camera3-Device、CameraService 等。以下为高效过滤命令：

# 仅显示 Camera HAL 相关日志
adb logcat -s CameraHAL

# 显示 CameraService 和 HAL 的详细日志，并包含时间戳
adb logcat -v time CameraService:V CameraHAL:V *:S

# 捕获所有错误级别日志，并保存到文件
adb logcat -b main -b system -b crash *:E > camera_hal_errors.log

# 实时过滤包含特定关键字的日志（如 "open"、"configure"、"error"）
adb logcat | grep -E "(CameraHAL|open|configure|error)"

2.4 开发环境整体架构

以下 SVG 图展示了 Camera HAL 开发环境的整体架构，包括源码获取、编译、部署与调试的完整链路：

2.5 常见环境问题与排查清单

开发环境搭建过程中，以下问题最为常见，建议在遇到异常时优先对照排查：