Camera HAL工程实战：从移植到量产优化 - 第3节

3.1 交叉编译工具链配置

Camera HAL 模块最终运行在嵌入式设备（如手机、平板、IoT 摄像头）的 Linux 内核之上，而非开发主机（x86_64）。因此，必须使用交叉编译工具链，在主机上编译出目标架构（ARM64、ARM32、RISC-V 等）的可执行文件与共享库。

3.1.1 工具链选择与安装

Android 官方推荐使用 Clang/LLVM 作为默认编译器，GCC 已逐步弃用。在 AOSP 源码树中，预编译工具链位于 prebuilts/clang/host/linux-x86/ 目录下。对于 Camera HAL 开发，通常不需要手动安装独立工具链，而是通过 Android 构建系统（Soong / Make）自动调用。

3.1.2 环境变量与构建配置

在开始编译 Camera HAL 之前，需要正确设置以下环境变量（通常通过 source build/envsetup.sh 和 lunch 自动完成）：

• ANDROID_BUILD_TOP：AOSP 源码根目录。
• ANDROID_PRODUCT_OUT：编译产物输出目录。
• ANDROID_HOST_OUT：主机工具输出目录。
• PATH：必须包含 $ANDROID_BUILD_TOP/prebuilts/clang/host/linux-x86/clang-版本/bin。

# 典型初始化流程
cd ~/aosp
source build/envsetup.sh
lunch aosp_arm64-userdebug
# 验证工具链
which clang
# 输出应指向 prebuilts/clang/.../clang
clang --version
# 确认目标 triple 为 aarch64-linux-android

3.2 Android 源码树结构

Camera HAL 开发人员必须熟悉 AOSP 源码树中与 Camera 相关的关键目录。错误的文件放置位置会导致编译系统找不到模块或依赖。

3.2.1 Camera 相关目录全景

3.2.2 关键目录职责

3.3 HAL 模块编译与集成流程

从零开始将一个 Camera HAL 模块集成到 AOSP 构建系统中，需要依次完成模块声明、依赖配置、编译脚本编写、产物打包四个步骤。

3.3.1 模块声明与 Android.bp

Android 新构建系统使用 Blueprint/Soong，配置文件为 Android.bp（取代旧式的 Android.mk）。以下是一个典型的 Camera HAL 模块 Android.bp 示例：

// device/vendor/board/camera/Android.bp
cc_library_shared {
    name: "camera.<vendor>.<board>",
    vendor: true,
    relative_install_path: "hw",
    srcs: [
        "CameraHAL.cpp",
        "CameraDevice.cpp",
        "CameraStream.cpp",
    ],
    shared_libs: [
        "libhardware",
        "libcutils",
        "libutils",
        "liblog",
        "libcamera_metadata",
        "libsync",
    ],
    header_libs: [
        "camera_metadata_headers",
    ],
    cflags: [
        "-Wall",
        "-Werror",
        "-O2",
        "-DPLATFORM_SDK_VERSION=$(PLATFORM_SDK_VERSION)",
    ],
    include_dirs: [
        "device/vendor/board/include",
    ],
    sanitize: {
        hwaddress: true,  // 量产前开启 HWASan 检测内存错误
    },
}

3.3.2 编译与产物验证

执行以下命令编译 Camera HAL 模块：

cd ~/aosp
source build/envsetup.sh
lunch aosp_arm64-userdebug
# 编译指定模块
make camera.<vendor>.<board> -j$(nproc)
# 或者编译整个 vendor 分区
make vendorimage -j$(nproc)

编译成功后，产物位于 $ANDROID_PRODUCT_OUT/vendor/lib64/hw/camera.<vendor>.<board>.so。使用以下命令验证模块结构：

# 检查 ELF 架构
readelf -h camera.<vendor>.<board>.so | grep Machine
# 输出应为 Machine: AArch64

# 检查 HAL 模块符号
readelf -s camera.<vendor>.<board>.so | grep HAL_MODULE_INFO_SYM
# 必须存在 HAL_MODULE_INFO_SYM_AS_STR 符号，否则 HAL 加载器无法识别

# 检查依赖库
readelf -d camera.<vendor>.<board>.so | grep NEEDED

3.3.3 集成到系统镜像

将 HAL 模块集成到最终系统镜像中有两种方式：

3.3.4 编译集成流程图

3.4 本章小结

Camera HAL 开发环境搭建的核心要点可归纳为：

• 工具链：使用 AOSP 预置的 Clang/LLVM，通过 lunch 自动配置交叉编译环境，避免手动设置 sysroot。
• 源码结构：HAL 接口定义在 hardware/interfaces/camera/，Framework 服务在 frameworks/av/camera/，OEM 实现放在 device/<vendor>/<board>/camera/。
• 编译集成：使用 Android.bp 声明模块，通过 make 编译，产物放入 /vendor/lib64/hw/，并在 device.mk 中注册。
• 验证：使用 readelf 检查架构、符号表、依赖库，确保 HAL_MODULE_INFO_SYM 符号存在。