4、环境搭建与依赖安装：Ubuntu系统配置、JDK版本、Python依赖、磁盘与内存要求

AOSP（Android Open Source Project）的构建系统是一个庞大而复杂的工程体系，其编译过程涉及源码解析、资源编译、字节码转换、镜像打包等多个阶段。在开始下载数十GB的源码之前，构建环境的稳定性直接决定了后续开发效率。一个配置不当的环境，轻则导致编译中断，重则产生难以排查的隐性错误（如链接失败、资源缺失）。本章将聚焦于Ubuntu系统的基础配置、JDK与Python依赖的精确版本匹配，以及磁盘与内存的硬性指标，帮助读者搭建一个可复现、可维护的AOSP编译环境。

4.1 Ubuntu系统配置：版本选择与基础优化

核心原理

AOSP官方文档明确推荐使用Ubuntu LTS（长期支持）版本作为构建环境。这并非偶然，而是基于以下技术考量：LTS版本拥有长达5年的安全更新周期，且其默认的glibc、GCC、Make等系统库版本与AOSP构建脚本的兼容性经过Google CI（持续集成）系统的充分验证。以Android 12及更高版本为例，其构建系统已全面迁移至Soong（基于Go语言），对Python 3和OpenJDK 11有硬性依赖，而Ubuntu 20.04 LTS（Focal Fossa）恰好原生提供这些组件。

文件系统是另一个常被忽视的关键点。AOSP源码包含大量文件名大小写敏感的文件（例如foo.h与Foo.h可能同时存在），因此构建分区必须使用大小写敏感的文件系统。默认的ext4完全满足要求，但若使用ZFS或Btrfs，则需要额外配置casesensitivity=true属性，否则在同步源码或编译过程中会频繁出现"文件未找到"的诡异错误。

操作流程：Ubuntu基础配置清单

1. 系统安装：选择Ubuntu 20.04.6 LTS或22.04.3 LTS的64位桌面版或服务器版。服务器版无图形界面，更节省内存，适合纯编译服务器。
2. 更新软件源：编辑/etc/apt/sources.list，将源指向国内镜像（如阿里云、清华TUNA），以加速后续依赖下载。
3. 安装基础工具：执行以下命令安装编译AOSP所需的系统级依赖：

sudo apt update
sudo apt install -y git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig

4. 配置Git身份：AOSP的repo工具依赖Git进行版本管理，必须配置用户名和邮箱：

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

5. 设置文件描述符限制：编译过程中会打开大量文件，需提高系统限制。编辑/etc/security/limits.conf，添加：

username soft nofile 4096
username hard nofile 16384

案例拆解：文件系统不兼容导致编译失败

背景：某开发者在Ubuntu 22.04上使用默认的ZFS文件系统（手动安装时选择）存放AOSP源码，在编译到第15分钟时，构建系统报错ninja: error: 'out/target/product/generic/obj/STATIC_LIBRARIES/libbase_intermediates/export_includes', needed by 'out/target/product/generic/obj/EXECUTABLES/vold_intermediates/import_includes', missing and no known rule to make it。

分析：该错误并非代码逻辑问题，而是ZFS默认的casesensitivity=mixed属性导致export_includes与Export_Includes被视为同一文件，造成构建系统依赖关系混乱。

解决：将源码迁移至ext4分区（重新格式化或使用新挂载点），并重新执行make clean后编译，问题彻底消失。

复盘：在搭建环境前，务必确认df -T /path/to/aosp输出的文件系统类型。若为ZFS/Btrfs，需在创建文件系统时显式指定-o casesensitivity=sensitive。

4.2 JDK版本选择：Android版本与JDK的对应关系

核心原理

JDK（Java Development Kit）是AOSP构建链中不可或缺的一环，主要用于编译Java/Kotlin源码、生成R.java文件以及运行某些构建工具（如Jack（已废弃）、Javac）。不同Android版本对JDK版本有严格的要求，使用错误的JDK版本会导致编译错误或运行时异常。例如，Android 8.0及更早版本要求OpenJDK 8，而Android 9.0至Android 11可以使用OpenJDK 11，Android 12及以后版本则强制要求OpenJDK 11。

值得注意的是，AOSP构建系统通过环境变量JAVA_HOME和PATH来定位JDK。如果系统中安装了多个JDK版本，必须确保JAVA_HOME指向正确的路径，否则即使java -version显示正确，构建脚本仍可能调用错误的编译器。

判断方法：确定所需JDK版本

操作流程：安装与切换JDK

# 安装OpenJDK 11（以Android 12为例）
sudo apt install -y openjdk-11-jdk

# 设置JAVA_HOME（建议写入~/.bashrc）
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

# 验证版本
java -version
# 输出应包含 "openjdk version "11.0.xx""

若需在多个JDK间切换，可使用update-alternatives命令：

sudo update-alternatives --config java
sudo update-alternatives --config javac

常见误区与复盘

• 误区一：认为JDK版本越高越好。实际上，使用JDK 17编译Android 12会抛出Unsupported class file major version 61错误，因为构建工具链尚未适配。
• 误区二：只修改JAVA_HOME而不更新PATH。构建脚本会优先从PATH中查找java命令，若PATH仍指向旧版本，则JAVA_HOME设置无效。
• 复盘：在编译前，建议在源码根目录执行source build/envsetup.sh，该脚本会自动检测并提示JDK版本是否匹配。

4.3 Python依赖：版本要求与pip包管理

核心原理

AOSP构建系统大量使用Python脚本进行配置解析、代码生成和构建控制。从Android 10开始，构建系统已完全迁移至Python 3，Python 2已被彻底弃用。具体而言，build/make/core/main.mk会检查Python版本，若低于3.6则直接报错。此外，repo工具（用于管理多个Git仓库）本身也是用Python编写的，需要Python 3.6+。

除了Python解释器本身，某些构建步骤还依赖第三方Python库，如protobuf、lxml、requests等。这些库通常通过pip安装，但AOSP官方推荐使用系统包管理器（apt）安装，以避免与系统Python环境冲突。

操作流程：Python环境配置

# 检查Python版本（需≥3.6）
python3 --version

# 安装pip和必要依赖
sudo apt install -y python3-pip python3-venv

# 安装AOSP构建所需的Python包
sudo pip3 install --upgrade protobuf lxml requests

# 验证repo工具（若未安装）
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
export PATH=~/bin:$PATH

案例拆解：Python版本不匹配导致repo同步失败

背景：某开发者在Ubuntu 18.04（默认Python 3.6.9）上尝试同步Android 13源码，执行repo init时提示SyntaxError: invalid syntax。

分析：Android 13的repo工具已要求Python 3.8+，而Ubuntu 18.04的默认Python版本过低。

解决：通过sudo apt install python3.8安装新版本，并使用update-alternatives将python3指向3.8版本。重新执行repo init后成功。

复盘：在搭建环境前，务必查阅目标Android版本的build/soong/soong_ui.bash脚本，确认其声明的Python最低版本要求。

4.4 磁盘与内存要求：容量规划与性能调优

核心原理

AOSP源码及其构建产物对存储和内存的需求极为惊人。以Android 14为例，完整源码（含Git历史）约需120GB，而编译产物（out目录）在未清理的情况下可膨胀至200GB以上。因此，总磁盘占用建议预留400GB以上。更关键的是，编译过程是I/O密集型任务，机械硬盘（HDD）的随机读写性能会成为严重瓶颈，导致编译时间成倍增加。因此，强烈建议使用NVMe SSD，并确保分区对齐（4K对齐）。

内存方面，编译过程中会启动多个并行任务（默认与CPU核心数相同），每个任务需要约1.5GB内存。若使用16GB内存的机器，在make -j8时可能因内存不足而触发OOM（Out Of Memory）Killer，导致编译进程被强制终止。推荐配置为32GB内存，并设置8GB的Swap分区作为应急缓冲。

判断方法：评估磁盘与内存需求

操作流程：磁盘与内存优化策略

1. 磁盘分区：使用LVM（逻辑卷管理）以便后续扩容。挂载选项建议添加noatime以减少写操作。
2. 调整编译并行度：在make命令中显式指定-j参数，公式为CPU核心数 × 1.5。例如8核CPU使用-j12。
3. 使用ccache：安装并配置ccache以缓存C/C++编译结果，可减少30%-50%的重复编译时间。

sudo apt install ccache
export USE_CCACHE=1
export CCACHE_DIR=/path/to/ccache
ccache -M 50G  # 设置缓存上限为50GB

4. 监控内存：编译时使用htop实时监控内存占用，若发现Swap使用率持续超过50%，应减少-j参数。

常见误区与总结

• 误区一：认为磁盘空间足够即可，忽略inode数量。AOSP源码包含数百万个文件，若分区inode耗尽，即使空间充足也无法创建新文件。建议使用df -i检查inode使用率。
• 误区二：将out目录放在tmpfs（内存文件系统）中以加速编译。虽然tmpfs读写极快，但会占用大量内存，且重启后数据丢失，仅适合临时测试。
• 总结：环境搭建的核心原则是"版本精确匹配、资源冗余预留"。建议在编译前运行build/envsetup.sh自带的checkenv命令，它会自动检测所有依赖项是否满足要求。