1. Android源码开发环境搭建概述
在Ubuntu系统上搭建Android源码开发环境是每个Android底层开发者的必经之路。不同于普通的应用开发,源码级开发需要处理更复杂的工具链依赖和环境配置。我经历过无数次环境搭建的折磨,从最初的茫然无措到现在能够30分钟内完成全套配置,这里把我的经验完整分享出来。
Android源码编译对系统环境有严格要求:64位Ubuntu 16.04/18.04/20.04是官方推荐系统,需要至少16GB内存(实测8GB也能编译但极慢)和250GB以上磁盘空间。不同于Windows下的Android Studio开发,源码编译需要完整的工具链支持,包括特定版本的Java、Python、GCC/G++等。
2. 基础系统准备
2.1 Ubuntu系统安装建议
推荐使用Ubuntu 18.04 LTS作为基础系统,这是经过验证最稳定的版本。安装时注意:
- 选择英文系统语言(避免中文路径问题)
- 采用ext4文件系统
- 分配至少100GB给根分区(源码+编译产物会占用约80GB)
重要提示:不要使用WSL或虚拟机!我曾尝试在WSL2中编译,遇到无数文件系统权限和性能问题。实体机安装是唯一可靠方案。
2.2 基础依赖安装
首先更新软件源并安装基础工具:
sudo apt update && sudo apt upgrade -y sudo apt install -y git-core gnupg flex bison gperf build-essential \ zip curl zlib1g-dev gcc-multilib g++-multilib libc6-dev-i386 \ lib32ncurses5-dev x11proto-core-dev libx11-dev lib32z-dev \ libgl1-mesa-dev libxml2-utils xsltproc unzip这里有几个关键点需要注意:
gcc-multilib和g++-multilib是交叉编译必备lib32z-dev等32位库是兼容旧版二进制文件必需的- 如果缺少这些依赖,后续编译会报各种头文件缺失错误
3. 工具链配置
3.1 Java环境配置
Android源码编译需要特定版本的Java:
- Android 7.0-8.1:OpenJDK 8
- Android 9-10:OpenJDK 9/10
- Android 11+:OpenJDK 11
以最常用的OpenJDK 8为例:
sudo apt install -y openjdk-8-jdk验证Java版本:
java -version # 应显示1.8.x update-alternatives --config java # 确保选中Java 83.2 Python环境配置
虽然Ubuntu自带Python3,但需要额外安装2.7版本:
sudo apt install -y python2.7 sudo update-alternatives --install /usr/bin/python python /usr/bin/python2.7 1 sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.6 2切换Python版本:
sudo update-alternatives --config python # 选择Python 2.73.3 GCC/G++版本管理
Android源码对GCC版本有严格要求:
- Android 7.x-9.x:GCC 4.9
- Android 10+:GCC 9.x
安装多版本GCC并切换:
sudo apt install -y gcc-4.9 g++-4.9 gcc-9 g++-9 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.9 49 \ --slave /usr/bin/g++ g++ /usr/bin/g++-4.9 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 90 \ --slave /usr/bin/g++ g++ /usr/bin/g++-9切换GCC版本:
sudo update-alternatives --config gcc # 根据Android版本选择4. 源码下载与编译
4.1 Repo工具安装
Repo是Google开发的Git仓库管理工具:
mkdir ~/bin curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo chmod a+x ~/bin/repo将repo加入PATH:
echo 'export PATH=~/bin:$PATH' >> ~/.bashrc source ~/.bashrc4.2 源码下载
初始化仓库(以Android 11为例):
mkdir ~/aosp && cd ~/aosp repo init -u https://android.googlesource.com/platform/manifest -b android-11.0.0_r48开始同步源码(耗时数小时):
repo sync -j4 # -j后跟并发数,建议不超过CPU核心数网络问题解决方案:如果遇到同步失败,可以尝试修改repo文件中的REPO_URL为国内镜像源,如清华源
https://mirrors.tuna.tsinghua.edu.cn/git/git-repo
4.3 编译配置
初始化编译环境:
source build/envsetup.sh lunch # 选择目标设备型号常见选项:
- aosp_arm-eng:ARM模拟器
- aosp_x86_64-eng:x86_64模拟器
- 具体设备代号(如Pixel 3的blueline-userdebug)
开始编译:
make -j16 # -j后跟并行任务数,建议为CPU核心数的1.5-2倍5. 常见问题解决
5.1 Java版本问题
错误现象:
You are attempting to build with the incorrect version of java.解决方案:
sudo update-alternatives --config java sudo update-alternatives --config javac5.2 Python版本问题
错误现象:
SyntaxError: invalid syntax (print语句不带括号)解决方案:
sudo update-alternatives --config python # 切换至Python 2.75.3 内存不足问题
错误现象:
Out of memory error (OOM)解决方案:
- 增加swap空间(至少16GB):
sudo fallocate -l 16G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile- 减少并行编译任务数:
make -j4
5.4 文件系统大小写问题
错误现象:
Case-insensitive filesystem detected解决方案:
- 创建区分大小写的磁盘映像:
mkdir ~/android truncate -s 200G ~/android/android.img mkfs.ext4 -L android ~/android/android.img sudo mount -o loop ~/android/android.img /mnt/android6. 开发环境优化
6.1 CCache加速编译
配置ccache缓存(可提速30%以上):
export USE_CCACHE=1 export CCACHE_DIR=~/.ccache prebuilts/misc/linux-x86/ccache/ccache -M 50G # 设置缓存大小6.2 增量编译技巧
- 只编译特定模块:
make framework -j16 # 只编译framework- 快速重启编译:
make installclean # 保留配置 make -j166.3 IDE集成
虽然源码开发主要在命令行,但可以导入Android Studio:
make idegen && development/tools/idegen/idegen.sh生成的android.ipr文件可直接用Android Studio打开。
7. 高级调试技巧
7.1 单步调试Framework
配置gdb调试:
gdbserver :5039 /system/bin/app_process & adb forward tcp:5039 tcp:5039 gdbclient.py -p <pid>7.2 自定义ROM制作
修改build/target/product/core.mk可以添加/删除系统应用:
PRODUCT_PACKAGES += \ MyCustomApp \ -Email # 移除默认邮件应用7.3 内核编译
单独编译内核:
cd kernel/msm make ARCH=arm64 CROSS_COMPILE=aarch64-linux-android- your_defconfig make ARCH=arm64 CROSS_COMPILE=aarch64-linux-android-8. 环境维护建议
- 定期清理:
make clean # 保留配置 make clobber # 完全清理- 备份关键配置:
- ~/.bashrc中的环境变量
- repo仓库的local_manifest.xml
- 修改过的核心代码文件
- 使用tmux或screen保持会话:
tmux new -s android-build # 编译过程中可以detach (Ctrl+b d)并断开SSH这套环境我已经在数十台不同配置的机器上验证过,遇到的最棘手问题通常是网络连接导致的repo同步失败。建议在夜间进行首次源码同步,并使用repo sync -j4 -f强制继续中断的同步。