1. 项目概述与背景折腾Android源码编译大概是每个对系统底层感兴趣或者有特定定制需求的开发者都会经历的一道坎。我之前在Nexus 5x上成功编译并修改了AOSP 7.1.1实现了位置打卡的功能整个过程虽然繁琐但成就感十足。这次我把目标转向了手头的Pixel 3想在这台设备上复现并进一步探索Android 10.0AOSP 10.0 r41的编译与刷机流程。选择Pixel 3代号blueline的原因很简单它是Google的亲儿子官方驱动支持完善社区资料也多对于学习和实验来说是绝佳的“小白鼠”。然而从Nexus 5x到Pixel 3从Android 7.1到Android 10看似只是设备和版本的升级但实际操作中遇到的坑却截然不同。最大的挑战往往不是编译命令本身而是前期的环境搭建、代码与驱动的匹配以及刷机过程中的各种“玄学”问题。很多人包括我自己都曾卡在下载代码这一步网络问题直接劝退。所以这次我决定采用一种更“接地气”的方式直接使用现成的、匹配好的代码分支和驱动包绕过repo同步这个最大的拦路虎把精力集中在编译和刷机这两个核心环节上。这篇文章就是我在Ubuntu 18.04系统上完整走通Pixel 3编译刷入AOSP 10.0 r41的实战记录我会把每个步骤的细节、遇到的错误以及解决方案都掰开揉碎了讲清楚希望能帮你少走弯路。2. 编译环境与源码准备2.1 虚拟机与宿主系统配置编译AOSP对硬件资源的要求不低强烈建议在物理机上直接安装Ubuntu进行这样性能最好。但如果条件有限或者像我一样需要在多系统间切换使用虚拟机也是一个可行的选择只是需要做好配置。我的宿主机是Windows 10虚拟机软件使用的是VMware Workstation 16 Pro。这里有几个关键点必须注意直接关系到编译能否成功以及效率。首先是硬盘空间AOSP源码本身巨大编译产生的中间文件和输出文件更是占用海量空间。我最初只分配了150GB结果编译到一半就空间不足前功尽弃。血的教训是分配给虚拟机的硬盘空间绝对不能少于250GB我最终调整到了300GB编译完成后剩余空间大约在30-40GB左右这才算比较稳妥。如果你打算长期折腾多个版本预留500GB都不为过。其次是内存和CPU核心数。AOSP编译是一个极度消耗内存和CPU的过程。官方推荐至少16GB内存。在虚拟机上我分配了20GB内存给Ubuntu并将宿主机的8个CPU核心全部分配给它如果你的宿主机核心数多可以分配更多但要注意给宿主机留一些。这里有个小技巧在VMware的虚拟机设置中除了分配内存和处理器务必在“处理器”选项里勾选“虚拟化Intel VT-x/EPT或AMD-V/RVI”这个选项对于在虚拟机内高效运行编译任务至关重要不开启可能会导致编译速度异常缓慢甚至失败。操作系统我选择了Ubuntu 18.04 LTS64位。选择LTS版本是因为其长期支持软件源稳定社区遇到的大多数问题在这个版本上都有现成的解决方案避免因系统版本太新或太旧带来的兼容性麻烦。2.2 关键软件包的安装系统安装好后第一件事就是换源。默认的国外源下载速度慢如蜗牛必须替换为国内的镜像源如阿里云、清华、中科大的源。具体操作是备份并编辑/etc/apt/sources.list文件。这一步是基础能为你后续节省大量等待时间。接下来是安装编译所需的依赖包。AOSP官方文档会给出一个列表但那个列表有时不够完整。下面是我结合官方文档和多次实战经验整理出来的完整安装命令在Ubuntu 18.04上亲测有效。请注意这些命令需要分条执行因为有些包在同一个apt-get install命令中可能会因为依赖关系问题而安装失败。首先安装一些基础工具和库sudo apt-get update sudo apt-get 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 libgl1-mesa-dev libxml2-utils xsltproc unzip然后安装更多必要的开发库包括一些32位兼容库因为Android编译需要32位工具链sudo apt-get install -y lib32z1-dev lib32readline-dev libssl-dev liblz4-tool libesd-java libwxgtk3.0-dev squashfs-tools pngcrush schedtool sudo apt-get install -y python-markdown libswitch-perl libssl-dev bc sudo apt-get install -y tofrodos dos2unix这里有个容易忽略的点openjdk-8-jdk。Android 10.0 (AOSP 10) 的编译必须使用Java 8更高版本的Java会导致编译错误。安装命令如下sudo apt-get install -y openjdk-8-jdk安装完成后务必通过java -version和javac -version命令确认默认的Java版本是1.8。如果不是需要使用update-alternatives命令来切换系统的默认Java版本。最后安装一个有用的工具ccache。它不是必须的但能显著加速后续的重复编译过程。它通过缓存之前的编译结果来工作。sudo apt-get install -y ccache source ~/.bashrc echo ‘export USE_CCACHE1‘ ~/.bashrc echo ‘export CCACHE_DIR/home/你的用户名/.ccache‘ ~/.bashrc # 可以指定一个大的磁盘分区 prebuilts/misc/linux-x86/ccache/ccache -M 50G # 设置缓存大小为50GB这个值可以根据你的硬盘空间调整2.3 源码与驱动获取的“捷径”传统方法是使用repo工具同步整个AOSP代码仓库这对于网络环境是个巨大考验。我采用的是一种更直接的方法寻找并下载特定分支的源码快照tarball以及与之完全匹配的专有驱动Proprietary Binary Drivers。确定分支与驱动版本这是最关键的一步版本不匹配会导致编译失败或刷机后无法启动。我的目标分支是android-10.0.0_r41。通过查询Google的驱动发布页面我找到了对应Pixel 3 (blueline) 的驱动版本号QQ3A.200805.001。你必须确保源码分支和驱动版本号完全一致。获取源码我通过其他渠道如国内镜像站或已下载的备份获得了android-10.0.0_r41分支的完整源码压缩包。将其解压到你的工作目录例如~/aosp。解压命令tar -xvf aosp_android-10.0.0_r41.tar.gz -C ~/解压后目录结构应包含build/,frameworks/,packages/等标准AOSP目录。下载专有驱动前往Google的官方驱动下载站点通常需要科学上网这里我们假设你已经通过合规方式获取搜索blueline和QQ3A.200805.001。你会找到两个文件例如google_devices-blueline-qq3a.200805.001-xxxxxxx.tgzqcom-blueline-qq3a.200805.001-xxxxxxx.tgz将它们下载到你的源码根目录即~/aosp下。解压与安装驱动cd ~/aosp tar -zxvf google_devices-blueline-qq3a.200805.001-xxxxxxx.tgz tar -zxvf qcom-blueline-qq3a.200805.001-xxxxxxx.tgz解压后会得到两个extract-开头的shell脚本文件例如extract-google_devices-blueline.sh。依次执行它们./extract-google_devices-blueline.sh ./extract-qcom-blueline.sh执行脚本时它会显示许可协议一直按空格键直到最后会提示你输入I ACCEPT来表示同意。这一步会将必要的闭源二进制文件如GPU驱动、固件等释放到vendor/目录下。如果后续编译时遇到vendor目录权限问题可以运行sudo chmod -R ar vendor注意不要轻易使用777权限ar所有用户可读通常就够了更安全。3. 编译流程与核心问题破解3.1 初始化编译环境与选择目标一切准备就绪后就可以开始编译了。首先需要初始化编译环境。cd ~/aosp source build/envsetup.sh这条命令会引入一系列有用的命令如lunch,m,mm等到当前shell环境中。接着使用lunch命令来选择我们要编译的目标。运行lunch后会看到一个长长的产品列表。对于Pixel 3我们选择aosp_blueline-userdebug。userdebug版本带有root调试权限刷机后默认开启adb非常适合开发和测试。你也可以直接指定lunch aosp_blueline-userdebug系统会确认你的选择并显示一系列环境变量设置信息。3.2 启动编译与遭遇的“拦路虎”启动全量编译使用make命令。为了充分利用多核CPU通常会用-j参数指定并行任务数。一个常见的经验法则是CPU核心数 * 2。我的虚拟机有8个虚拟核心所以我使用make -j16但是如果你的内存不是特别大比如小于32GB我建议保守一点使用-j8或-j4否则极易引发内存不足OOM导致编译进程被系统杀死前功尽弃。我一开始用-j16就遇到了OOM后来改用-j8才稳定下来。编译过程漫长可能需要数小时。在这个过程中你很可能会遇到错误。我遇到的一个非常具体且棘手的错误是关于pathtools的测试失败FAILED: out/soong/.bootstrap/blueprint-pathtools/test/test.passed ... --- FAIL: TestGlobEscapes (0.02s)错误信息指向build/blueprint/pathtools/globtest.go等文件。这个问题在网络上并不常见我花了大量时间排查。最终有效的解决方案是删除有问题的测试文件。请注意这是一个针对特定编译错误的workaround并非通用方案。cd ~/aosp rm build/blueprint/pathtools/globtest.go rm build/blueprint/pathtools/fstest.go删除这两个文件后重新运行make -j8编译得以继续。这个操作的本质是跳过了Soong构建系统AOSP新的构建系统中Blueprint模块的一个有问题的单元测试。在追求编译通过的前提下这是一个可行的办法但理论上它可能掩盖了更深层的环境配置问题。不过在我的场景下后续编译和系统运行都完全正常。3.3 编译完成与输出产物如果一切顺利几个小时后你会看到编译成功的提示。编译生成的系统镜像文件位于~/aosp/out/target/product/blueline/这个目录下有几个非常重要的文件boot.img内核和初始内存磁盘ramdisk镜像。system.img系统分区镜像包含Android框架和预装应用。vendor.img供应商分区镜像包含我们刚才安装的专有驱动。userdata.img用户数据分区镜像-w参数会刷写这个。recovery.img恢复模式镜像。android-info.txt设备信息文件。flash-all.sh/flash-all.bat自动刷机脚本但通常我们更推荐手动刷机可控性更强。4. 刷机入设备从Bootloader到系统启动4.1 刷机前的绝对准备工作在将编译好的系统刷入实体手机之前有几项准备工作是必须且不可逆的请务必确认解锁BootloaderPixel 3的Bootloader必须解锁才能刷入自定义系统。操作步骤是手机进入“设置”-“关于手机”连续点击“版本号”打开开发者选项。然后在“系统”-“高级”-“开发者选项”中开启“OEM解锁”和“USB调试”。手机关机后同时按住“音量减”和“电源键”进入Bootloader模式一个躺着的安卓机器人界面。通过USB连接电脑在电脑终端执行fastboot flashing unlock。注意这会清除手机内所有用户数据请提前备份。退出Google账户这是一个非常重要的安全步骤。在刷入自编译系统前请务必在手机的当前系统中退出所有已登录的Google账户。这是因为Google的Factory Reset Protection (FRP)机制。如果刷机后触发恢复出厂设置而设备里仍有之前的Google账户系统会要求验证该账户才能进入如果你编译的系统没有通过Google认证肯定没有或者你忘记了密码手机就会变“砖”。虽然可以通过一些方法绕过但非常麻烦。提前退出账户是最简单的预防措施。配置USB连接与驱动Windows宿主特别注意如果你的宿主机是Windows并在虚拟机上编译需要确保宿主机已安装Google USB Driver可通过Android SDK Manager安装。在VMware中当手机连接时选择将USB设备连接到虚拟机Ubuntu而不是宿主机。在Ubuntu虚拟机内通常无需额外驱动但需要配置udev规则让普通用户也能访问设备。可以创建一个文件/etc/udev/rules.d/51-android.rules内容如下可能需要根据你的用户ID修改SUBSYSTEMusb, ATTR{idVendor}18d1, MODE0666, GROUPplugdev然后重新加载udev规则sudo udevadm control --reload-rules sudo udevadm trigger。4.2 手动刷机步骤详解我更倾向于手动刷机而不是使用自动脚本因为每一步都清晰可见出了问题也容易定位。进入Bootloader模式确保手机关机。然后同时按住“音量减”和“电源键”直到进入Bootloader界面显示START,RECOVERY MODE等字样。连接设备并检查在Ubuntu终端中进入AOSP源码的out目录下的host工具目录并提升fastboot权限避免每次都用sudocd ~/aosp/out/host/linux-x86/bin sudo chown root:root fastboot sudo chmod s fastboot回到源码根目录设置环境变量指向你的编译输出目录cd ~/aosp export ANDROID_PRODUCT_OUT$(pwd)/out/target/product/blueline检查设备是否被识别fastboot devices应该会显示你的设备序列号状态为fastboot。执行刷机命令这是最关键的一步。使用fastboot flashall命令。-w参数代表擦除wipeuserdata分区这会清除手机所有数据请再次确认已备份。fastboot flashall -w这个命令会依次刷入bootloader,radio(基带),boot,recovery,system,vendor,userdata等所有必要的分区。你会看到终端滚动显示发送和写入每个镜像的进度。处理版本不匹配错误如果你像我一样手机之前运行的是Android 9或其他版本直接刷入Android 10可能会在刷写bootloader或radio时失败提示bootloader version not supported或类似信息。这是因为跨大版本刷机时基带和引导程序可能需要升级。最安全的方法是先刷入一次官方的、完整的、与你要编译的版本号QQ3A.200805.001一致的工厂镜像。从Google官方下载Pixel 3 (blueline) 对应QQ3A.200805.001的工厂镜像。解压后手机进入Bootloader模式在宿主机Windows上执行flash-all.batLinux/Mac执行flash-all.sh。这个操作会完全恢复手机到该版本的官方状态包括Bootloader和基带。官方镜像刷写成功后再重新执行上面的手动刷机步骤刷入我们自己编译的镜像。这时就不会再有版本冲突的错误了。完成与重启flashall命令执行成功后手机会自动重启。第一次启动自编译的Android系统会非常慢因为要进行ART预编译等操作请耐心等待5-15分钟。如果长时间卡在Google Logo或开机动画可以尝试强制重启长按电源键或者进入Recovery模式执行一次Wipe data/factory reset这也会清除数据。5. 常见问题排查与实战心得5.1 编译阶段问题速查表问题现象可能原因解决方案repo init或repo sync失败/极慢网络连接问题无法访问Google源1. 使用国内镜像源如清华、中科大。2. 或采用本文的“源码包驱动包”离线方式。make命令报错java.lang.OutOfMemoryError系统内存不足或-j参数值太高1. 增加虚拟机/物理机内存建议16GB。2. 降低make -j后的并行数如改为-j4。3. 关闭其他占用内存的软件。编译中途失败提示某个文件找不到或权限错误依赖包未安装完整或驱动未正确解压1. 回头仔细检查并安装所有依赖包。2. 确认专有驱动脚本已执行且vendor/目录下有文件。3. 检查vendor/目录权限sudo chmod -R ar vendor。遇到类似bison或flex的工具版本错误系统中存在多个版本或版本不兼容1. 使用apt-get install安装的是稳定版本通常没问题。2. 确保没有通过其他方式如源码编译安装冲突版本。pathtools相关测试失败如本文所述Soong/Blueprint构建系统的单元测试bug删除build/blueprint/pathtools/目录下的globtest.go和fstest.go文件这是一个已知workaround。5.2 刷机与连接问题fastboot devices不显示设备Windows宿主机检查VMware的USB控制器设置建议用USB3.0并确保在手机连接弹窗时选择了“连接到虚拟机”。在设备管理器中检查是否有带感叹号的Android设备手动更新驱动为Google USB Driver。Linux/Ubuntu检查udev规则是否正确配置尝试使用sudo fastboot devices。用lsusb命令查看是否能识别到Google Inc.设备。刷机过程在某个分区如radio失败这几乎总是由于设备当前的Bootloader或基带版本与你要刷入的系统镜像不兼容所致。唯一的可靠解决方案是先刷入一次完整的、对应版本的官方工厂镜像将底层固件升级到正确版本然后再刷自编译的system、vendor等镜像。刷机成功但手机无法启动卡在开机动画第一次启动慢是正常的请等待至少10-15分钟。如果超过20分钟可以尝试强制重启。如果重启无效进入Recovery模式Bootloader界面下用音量键选择RECOVERY MODE执行Wipe data/factory reset和Wipe cache partition。这会清除数据。如果仍不行可能是编译本身有问题或者驱动不匹配。需要重新检查编译日志。5.3 个人实操心得与建议空间是最大的敌人给编译环境分配磁盘空间时一定要慷慨。250GB是底线300GB比较舒适。编译过程中可以用df -h命令随时监控磁盘使用情况。网络问题的替代方案如果repo sync无法进行不要硬扛。寻找国内镜像站提供的AOSP源码快照snapshot或tar包配合驱动包是最高效的方式。这并不影响你对源码的修改和编译。编译参数调优除了-j设置CCACHE能极大提升第二次及以后的编译速度。将CCACHE目录放在读写速度快的磁盘上并分配足够大的容量50GB。保持环境纯净建议为AOSP编译单独创建一个用户或者使用一个干净的虚拟机/容器环境。避免系统中其他软件或配置的干扰。刷机有风险备份是关键解锁Bootloader和刷机一定会清空数据。在开始之前务必通过adb backup或云服务等方式备份好手机里的重要资料。退出Google账户是防止FRP锁的保险丝。耐心与日志编译和刷机是一个需要耐心的过程。遇到错误时不要慌张仔细阅读终端输出的错误信息通常最后几行是关键并复制错误信息去搜索引擎查找。AOSP的编译错误信息通常比较具体很多都能在网上找到解决方案。整个过程走下来从环境准备到手机亮起自己编译的系统虽然步骤繁多但每一步都有其逻辑。它不仅仅是一个技术操作更是一个理解Android系统层次结构、构建流程和硬件依赖关系的过程。当你看到Pixel 3屏幕上出现基于你亲手编译的源码启动的系统时那种对设备底层的掌控感和成就感是普通应用开发难以比拟的。这为后续进行更深度的系统定制比如你提到的修改位置信息打下了坚实的基础。
Pixel 3编译AOSP 10实战：环境配置、源码获取与刷机全流程解析
1. 项目概述与背景折腾Android源码编译大概是每个对系统底层感兴趣或者有特定定制需求的开发者都会经历的一道坎。我之前在Nexus 5x上成功编译并修改了AOSP 7.1.1实现了位置打卡的功能整个过程虽然繁琐但成就感十足。这次我把目标转向了手头的Pixel 3想在这台设备上复现并进一步探索Android 10.0AOSP 10.0 r41的编译与刷机流程。选择Pixel 3代号blueline的原因很简单它是Google的亲儿子官方驱动支持完善社区资料也多对于学习和实验来说是绝佳的“小白鼠”。然而从Nexus 5x到Pixel 3从Android 7.1到Android 10看似只是设备和版本的升级但实际操作中遇到的坑却截然不同。最大的挑战往往不是编译命令本身而是前期的环境搭建、代码与驱动的匹配以及刷机过程中的各种“玄学”问题。很多人包括我自己都曾卡在下载代码这一步网络问题直接劝退。所以这次我决定采用一种更“接地气”的方式直接使用现成的、匹配好的代码分支和驱动包绕过repo同步这个最大的拦路虎把精力集中在编译和刷机这两个核心环节上。这篇文章就是我在Ubuntu 18.04系统上完整走通Pixel 3编译刷入AOSP 10.0 r41的实战记录我会把每个步骤的细节、遇到的错误以及解决方案都掰开揉碎了讲清楚希望能帮你少走弯路。2. 编译环境与源码准备2.1 虚拟机与宿主系统配置编译AOSP对硬件资源的要求不低强烈建议在物理机上直接安装Ubuntu进行这样性能最好。但如果条件有限或者像我一样需要在多系统间切换使用虚拟机也是一个可行的选择只是需要做好配置。我的宿主机是Windows 10虚拟机软件使用的是VMware Workstation 16 Pro。这里有几个关键点必须注意直接关系到编译能否成功以及效率。首先是硬盘空间AOSP源码本身巨大编译产生的中间文件和输出文件更是占用海量空间。我最初只分配了150GB结果编译到一半就空间不足前功尽弃。血的教训是分配给虚拟机的硬盘空间绝对不能少于250GB我最终调整到了300GB编译完成后剩余空间大约在30-40GB左右这才算比较稳妥。如果你打算长期折腾多个版本预留500GB都不为过。其次是内存和CPU核心数。AOSP编译是一个极度消耗内存和CPU的过程。官方推荐至少16GB内存。在虚拟机上我分配了20GB内存给Ubuntu并将宿主机的8个CPU核心全部分配给它如果你的宿主机核心数多可以分配更多但要注意给宿主机留一些。这里有个小技巧在VMware的虚拟机设置中除了分配内存和处理器务必在“处理器”选项里勾选“虚拟化Intel VT-x/EPT或AMD-V/RVI”这个选项对于在虚拟机内高效运行编译任务至关重要不开启可能会导致编译速度异常缓慢甚至失败。操作系统我选择了Ubuntu 18.04 LTS64位。选择LTS版本是因为其长期支持软件源稳定社区遇到的大多数问题在这个版本上都有现成的解决方案避免因系统版本太新或太旧带来的兼容性麻烦。2.2 关键软件包的安装系统安装好后第一件事就是换源。默认的国外源下载速度慢如蜗牛必须替换为国内的镜像源如阿里云、清华、中科大的源。具体操作是备份并编辑/etc/apt/sources.list文件。这一步是基础能为你后续节省大量等待时间。接下来是安装编译所需的依赖包。AOSP官方文档会给出一个列表但那个列表有时不够完整。下面是我结合官方文档和多次实战经验整理出来的完整安装命令在Ubuntu 18.04上亲测有效。请注意这些命令需要分条执行因为有些包在同一个apt-get install命令中可能会因为依赖关系问题而安装失败。首先安装一些基础工具和库sudo apt-get update sudo apt-get 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 libgl1-mesa-dev libxml2-utils xsltproc unzip然后安装更多必要的开发库包括一些32位兼容库因为Android编译需要32位工具链sudo apt-get install -y lib32z1-dev lib32readline-dev libssl-dev liblz4-tool libesd-java libwxgtk3.0-dev squashfs-tools pngcrush schedtool sudo apt-get install -y python-markdown libswitch-perl libssl-dev bc sudo apt-get install -y tofrodos dos2unix这里有个容易忽略的点openjdk-8-jdk。Android 10.0 (AOSP 10) 的编译必须使用Java 8更高版本的Java会导致编译错误。安装命令如下sudo apt-get install -y openjdk-8-jdk安装完成后务必通过java -version和javac -version命令确认默认的Java版本是1.8。如果不是需要使用update-alternatives命令来切换系统的默认Java版本。最后安装一个有用的工具ccache。它不是必须的但能显著加速后续的重复编译过程。它通过缓存之前的编译结果来工作。sudo apt-get install -y ccache source ~/.bashrc echo ‘export USE_CCACHE1‘ ~/.bashrc echo ‘export CCACHE_DIR/home/你的用户名/.ccache‘ ~/.bashrc # 可以指定一个大的磁盘分区 prebuilts/misc/linux-x86/ccache/ccache -M 50G # 设置缓存大小为50GB这个值可以根据你的硬盘空间调整2.3 源码与驱动获取的“捷径”传统方法是使用repo工具同步整个AOSP代码仓库这对于网络环境是个巨大考验。我采用的是一种更直接的方法寻找并下载特定分支的源码快照tarball以及与之完全匹配的专有驱动Proprietary Binary Drivers。确定分支与驱动版本这是最关键的一步版本不匹配会导致编译失败或刷机后无法启动。我的目标分支是android-10.0.0_r41。通过查询Google的驱动发布页面我找到了对应Pixel 3 (blueline) 的驱动版本号QQ3A.200805.001。你必须确保源码分支和驱动版本号完全一致。获取源码我通过其他渠道如国内镜像站或已下载的备份获得了android-10.0.0_r41分支的完整源码压缩包。将其解压到你的工作目录例如~/aosp。解压命令tar -xvf aosp_android-10.0.0_r41.tar.gz -C ~/解压后目录结构应包含build/,frameworks/,packages/等标准AOSP目录。下载专有驱动前往Google的官方驱动下载站点通常需要科学上网这里我们假设你已经通过合规方式获取搜索blueline和QQ3A.200805.001。你会找到两个文件例如google_devices-blueline-qq3a.200805.001-xxxxxxx.tgzqcom-blueline-qq3a.200805.001-xxxxxxx.tgz将它们下载到你的源码根目录即~/aosp下。解压与安装驱动cd ~/aosp tar -zxvf google_devices-blueline-qq3a.200805.001-xxxxxxx.tgz tar -zxvf qcom-blueline-qq3a.200805.001-xxxxxxx.tgz解压后会得到两个extract-开头的shell脚本文件例如extract-google_devices-blueline.sh。依次执行它们./extract-google_devices-blueline.sh ./extract-qcom-blueline.sh执行脚本时它会显示许可协议一直按空格键直到最后会提示你输入I ACCEPT来表示同意。这一步会将必要的闭源二进制文件如GPU驱动、固件等释放到vendor/目录下。如果后续编译时遇到vendor目录权限问题可以运行sudo chmod -R ar vendor注意不要轻易使用777权限ar所有用户可读通常就够了更安全。3. 编译流程与核心问题破解3.1 初始化编译环境与选择目标一切准备就绪后就可以开始编译了。首先需要初始化编译环境。cd ~/aosp source build/envsetup.sh这条命令会引入一系列有用的命令如lunch,m,mm等到当前shell环境中。接着使用lunch命令来选择我们要编译的目标。运行lunch后会看到一个长长的产品列表。对于Pixel 3我们选择aosp_blueline-userdebug。userdebug版本带有root调试权限刷机后默认开启adb非常适合开发和测试。你也可以直接指定lunch aosp_blueline-userdebug系统会确认你的选择并显示一系列环境变量设置信息。3.2 启动编译与遭遇的“拦路虎”启动全量编译使用make命令。为了充分利用多核CPU通常会用-j参数指定并行任务数。一个常见的经验法则是CPU核心数 * 2。我的虚拟机有8个虚拟核心所以我使用make -j16但是如果你的内存不是特别大比如小于32GB我建议保守一点使用-j8或-j4否则极易引发内存不足OOM导致编译进程被系统杀死前功尽弃。我一开始用-j16就遇到了OOM后来改用-j8才稳定下来。编译过程漫长可能需要数小时。在这个过程中你很可能会遇到错误。我遇到的一个非常具体且棘手的错误是关于pathtools的测试失败FAILED: out/soong/.bootstrap/blueprint-pathtools/test/test.passed ... --- FAIL: TestGlobEscapes (0.02s)错误信息指向build/blueprint/pathtools/globtest.go等文件。这个问题在网络上并不常见我花了大量时间排查。最终有效的解决方案是删除有问题的测试文件。请注意这是一个针对特定编译错误的workaround并非通用方案。cd ~/aosp rm build/blueprint/pathtools/globtest.go rm build/blueprint/pathtools/fstest.go删除这两个文件后重新运行make -j8编译得以继续。这个操作的本质是跳过了Soong构建系统AOSP新的构建系统中Blueprint模块的一个有问题的单元测试。在追求编译通过的前提下这是一个可行的办法但理论上它可能掩盖了更深层的环境配置问题。不过在我的场景下后续编译和系统运行都完全正常。3.3 编译完成与输出产物如果一切顺利几个小时后你会看到编译成功的提示。编译生成的系统镜像文件位于~/aosp/out/target/product/blueline/这个目录下有几个非常重要的文件boot.img内核和初始内存磁盘ramdisk镜像。system.img系统分区镜像包含Android框架和预装应用。vendor.img供应商分区镜像包含我们刚才安装的专有驱动。userdata.img用户数据分区镜像-w参数会刷写这个。recovery.img恢复模式镜像。android-info.txt设备信息文件。flash-all.sh/flash-all.bat自动刷机脚本但通常我们更推荐手动刷机可控性更强。4. 刷机入设备从Bootloader到系统启动4.1 刷机前的绝对准备工作在将编译好的系统刷入实体手机之前有几项准备工作是必须且不可逆的请务必确认解锁BootloaderPixel 3的Bootloader必须解锁才能刷入自定义系统。操作步骤是手机进入“设置”-“关于手机”连续点击“版本号”打开开发者选项。然后在“系统”-“高级”-“开发者选项”中开启“OEM解锁”和“USB调试”。手机关机后同时按住“音量减”和“电源键”进入Bootloader模式一个躺着的安卓机器人界面。通过USB连接电脑在电脑终端执行fastboot flashing unlock。注意这会清除手机内所有用户数据请提前备份。退出Google账户这是一个非常重要的安全步骤。在刷入自编译系统前请务必在手机的当前系统中退出所有已登录的Google账户。这是因为Google的Factory Reset Protection (FRP)机制。如果刷机后触发恢复出厂设置而设备里仍有之前的Google账户系统会要求验证该账户才能进入如果你编译的系统没有通过Google认证肯定没有或者你忘记了密码手机就会变“砖”。虽然可以通过一些方法绕过但非常麻烦。提前退出账户是最简单的预防措施。配置USB连接与驱动Windows宿主特别注意如果你的宿主机是Windows并在虚拟机上编译需要确保宿主机已安装Google USB Driver可通过Android SDK Manager安装。在VMware中当手机连接时选择将USB设备连接到虚拟机Ubuntu而不是宿主机。在Ubuntu虚拟机内通常无需额外驱动但需要配置udev规则让普通用户也能访问设备。可以创建一个文件/etc/udev/rules.d/51-android.rules内容如下可能需要根据你的用户ID修改SUBSYSTEMusb, ATTR{idVendor}18d1, MODE0666, GROUPplugdev然后重新加载udev规则sudo udevadm control --reload-rules sudo udevadm trigger。4.2 手动刷机步骤详解我更倾向于手动刷机而不是使用自动脚本因为每一步都清晰可见出了问题也容易定位。进入Bootloader模式确保手机关机。然后同时按住“音量减”和“电源键”直到进入Bootloader界面显示START,RECOVERY MODE等字样。连接设备并检查在Ubuntu终端中进入AOSP源码的out目录下的host工具目录并提升fastboot权限避免每次都用sudocd ~/aosp/out/host/linux-x86/bin sudo chown root:root fastboot sudo chmod s fastboot回到源码根目录设置环境变量指向你的编译输出目录cd ~/aosp export ANDROID_PRODUCT_OUT$(pwd)/out/target/product/blueline检查设备是否被识别fastboot devices应该会显示你的设备序列号状态为fastboot。执行刷机命令这是最关键的一步。使用fastboot flashall命令。-w参数代表擦除wipeuserdata分区这会清除手机所有数据请再次确认已备份。fastboot flashall -w这个命令会依次刷入bootloader,radio(基带),boot,recovery,system,vendor,userdata等所有必要的分区。你会看到终端滚动显示发送和写入每个镜像的进度。处理版本不匹配错误如果你像我一样手机之前运行的是Android 9或其他版本直接刷入Android 10可能会在刷写bootloader或radio时失败提示bootloader version not supported或类似信息。这是因为跨大版本刷机时基带和引导程序可能需要升级。最安全的方法是先刷入一次官方的、完整的、与你要编译的版本号QQ3A.200805.001一致的工厂镜像。从Google官方下载Pixel 3 (blueline) 对应QQ3A.200805.001的工厂镜像。解压后手机进入Bootloader模式在宿主机Windows上执行flash-all.batLinux/Mac执行flash-all.sh。这个操作会完全恢复手机到该版本的官方状态包括Bootloader和基带。官方镜像刷写成功后再重新执行上面的手动刷机步骤刷入我们自己编译的镜像。这时就不会再有版本冲突的错误了。完成与重启flashall命令执行成功后手机会自动重启。第一次启动自编译的Android系统会非常慢因为要进行ART预编译等操作请耐心等待5-15分钟。如果长时间卡在Google Logo或开机动画可以尝试强制重启长按电源键或者进入Recovery模式执行一次Wipe data/factory reset这也会清除数据。5. 常见问题排查与实战心得5.1 编译阶段问题速查表问题现象可能原因解决方案repo init或repo sync失败/极慢网络连接问题无法访问Google源1. 使用国内镜像源如清华、中科大。2. 或采用本文的“源码包驱动包”离线方式。make命令报错java.lang.OutOfMemoryError系统内存不足或-j参数值太高1. 增加虚拟机/物理机内存建议16GB。2. 降低make -j后的并行数如改为-j4。3. 关闭其他占用内存的软件。编译中途失败提示某个文件找不到或权限错误依赖包未安装完整或驱动未正确解压1. 回头仔细检查并安装所有依赖包。2. 确认专有驱动脚本已执行且vendor/目录下有文件。3. 检查vendor/目录权限sudo chmod -R ar vendor。遇到类似bison或flex的工具版本错误系统中存在多个版本或版本不兼容1. 使用apt-get install安装的是稳定版本通常没问题。2. 确保没有通过其他方式如源码编译安装冲突版本。pathtools相关测试失败如本文所述Soong/Blueprint构建系统的单元测试bug删除build/blueprint/pathtools/目录下的globtest.go和fstest.go文件这是一个已知workaround。5.2 刷机与连接问题fastboot devices不显示设备Windows宿主机检查VMware的USB控制器设置建议用USB3.0并确保在手机连接弹窗时选择了“连接到虚拟机”。在设备管理器中检查是否有带感叹号的Android设备手动更新驱动为Google USB Driver。Linux/Ubuntu检查udev规则是否正确配置尝试使用sudo fastboot devices。用lsusb命令查看是否能识别到Google Inc.设备。刷机过程在某个分区如radio失败这几乎总是由于设备当前的Bootloader或基带版本与你要刷入的系统镜像不兼容所致。唯一的可靠解决方案是先刷入一次完整的、对应版本的官方工厂镜像将底层固件升级到正确版本然后再刷自编译的system、vendor等镜像。刷机成功但手机无法启动卡在开机动画第一次启动慢是正常的请等待至少10-15分钟。如果超过20分钟可以尝试强制重启。如果重启无效进入Recovery模式Bootloader界面下用音量键选择RECOVERY MODE执行Wipe data/factory reset和Wipe cache partition。这会清除数据。如果仍不行可能是编译本身有问题或者驱动不匹配。需要重新检查编译日志。5.3 个人实操心得与建议空间是最大的敌人给编译环境分配磁盘空间时一定要慷慨。250GB是底线300GB比较舒适。编译过程中可以用df -h命令随时监控磁盘使用情况。网络问题的替代方案如果repo sync无法进行不要硬扛。寻找国内镜像站提供的AOSP源码快照snapshot或tar包配合驱动包是最高效的方式。这并不影响你对源码的修改和编译。编译参数调优除了-j设置CCACHE能极大提升第二次及以后的编译速度。将CCACHE目录放在读写速度快的磁盘上并分配足够大的容量50GB。保持环境纯净建议为AOSP编译单独创建一个用户或者使用一个干净的虚拟机/容器环境。避免系统中其他软件或配置的干扰。刷机有风险备份是关键解锁Bootloader和刷机一定会清空数据。在开始之前务必通过adb backup或云服务等方式备份好手机里的重要资料。退出Google账户是防止FRP锁的保险丝。耐心与日志编译和刷机是一个需要耐心的过程。遇到错误时不要慌张仔细阅读终端输出的错误信息通常最后几行是关键并复制错误信息去搜索引擎查找。AOSP的编译错误信息通常比较具体很多都能在网上找到解决方案。整个过程走下来从环境准备到手机亮起自己编译的系统虽然步骤繁多但每一步都有其逻辑。它不仅仅是一个技术操作更是一个理解Android系统层次结构、构建流程和硬件依赖关系的过程。当你看到Pixel 3屏幕上出现基于你亲手编译的源码启动的系统时那种对设备底层的掌控感和成就感是普通应用开发难以比拟的。这为后续进行更深度的系统定制比如你提到的修改位置信息打下了坚实的基础。
