3. Android源码下载与编译：AOSP源码下载方法、分支选择、lunch命令与编译目标选择、make编译流程

在Camera HAL开发中，掌握AOSP（Android Open Source Project）源码的下载与编译是搭建开发环境的核心技能。本章将系统讲解从源码获取到生成系统镜像的完整流程，重点覆盖分支选择策略、lunch命令的编译目标配置以及make编译系统的执行机制。

3.1 AOSP源码下载方法

AOSP源码体积庞大（通常超过50GB），官方推荐使用repo工具进行多仓库管理。repo是Google基于Git开发的Python脚本，用于同时操作数百个Git仓库。

3.1.1 环境准备与repo工具安装

# 安装Git与Python（Ubuntu 20.04/22.04）
sudo apt-get update
sudo apt-get install git-core python3 python3-pip

# 创建bin目录并加入PATH
mkdir -p ~/bin
export PATH=~/bin:$PATH

# 下载repo工具
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo

3.1.2 初始化与同步

# 创建工作目录
mkdir aosp-source
cd aosp-source

# 初始化指定分支（以android-13.0.0_r41为例）
repo init -u https://android.googlesource.com/platform/manifest \
          -b android-13.0.0_r41 \
          --depth=1

# 同步全部源码（-jN 并行下载，N建议为CPU核心数2倍）
repo sync -j8 -c --no-tags

3.2 分支选择策略

分支选择直接影响Camera HAL的开发基线。AOSP分支命名遵循 android-{API级别}.{大版本}.0_r{补丁号} 格式。下表列出Camera HAL开发常用的分支及其特性：

3.3 lunch命令与编译目标选择

lunch 命令是AOSP编译系统的入口，用于选择目标设备、构建类型和产品配置。其核心语法为：

lunch {product_name}-{build_variant}

3.3.1 编译目标组成

编译目标由两部分组成：

• product_name：设备产品名称，定义在 device/ 或 vendor/ 目录下的 device.mk 中。例如 aosp_arm64、sdk_phone_x86_64、pixel_6。
• build_variant：构建变体，决定系统镜像的调试能力和权限级别。

3.3.2 常用lunch组合

# 设置编译环境（必须在源码根目录执行）
source build/envsetup.sh

# 选择通用ARM64模拟器目标（Camera HAL开发常用）
lunch aosp_arm64-eng

# 选择Pixel 6设备目标（真机调试）
lunch pixel_6-userdebug

# 选择x86_64模拟器目标（快速编译验证）
lunch sdk_phone_x86_64-eng

3.4 make编译流程

AOSP编译系统基于GNU Make和Soong（Blueprint + Ninja）构建。完整的编译流程分为配置、解析、执行三个阶段。

3.4.1 编译命令详解

# 完整编译（生成所有镜像）
make -j$(nproc) 2>&1 | tee build.log

# 增量编译Camera HAL模块（开发调试时使用）
make -j$(nproc) camera.hal

# 编译指定模块并重新打包vendor镜像
make -j$(nproc) vendorimage

# 编译并生成OTA升级包
make -j$(nproc) otapackage

3.4.2 Camera HAL模块编译示例

当修改了Camera HAL源码后，无需重新编译整个系统，只需增量编译HAL模块并更新vendor镜像：

# 1. 编译camera HAL模块
make -j8 camera.hal

# 2. 查看编译产物
ls -l out/target/product/pixel_6/vendor/lib64/hw/camera.*.so

# 3. 重新打包vendor镜像
make -j8 vendorimage

# 4. 刷入设备（需进入fastboot模式）
fastboot flash vendor out/target/product/pixel_6/vendor.img
fastboot reboot

3.5 编译常见问题与排查