保姆级教程：在Ubuntu 24.04上搞定AOSP源码下载与编译（附国内镜像加速）

零基础玩转AOSPUbuntu 24.04环境下的源码编译实战指南1. 环境准备与系统配置在开始AOSP源码编译之前确保你的Ubuntu 24.04系统满足以下硬件要求存储空间至少250GB可用空间源码下载约80GB编译后占用更多内存16GB以上推荐32GB以获得更好体验CPU6核以上处理器编译过程非常消耗CPU资源对于国内开发者建议使用清华大学的Ubuntu镜像源进行系统更新sudo sed -i s|http://.*archive.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g /etc/apt/sources.list sudo apt update sudo apt upgrade -y安装基础依赖工具链sudo apt install -y git-core gnupg flex bison build-essential \ zip curl zlib1g-dev gcc-multilib g-multilib libc6-dev-i386 \ libncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev \ libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig提示如果使用虚拟机环境建议分配至少8核CPU和32GB内存并启用KVM加速以获得更好的编译性能。2. 开发工具链配置2.1 Java环境安装AOSP不同版本需要特定Java开发工具包AOSP版本JDK版本安装命令Android 7-8OpenJDK 8sudo apt install openjdk-8-jdkAndroid 9OpenJDK 11sudo apt install openjdk-11-jdk设置默认JDK版本sudo update-alternatives --config java sudo update-alternatives --config javac2.2 Git配置正确配置Git信息对代码提交至关重要git config --global user.name YourName git config --global user.email your.emailexample.com git config --global color.ui auto2.3 Repo工具安装Repo是管理多个Git仓库的工具国内建议使用清华镜像mkdir ~/bin curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo -o ~/bin/repo chmod ax ~/bin/repo将以下内容添加到~/.bashrc文件末尾export PATH~/bin:$PATH export REPO_URLhttps://mirrors.tuna.tsinghua.edu.cn/git/git-repo使配置立即生效source ~/.bashrc3. 源码下载与同步3.1 初始化仓库创建工作目录并初始化仓库mkdir ~/aosp cd ~/aosp repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-14.0.0_r2常用分支版本对照表Android版本分支名称API级别Android 14android-14.0.0_r234Android 13android-13.0.0_r333Android 12android-12.1.0_r5323.2 同步源码使用以下命令开始同步源码repo sync -j8 --current-branch --no-tags遇到网络中断时可以恢复同步repo sync -j8 --fail-fast注意同步过程可能需要数小时建议在稳定的网络环境下进行可以使用screen或tmux保持会话。4. 编译环境准备4.1 环境变量设置加载编译环境脚本source build/envsetup.sh4.2 选择编译目标查看可用设备列表lunch常见编译目标说明aosp_arm-engARM架构模拟器带调试功能aosp_x86_64-engx86_64架构模拟器带调试功能aosp_car_x86_64-userdebug车载系统x86_64架构用户调试版本选择目标lunch aosp_x86_64-eng5. 开始编译系统5.1 全系统编译使用make命令开始编译make -j$(nproc)编译过程监控技巧查看CPU使用率htop监控磁盘空间df -h查看编译进度tail -f out/verbose.log.gz5.2 常见编译问题解决内存不足添加交换分区sudo fallocate -l 8G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfileJava版本冲突确保使用正确的JDK版本依赖缺失根据错误提示安装缺失的软件包6. 运行编译结果6.1 启动模拟器编译完成后直接启动emulator自定义启动参数emulator -no-snapshot -no-audio -no-window -gpu off -memory 40966.2 刷入实体设备将系统镜像刷入支持解锁的Pixel设备fastboot flashall -w7. 模块化开发技巧7.1 单独编译模块常用模块编译命令命令功能描述mm编译当前目录模块mma编译当前目录及依赖模块mmma dir编译指定目录下的模块m libart编译特定模块如libart7.2 常见模块编译示例编译Framework资源make framework-res编译SystemUImake SystemUI编译Settings应用make Settings8. 开发调试技巧8.1 ADB调试常用ADB命令adb logcat -v threadtime # 查看详细日志 adb shell dumpsys package package # 查看包信息 adb shell am start -n activity # 启动Activity8.2 系统属性修改临时修改属性adb shell setprop key value永久修改需要修改build.prop并重新编译系统。8.3 性能分析工具systrace系统级性能分析python systrace.py -o mytrace.html sched freq idle am wm gfx viewperfetto新一代性能分析工具adb shell perfetto --txt -c /data/misc/perfetto-configs/battery_config.pbtxt -o /data/misc/perfetto-traces/battery_trace9. 进阶开发指南9.1 自定义系统组件添加新系统服务步骤创建服务Java接口frameworks/base/core/java/android/app/IMyService.aidl实现服务frameworks/base/services/core/java/com/android/server/MyService.java注册服务修改SystemServer.java添加权限frameworks/base/core/res/AndroidManifest.xml9.2 内核开发下载对应内核源码git clone https://aosp.tuna.tsinghua.edu.cn/kernel/common.git编译内核make -C kernel/msm-3.18 Oout ARCHarm64 CROSS_COMPILEaarch64-linux-android- menuconfig make -C kernel/msm-3.18 Oout ARCHarm64 CROSS_COMPILEaarch64-linux-android-9.3 SELinux策略修改调试SELinux策略adb shell dmesg | grep avc # 查看SELinux拒绝日志 adb shell su root cat /sys/fs/selinux/policy sepolicy # 导出策略添加新策略audit2allow -i avc_log.txt mypolicy.te10. 持续集成与自动化10.1 增量编译优化启用ccache加速后续编译export USE_CCACHE1 export CCACHE_DIR/path/to/ccache prebuilts/misc/linux-x86/ccache/ccache -M 50G10.2 自动化构建脚本示例构建脚本#!/bin/bash # 初始化环境 source build/envsetup.sh # 选择目标 lunch aosp_x86_64-eng # 清理旧构建 make clobber # 开始构建 START_TIME$SECONDS make -j$(nproc) 21 | tee build.log ELAPSED_TIME$(($SECONDS - $START_TIME)) echo 构建完成耗时: $(($ELAPSED_TIME/60))分$(($ELAPSED_TIME%60))秒10.3 容器化构建环境使用Docker创建可移植的构建环境FROM ubuntu:24.04 RUN apt update apt install -y git-core gnupg flex bison build-essential \ zip curl zlib1g-dev gcc-multilib g-multilib libc6-dev-i386 \ libncurses5-dev x11proto-core-dev libx11-dev lib32z1-dev \ libgl1-mesa-dev libxml2-utils xsltproc unzip python3 RUN useradd -m builder USER builder WORKDIR /home/builder