1. 搭建AOSP编译环境

任务目标

在 Ubuntu 22.04 上准备一台可用于 AOSP 编译的机器,完成 JDK、必要依赖包、Repo 工具及 Git 身份配置,并验证环境可用性。本案例不涉及具体源码下载与编译,只保证后续案例所需的编译前置条件就绪。

环境要求

  • Ubuntu 22.04 LTS(x86_64),建议 16GB 以上内存,400GB 以上可用磁盘空间
  • Python 3.8~3.11(系统自带 3.10 即可)
  • OpenJDK 11(AOSP master 分支目前要求 JDK 11;若编译 Android 12 及以下版本则需 JDK 8,请按目标版本选择)
  • Git 2.25 以上

安装依赖包

执行以下命令安装 AOSP 编译所需的系统级依赖(基于 Ubuntu 22.04 官方文档整理):

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 python3 python3-pip openjdk-11-jdk

安装 Repo 工具

mkdir -p ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo -o ~/bin/repo
chmod a+x ~/bin/repo
echo 'export PATH=~/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

配置 Git 身份

Repo 和 AOSP 的提交检查需要 Git 用户名与邮箱,请替换为你的实际信息:

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

验证环境

运行以下命令逐项确认环境就绪:

java -version
python3 --version
git --version
repo --version

通过条件:

  • java -version 输出包含 openjdk version "11.x.x"
  • python3 --version 输出 3.8~3.11 之间的版本
  • git --version 输出 2.25 或更高版本
  • repo --version 正常输出版本号且无报错

以上四项全部通过,即代表 AOSP 编译环境搭建完成,可进入后续源码下载与编译案例。

常见问题

  • repo 下载失败:若无法访问 Google 存储地址,可使用国内镜像源 https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/repo 替换下载链接。
  • 磁盘空间不足:AOSP 源码下载后约 30GB,完整编译产物另需 200GB 以上,请确保目标分区有足够空间。
  • JDK 版本不匹配:编译 Android 13 以下版本需 JDK 8,请改用 openjdk-8-jdk 安装包。