2. Camera HAL 开发环境搭建：交叉编译工具链配置、Android 源码树结构、HAL 模块编译与集成方法

搭建一套可复现、可调试的 Camera HAL 开发环境，是移植适配与稳定性优化的基础。本章围绕三个核心环节展开：交叉编译工具链的选型与配置、Android 源码树的目录结构与 HAL 模块定位、以及HAL 模块的编译与集成方法。掌握这些内容后，你可以在任意 AOSP 或厂商分支上快速建立 Camera HAL 的构建与验证闭环。

2.1 交叉编译工具链配置

Camera HAL 运行在嵌入式设备（如手机、车载摄像头模组）上，开发主机通常是 x86_64 Linux 工作站，因此必须使用交叉编译工具链生成目标架构（ARM64、ARM32 或 RISC-V）的可执行文件与共享库。

2.1.1 工具链选型对比

2.1.2 工具链配置步骤（以 AOSP Clang 为例）

1. 确认主机环境：Ubuntu 20.04/22.04 LTS，安装必要依赖包：libncurses5、libssl-dev、flex、bison。
2. 下载 AOSP 源码：使用 repo init + repo sync 同步目标分支（如 android-14.0.0_r15）。
3. 加载编译环境：执行 source build/envsetup.sh 并 lunch 选择目标产品。
4. 验证工具链路径：echo $ANDROID_TOOLCHAIN 应指向 prebuilts/clang/host/linux-x86/clang-xxxx/bin/。
5. 测试交叉编译：编写一个简单的 HAL 桩文件，使用 mm 或 m 命令编译，检查输出文件架构：file out/target/product/xxx/vendor/lib64/hw/camera.xxx.so。

2.2 Android 源码树结构：HAL 模块定位

Camera HAL 模块在 AOSP 源码树中分布在多个关键目录下。理解这些目录的职责，能帮助你快速找到需要修改或移植的文件。

2.2.1 核心目录与职责

2.2.2 HAL 模块关键文件清单

2.3 HAL 模块编译与集成方法

Camera HAL 模块的编译方式取决于你使用的是传统 Android.mk 还是新的 Android.bp（Soong 构建系统）。Android 11 之后，Google 逐步废弃 Android.mk，但许多厂商分支仍保留混合构建。

2.3.1 两种构建系统对比

2.3.2 典型 Android.bp 示例（Camera HAL v3 实现）

// device/<vendor>/<board>/camera/Android.bp
cc_library_shared {
    name: "camera.<board>",
    vendor: true,
    relative_install_path: "hw",
    srcs: [
        "CameraHal.cpp",
        "CameraDevice.cpp",
        "CameraStream.cpp",
    ],
    shared_libs: [
        "libhardware",
        "libcamera_metadata",
        "libutils",
        "liblog",
        "android.hardware.camera.provider@2.4",
    ],
    static_libs: [
        "libxml2",
    ],
    cflags: [
        "-Wall",
        "-Werror",
        "-O2",
        "-DPLATFORM_SDK_VERSION=$(PLATFORM_SDK_VERSION)",
    ],
    include_dirs: [
        "device/<vendor>/<board>/include",
    ],
}

2.3.3 编译与集成步骤

1. 编写或修改 HAL 源码：在 device/<vendor>/<board>/camera/ 下实现 camera_module_t 接口。
2. 创建或更新构建文件：确保 Android.bp 或 Android.mk 中模块名与 camera.<board>.so 一致。
3. 执行编译：
   • 全量编译：m -j$(nproc) camera.<board>
   • 增量编译：mm -j$(nproc)（需在模块目录下）
4. 检查产物：out/target/product/<board>/vendor/lib64/hw/camera.<board>.so
5. 集成到系统镜像：make -j$(nproc) systemimage vendorimage 或使用 adb push 推送到设备的 /vendor/lib64/hw/ 目录。
6. 验证加载：重启设备，执行 lshal 或 dumpsys media.camera 确认 HAL 模块被 CameraService 成功加载。

2.4 开发环境验证与常见问题

2.4.1 环境验证清单

2.4.2 常见问题与解决方案

• 编译错误：undefined reference to 'HIDL_FETCH_xxx'
  原因：HIDL 接口未正确生成 C++ 实现。解决方案：确保 hardware/interfaces/camera/ 下的 .hal 文件已通过 hidl-gen 生成对应的 FooAll.cpp。
• 运行时错误：Failed to open camera HAL module
  原因：模块路径或权限问题。解决方案：确认 /vendor/lib64/hw/camera.xxx.so 存在且 SELinux context 为 u:object_r:hal_camera_default_exec:s0。
• 性能问题：预览帧率远低于预期
  原因：HAL 中未正确配置 sensor 输出格式或帧间隔。解决方案：检查 configure_streams 实现中的 stream_configuration 参数。