Android Camera HAL从零到项目落地 - 第2节

2.1 开发环境全景概览

在开始 Camera HAL 开发之前，必须搭建一套完整、可复现的 AOSP 开发环境。本章将引导你从零配置 Ubuntu 系统、下载 Android 源码、编译系统镜像，并掌握 adb 与 fastboot 这两个核心调试工具。整个环境是后续所有 Camera HAL 实验、调试与集成的基础。

2.2 Ubuntu 系统配置

2.2.1 基础依赖安装

AOSP 编译需要大量系统工具和库。以下命令安装核心依赖：

sudo apt update
sudo apt install -y 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.2.2 配置 Git 与 Repo 工具

Repo 是 Google 提供的多仓库管理工具，用于同步 AOSP 数千个 Git 仓库。

# 配置 Git 用户信息
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# 安装 Repo
mkdir -p ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH
# 将上述 export 添加到 ~/.bashrc 以永久生效

2.2.3 安装 JDK

AOSP 13 及更高版本需要 OpenJDK 11 或更高版本。

sudo apt install -y openjdk-11-jdk
java -version  # 验证安装

2.3 Android 源码下载

2.3.1 选择分支与初始化

以 Android 13 (T) 为例，选择稳定分支 android-13.0.0_r41。

mkdir ~/aosp
cd ~/aosp
repo init -u https://android.googlesource.com/platform/manifest \
  -b android-13.0.0_r41
repo sync -c -j$(nproc)  # 同步所有仓库，-c 只下载当前分支

2.3.2 源码目录结构

了解关键目录对 Camera HAL 开发至关重要：

2.4 AOSP 编译环境搭建

2.4.1 初始化编译环境

每次编译前需要加载 AOSP 的环境变量和函数：

cd ~/aosp
source build/envsetup.sh
lunch  # 选择目标设备，例如 aosp_arm64-eng

lunch 命令会列出所有可用的编译目标。对于 Camera HAL 开发，常用目标：

2.4.2 执行编译

使用 make 命令启动编译。推荐使用 -j 参数指定并行任务数，通常为 CPU 核心数的 1.5~2 倍。

# 编译整个系统（首次约 2-4 小时）
make -j$(nproc)

# 仅编译指定模块（Camera HAL 开发常用）
make -j$(nproc) camera.hal
make -j$(nproc) cameraserver
make -j$(nproc) libcameraservice

2.4.3 编译产物与输出目录

编译完成后，所有输出文件位于 out/target/product/<device>/ 目录下：

2.5 adb 与 fastboot 工具使用

2.5.1 工具安装与验证

adb 和 fastboot 是 Android 开发的核心调试工具。AOSP 编译后会生成最新版本，也可单独安装：

# 从 AOSP 编译产物中获取
cd ~/aosp
source build/envsetup.sh
lunch aosp_arm64-eng
make adb fastboot

# 或通过系统包管理器安装
sudo apt install -y adb fastboot

# 验证版本
adb version
fastboot --version

2.5.2 adb 常用命令速查

2.5.3 fastboot 常用命令速查

2.5.4 Camera HAL 调试典型工作流

以下是一个典型的 Camera HAL 修改→部署→验证流程：

1. 修改 HAL 代码：在 device/ 或 vendor/ 目录下编辑 Camera HAL 实现。
2. 编译模块：make -j$(nproc) camera.hal
3. 推送库到设备：adb push out/target/product/<device>/vendor/lib64/hw/camera.xxx.so /vendor/lib64/hw/
4. 重启 CameraService：adb shell pkill cameraserver 或直接重启设备。
5. 验证日志：adb logcat -s CameraService 查看 HAL 初始化与调用日志。

2.6 常见问题与避坑指南