1. Ubuntu 18.04虚拟机环境下编译Android源码全指南在虚拟机环境中编译Android源码是许多开发者必经的成人礼。我曾在不同配置的机器上完成过数十次完整编译从最初耗时两天一夜的煎熬到现在三小时搞定积累了不少实战经验。本文将基于Ubuntu 18.04 LTS环境带你避开我踩过的所有坑。为什么选择Ubuntu 18.04这是Google官方推荐的Android开发环境之一其长期支持特性LTS保证了系统稳定性且社区资源丰富。虚拟机方案则能实现环境隔离避免污染主机系统特别适合需要同时处理多个项目的开发者。2. 环境准备与系统配置2.1 虚拟机创建要点推荐使用VMware Workstation Pro 16或VirtualBox 6.1。关键参数设置磁盘空间至少250GBAndroid 11源码约需150GB内存16GB起步8GB也能编译但极慢CPU核心分配宿主机50%物理核心如8核主机给4核重要提示务必选择将虚拟磁盘存储为单个文件选项否则性能损失可达30%安装Ubuntu时需注意# 分区方案建议 / : 50GB ext4 swap : 内存1.5倍 /home : 剩余空间 ext42.2 基础依赖安装先更新软件源sudo apt-get update sudo apt-get upgrade -y安装编译必备工具链sudo apt-get install -y git-core gnupg flex bison build-essential zip curl zlib1g-dev \ libc6-dev-i386 libncurses5 lib32ncurses5-dev x11proto-core-dev libx11-dev \ lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig python2踩坑记录Ubuntu 18.04默认python3需手动配置python2sudo update-alternatives --install /usr/bin/python python /usr/bin/python2 1 sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 2 sudo update-alternatives --config python # 选择python23. 源码获取与环境配置3.1 仓库工具配置安装repo工具mkdir ~/bin curl https://storage.googleapis.com/git-repo-downloads/repo ~/bin/repo chmod ax ~/bin/repo配置环境变量添加到~/.bashrcexport PATH~/bin:$PATH export USE_CCACHE1 export CCACHE_DIR/home/$USER/.ccache ccache -M 50G # 设置缓存大小3.2 源码下载技巧初始化仓库以Android 11为例mkdir ~/aosp cd ~/aosp repo init -u https://android.googlesource.com/platform/manifest -b android-11.0.0_r48使用清华镜像加速repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/platform/manifest -b android-11.0.0_r48同步源码建议夜间执行repo sync -j4 --no-tags --no-clone-bundle实测数据100M宽带下完整同步约需6-8小时遇到中断可重复执行sync命令4. 编译过程详解4.1 环境初始化加载编译环境source build/envsetup.sh选择编译目标lunch # 交互式选择 或 lunch aosp_x86_64-eng # 直接指定4.2 核心编译命令启动编译使用ccache加速make -j$(nproc) 21 | tee build.log关键参数说明-jN并行编译任务数通常设为CPU核心数×1.521 | tee同时输出到屏幕和日志文件性能优化在虚拟机设置中启用虚拟化CPU性能计数器可提升15%编译速度4.3 编译进度监控查看剩余任务watch -n 10 cat out/build_status.txt估算剩余时间tail -f build.log | grep -E \[.*%\]典型编译时间参考i7-10700/16GB首次编译3.5-5小时增量编译10-30分钟5. 常见问题解决方案5.1 内存不足处理当出现GC overhead limit exceeded错误时export JACK_SERVER_VM_ARGUMENTS-Dfile.encodingUTF-8 -XX:TieredCompilation -Xmx4g ./prebuilts/sdk/tools/jack-admin kill-server ./prebuilts/sdk/tools/jack-admin start-server5.2 文件系统错误修复遇到ext4文件系统只读错误sudo umount /dev/sda1 sudo fsck -y /dev/sda1 sudo mount -o remount,rw /5.3 Java版本冲突Android源码需要特定Java版本sudo update-alternatives --config javac sudo update-alternatives --config java验证版本java -version # 需显示1.8.x javac -version6. 编译后操作6.1 镜像文件生成查看产出物ls -lh out/target/product/generic_x86_64/*.img关键镜像文件system.img系统镜像ramdisk.img启动镜像userdata.img用户数据分区6.2 模拟器运行启动编译好的镜像emulator -show-kernel -no-snapshot -no-audio -no-window性能提示关闭GUI可节省30%内存添加-no-window -gpu off参数6.3 刷机实测将镜像刷入真机以Pixel 3为例fastboot flashall -w注意先解锁bootloaderfastboot flashing unlock7. 高级技巧与优化7.1 增量编译加速只编译修改部分mmm path/to/module # 编译单个模块 mma # 编译当前目录模块7.2 CCache配置优化查看缓存统计ccache -s重置缓存ccache -C7.3 多版本管理技巧创建版本快照repo forall -c git tag -a my_build_$(date %Y%m%d) -m Tagged for build切换版本repo sync -l # 仅更新索引 repo forall -c git checkout my_build_202306018. 虚拟机专属优化方案8.1 磁盘性能提升将虚拟磁盘转为独立持久模式sudo vmware-toolbox-cmd disk shrink /8.2 网络加速配置使用NAT模式并开启端口转发# 在宿主机执行Windows示例 netsh interface portproxy add v4tov4 listenport9418 listenaddress0.0.0.0 connectport9418 connectaddress虚拟机IP8.3 共享文件夹优化避免直接编译共享文件夹中的代码sudo mount -t vboxsf -o rw,uid1000,gid1000 aosp /mnt/aosp建议工作流程在共享文件夹存放源码压缩包解压到虚拟机本地目录编译完成后将产出物复制回共享文件夹经过这些优化我的虚拟机编译速度已能达到物理机80%的性能。最后提醒编译过程中建议关闭杀毒软件实时监控这能减少约20%的I/O等待时间。
