执行环境：Ubuntu 20.04 LTS，Python 3.8.2
参照文档：https://blog.csdn.net/zz531987464/article/details/94163954
目的：并不是要 ROM 本身，而是期望创建一个比 NDK 更强的 native 开发环境

1. 下载 repo

2. 在 Google 官方网站（https://source.android.com/setup/start/build-numbers）上找 Pixel XL 所对应的 Android 版本标记

手持一台已经解锁 bootloader 且系统为 Android  10 的 Pixel XL，在上述网址表内的 Build 栏找到对应的源码版本是 QP1A.191005.007.A1，源码 Tag 为 android-10.0.0_r5，此 Tag 在下载 AOSP 源码时要用到。

3. 下载 AOSP 源码

在合适的位置新建目录用于存放源码并下载。

sync 并发数量镜像站有说明，不宜太高，不然有可能出现 sync 报错的情况，这里建议选择 -j4。后面出现需要选 y/N 时，选择 y 即可。然后耐心等待，出错退出的话再执行上述最后一条命令直到成功即可。

4. 下载对应版本的 Binary Drive（地址：https://developers.google.com/android/drivers#marlinqp1a.191005.007.a1）

下载 Binary Drive 需要知道对应的细分版本号，也即上面的 QP1A.191005.007.A1，它也可用 cat build/core/build_id.mk 命令看到。

点击 Link 会下载到两个 .tgz 压缩包，解压后是两个 .sh 脚本，extract-google_devices-marlin.sh 和 extract-qcom-marlin.sh。将其放到源代码根目录下并执行，看完许可协议后按照要求输入：I ACCEPT，最终 binary 会自动下载到 vendor 目录，至此所有的 AOSP 代码下载完成。

4. 编译 AOSP 源码

4.1 编译环境搭建

因为本机之前已经有部分编译需要的工具安装于其上（ccache、curl、git、gnupg、m4、zip、unzip、build-essential、bison、flex、gperf、xsltproc、dpkg-dev、gcc-multilib、g++-multilib、lib32ncurses5-dev、lib32z-dev、libc6-dev-i386、libgl1-mesa-dev、libx11-dev、libxml2-utils、x11proto-core-dev、zlib1g-dev），因此只执行了以下组件的安装：

其中 libesd0-dev 在 Ubuntu  20.04 LTS 的默认仓库里没有，需要把 deb http://cn.archive.ubuntu.com/ubuntu/ xenial main universe 添加到 apt 的源文件里，update 后再安装。

4.2 安装 OpenJDK

本机已经安装了 Oracle 的 JDK 8，因此略过未执行。

安装完以后，执行 sudo vi /etc/profile 添加 JAVA_HOME 相关配置。在打开的 profile 文件的末尾添加下面的内容：

使用 source /etc/profile 使环境变量配置立即生效。

使用 java -version 检查是否 JDK 已生效，检测到版本说明安装成功，接下来可以开始编译代码了。

4.3 编译代码

根据其它零散文档，预防性执行了 sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so 和 export LC_ALL=C。然后，

第一次编译从晚上 11:40 分左右开始，历时 7 时 6 分后出错、失败、退出。出错步骤为 failed //frameworks/base:system-api-stubs-docs Metalava [common]。光看信息没有头绪，搜索到了 https://stackoverflow.com/questions/58886407/aosp-ninja-build-stopped-subcommand-failed，参考后把开着的 Firefox 和 Chrome 都退出，再次执行 make，把 -j4 调整为 -j2，这第二次编译历时 1 小时后成功。

》当前进度至此《

5. 拉取 kernel 代码并编译

根据前面的方法拉取编译的 AOSP 代码中是不包含 kernel 源码的，而是一个已经编译好的内核镜像文件。如果需要修改编译 kernel 源码，需要单独拉取 kernel 的代码进行编译。

地址：https://source.android.com/setup/build/building-kernels#id-version

从上表中我们可以看到，Pixel XL 的 kernel 镜像在 AOSP 的目录为 device/google/marlin-kernel，同时可以看到分支名称为  android-msm-marlin-3.18-pie-qpr2。

拉取代码的命令为：

5.1 编译 kernel 源码

首先在 AOSP 源码目录下 source build/envsetup.sh，lunch aosp_marlin-userdebug 一下，用于启动一些编译时所需要的环境变量，例如：交叉编译工具等。

然后修改 kernel 源码根目录下的 Makefile。git diff 记录如下：

编译命令：

如果有编译报错，则安装如下工具 sudo apt-get install liblz4-tool。最终在 arch/arm64/boot 下生成了 Image.lz4-dtb 内核镜像文件。

5.2 整合 Image.lz4-dtb 文件到 AOSP 目录下

将 arch/arm64/boot/Image.lz4-dtb 文件复制到 AOSP 的 device/google/marlin-kernel 目录下，然后在 AOSP 源码根目录下执行 make bootimage 生成最终的 boot.img 即可。

注：[100% 2/2] Target boot image from recovery: out/target/product/marlin/boot.img
cp: 无法获取 ‘out/target/product/marlin/root/init.recovery.*.rc’ 的文件状态(stat): 没有那个文件或目录

编译报错可以忽略，没什么大的关系。

6. 刷机烧录镜像

解锁指导：https://source.android.com/setup/build/running#unlocking-the-bootloader。

重启到 bootloader：adb reboot bootloader；然后解锁手机：fastboot flashing unlock。

刷入镜像前先双清一下：

刷入编译的所有镜像：fastboot flashall -w。其具体刷入的流程日志为：

单独刷入某个 img：

刷入完后执行 fastboot reboot 重启手机即可。

打开 Settings，查看“关于手机”，显示的版本号和内核版本号都是我们自己编译出来的：

7. 链接

• Google 设备官方代号标记和细分版本：https://source.android.com/setup/start/build-numbers
• Google 设备 Binary Drive 下载地址：https://developers.google.com/android/drivers
• AOSP 清华镜像站地址：https://mirrors.tuna.tsinghua.edu.cn/help/AOSP/
• Android kernel 地址：https://source.android.com/setup/build/building-kernels#id-version

根据国情，首选从清华镜像站上下载 Android 源代码。Google 官网即使有梯子也很慢，清华镜像站下载速度还是很快的。