前言
虽说几年前在一家公司做机顶盒的时候总是需要编译Android源码，但是那时还没有手中的爱机：Nexus 6，又名shamu。今天我要为它刷入一个自己编译的Rom。拿起键盘就是干。
笔者注：AOSP:Android Open Source Project，安卓开源项目
准备
Ubuntu 14.04+
OpenJDK/JDK
Nexus/Pixel手机一部
假设你已经有了一个较新的Ubuntu系统和一部谷歌亲儿子手机，下文将从安装jdk开始。
AOSP编译环境搭建
安装OpenJDK
警告：不要使用Oracle jdk来编译较新（API 21+/Android 5.0及以上）的AOSP，会在准备编译工作make clobber时出现错误提示.
Checking build tools versions...
*************************************************************
You asked for an OpenJDK based build but your version is java version "1.8.0_121" Java(TM) SE Runtime Environment(build 1.8.0_121-b13)Java HotSpot (TM)64 bit Server VM(build 25.121-b13), mixed mode).
*************************************************************
build/core/main.mk:230: *** stop.
关于JDK版本的选择：根据你想编译的Android版本来决定
AOSP最新源码: OpenJDK 8
Android 5.x (Lollipop) - Android 6.0 (Marshmallow):OpenJDK 7
Android 2.3.x (Gingerbread) - Android 4.4.x(KitKat):Java JDK 6
Android 1.5 (Cupcake) - Android 2.2.x (Froyo): Java JDK 5
想要编译的是Android 7.0，所以需要使用是OpenJDK 8。
用的Ubuntu 14.04 LTS，可采取安装deb包或者添加ppa两种方式安装OpenOJDK 8：
1.OpenJDK deb包下载:https://github.com/xiong-it/buildAOSP/tree/master/OpenJDK8
2.添加ppa方式安装OpenJDK
$ sudo add-apt-repository ppa:openjdk-r/ppa
$ sudo apt-get update
$ sudo apt-get install openjdk-8-jdk
$ sudo update-alternatives --config java
$ sudo update-alternatives --config javac
假如你Ubuntu是15.04或者更新的系统，可直接运行下列命令进行OpenJDK 8安装
$ sudo apt-get update
$ sudo apt-get install openjdk-8-jdk
Linux使用下列命令查看机器中所有jdk版本
$ michaelx@michaelx-ThinkPad:~/AOSP_NBD91Z$ update-java-alternatives -l
// 打印出下面已安装的jdk版本
java-1.8.0-openjdk-amd64 1069 /usr/lib/jvm/java-1.8.0-openjdk-amd64
Linux设置默认JDK命令
// 设置默认为openjdk8，此处必须选用OpenJDK8
$ sudo update-java-alternatives -s java-1.8.0-openjdk-amd64
// 设置默认为oracle jdk8
$ sudo update-java-alternatives -s java-8-oracle
// 设置默认为oracle jdk7
$ sudo update-java-alternatives -s java-7-oracle
Ubuntu 14.04设置默认OpenJDK 8时出现一处警告提示：
update-java-alternatives: plugin alternative does not exist: /usr/lib/jvm/java-8-openjdk-amd64/jre/lib/amd64/IcedTeaPlugin.so
该提示无需理会，可直接忽略。
查看Java版本，出现以下提示，说明jdk环境已经ok。
$ java -version
openjdk version "1.8.0_111"
OpenJDK Runtime Environment (build 1.8.0_111-8u111-b14-3~14.04.1-b14)
OpenJDK 64-Bit Server VM (build 25.111-b14, mixed mode)
如果实在切换不了默认jdk，就像博主一样，卸了oracle jdk吧。
安装必要软件
在你的Ubuntu 14(x64)上执行以下命令
$ sudo apt-get install 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 ccache \
libgl1-mesa-dev libxml2-utils xsltproc unzip
会有些已经安装，有些无法安装，或者安装失败，无需理会，继续往下。其他系统版本系统请直接参考：https://source.android.com/source/initializing.html
配置USB访问权限
ps：不知道这个干啥的，但是官方是这么建议的，为了让普通用户可访问usb设备。
$ wget -S -O - http://source.android.com/source/51-android.rules | sed "s/<username>/$USER/" | sudo tee >/dev/null /etc/udev/rules.d/51-android.rules; sudo udevadm control --reload-rules
安装repo
安装repo以下载AOSP源码。repo是Google根据Git开发来专门管理Android源码用的，具有断点续传的特性。其主要命令可参考：git/repo常用命令一览。依次执行下面命令。
$ cd ~
$ mkdir bin
$ PATH=~/bin:$PATH
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo # 给repo添加执行权限
配置git
由于需要下载Android源码，你需要事先准备好一个google的gmail邮箱。执行以下命令配置git用户名和gmail邮箱。
$ git config --global user.name "Your Name"
$ git config --global user.email "you@gmail.com"
配置Google的git cookies访问权限，以便大量下载aosp源码站点资源。
https://android.googlesource.com/new-password
复制框中的命令,粘贴到终端,执行。
下载AOSP源码
创建一个目录以存放Android源码
$ mkdir ~/AOSP_NBD91Z # 目录名请自行定义，本文以AOSP_NBD91ZNBD91Z为例
$ cd AOSP_NBD91Z
根据手中的机器和以下两个连接进行repo分支选择：
https://source.android.com/source/build-numbers.html
https://developers.google.com/android/nexus/drivers
AOSP源码编译默认是不适配驱动的，只适合模拟器运行，由于博主想要为Nexus 6编译，所以需要考虑驱动问题，根据上文第二个链接找到shamu的最新驱动，目前（20170307）最新的驱动支持到build NBD91Z，将驱动下载下来，留着备用。
在第一个链接中找到对应的branch name（android-7.0.0_r29）。
在AOSP本地目录初始化repo分支
$ cd ~/AOSP_NBD91Z
$ repo init -u https://android.googlesource.com/platform/manifest -b android-7.0.0_r29
下载/续传AOSP源码
无论是第一次开始下载，还是中途断掉后接着续传下载，都是执行以下命令。
$ repo sync
之后就是漫长的等待了，该分支（android-7.0.0_r29）代码总共约80G（含版本管理文件.repo目录46G）。
这里提醒下各位，分区的时候一定记得至少至少至少给到120G啊，80G还不是最新分支的大小呢。编译后更加大得多：该分支编译出的out目录共30G左右。
不过下载完成后，如果没什么版本控制的需要 .repo目录倒是可以删除掉，节省点硬盘空间。
编译AOSP预备工作
设置编译缓存（可选操作）
可加速后续第二次编译，如需要，可在源码目录执行以下命令
$ export USE_CCACHE=1
$ export CCACHE_DIR=~/AOSP_NBD91Z/.ccache # 目录自定义
$ prebuilts/misc/linux-x86/ccache/ccache -M 50G # 官方推荐50-100G
更新环境变量
$ vim ~/.bashrc
# 添加以下这行
export USE_CCACHE=1
$ source ~/.bashrc
释放手机驱动
将上述下载的几个驱动文件解压到源码根目录，解压后也就是几个脚本文件，依次执行，以释放驱动，画风大概如下
共8大条款，几十个小条款，一行行回车按过去，心累啊。
重点：在执行驱动脚本后，会让你看一大长串协议，最后你需要输入：I ACCEPT 来同意驱动的协议，方可释放驱动文件。按回车按快了则提示你没有同意，驱动未释放成功。成功之后会多出一个vendor目录。
清理编译文件
驱动释放完毕，先执行make clobber清理下编译后文件的目录，第一次编译其实博主觉得这个命令无所谓。
相似命令：make clean 它清理out/target/product/[product_name]目录。
编译AOSP
准备好编译平台
$ cd AOSP_NBD91Z
$ source build/envsetup.sh
# or 或者，上面的命令和下面的命令等价
$ . build/envsetup.sh
选择编译平台
执行上述命令后方可执行这条命令lunch
由于笔者手中是Nexus 6（shamu），所以果断选择了21
关于几种模式的区别
user 正常模式，给普通用户用的
userdebug 具备root权限和更多调试功能，其他和user模式无异
eng 开发者的最佳选项，具有许多额外的调试工具
正式编译AOSP源码
运行make进行编译，也可以使用-j选项指定并行编译线程数量
# 利用6个线程进行编译。官方建议的最快并行线程数量为：j16-j32之间。
$ make -j6
# 请各位根据自身CPU性能量力而行。博主曾经使用-j16导致GUI界面和终端统统卡死，只能强制关机，心疼我的ssd硬盘30s。
又是一次漫长的等待啊，如果不出什么问题，那么在out/target/product/[product_name]/目录下将会多出诸如system.img，recovery.img等等，就可以愉快的刷机了。
下面是生成的各种镜像文件和其他。
编译AOSP遇到的问题
权限遭拒
由于博客使用了外部硬盘作为out编译输出，make时提示Permission is denied。这时换成sudo make即可。
使用外部磁盘做out输出：export OUT_DIR_COMMON_BASE=/media/username/外部磁盘路径/out
内存不足
由于笔者的内存只有4G，并且最开始没有分出swap分区，导致多次内存不足编译失败，有多种日志形式都表明内存不足：
[ 34% 12287/35393] Building with Jack: out/target/common/obj/JAVA_LIBRARIES/core-all_intermediates/with-local/classes.dex
FAILED: /bin/bash out/target/common/obj/JAVA_LIBRARIES/core-all_intermediates/with-local/classes.dex.rsp
Communication error with Jack server (52). Try 'jack-diagnose'
ninja: build stopped: subcommand failed.
make: *** [ninja_wrapper] Error 1
[ 82% 30024/36285] Aligning zip: out/target/product/shamu/obj/SHARED_LIBRARIES/libdlext_test_runpath_zip_zipaligned_intermediates/libdlext_test_runpath_zip_zipaligned.zip
[ 82% 30025/36285] Import includes file: out/target/product/shamu/obj/STATIC_LIBRARIES/libverifier_intermediates/import_includes
[ 82% 30026/36285] target thumb C++: libverifier <= bootable/recovery/asn1_decoder.cpp
[ 82% 30027/36285] target thumb C++: libverifier <= bootable/recovery/verifier.cpp
[ 82% 30028/36285] Export includes file: -- out/target/product/shamu/obj/STATIC_LIBRARIES/libverifier_intermediates/export_includes
[ 82% 30029/36285] target thumb C++: libverifier <= bootable/recovery/ui.cpp
ninja: fatal: fork: Cannot allocate memory
make: *** [ninja_wrapper] Error 1
FAILED: /bin/bash out/target/common/obj/JAVA_LIBRARIES/core-all_intermediates/with-local/classes.dex.rsp
Out of memory error (version 1.2-rc4 'Carnac' (298900 f95d7bdecfceb327f9d201a1348397ed8a843843 by android-jack-team@google.com)).
GC overhead limit exceeded.
Try increasing heap size with Java option '-Xmx<size>'.
Warning: This may have produced partial or corrupted output.
[ 31% 11494/36285] host C++: libartd-compiler <= art/compiler/optimizing/graph_visualizer.cc
[ 31% 11494/36285] Building with Jack: out/target/common/obj/JAVA_LIBRARIES/libprotobuf-java-nano_intermediates/classes.jack
[ 31% 11494/36285] build out/target/common/obj/JAVA_LIBRARIES/sdk_v21_intermediates/classes.jack
ninja: build stopped: subcommand failed.
[ 6% 2375/35393] target Java: icu4j (out/target/common/obj/JAVA_LIBRARIES/icu4j_intermediates/classes)
Note: Some input files use or override a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
Note: external/icu/icu4j/main/classes/core/src/com/ibm/icu/impl/Relation.java uses unchecked or unsafe operations.
Note: Recompile with -Xlint:unchecked for details.
[ 6% 2394/35393] host C++: libLLVMMC_32 <= external/llvm/lib/MC/MCDwarf.cppninja: fatal: fork: Cannot allocate memory
make: *** [ninja_wrapper] Error 1
[ 5% 1883/35393] Docs droiddoc: out/target/common/docs/api-stubs
FAILED: /bin/bash out/target/common/docs/api-stubs-timestamp.rsp
OpenJDK 64-Bit Server VM warning: INFO: os::commit_memory(0x00000000bdb80000, 72876032, 0) failed; error='Cannot allocate memory' (errno=12)
#
# There is insufficient memory for the Java Runtime Environment to continue.
# Native memory allocation (mmap) failed to map 72876032 bytes for committing reserved memory.
# An error report file with more information is saved as:
# /home/michaelx/AOSP_NBD91Z/hs_err_pid508.log
[ 5% 1883/35393] Docs droiddoc: out/target/common/docs/system-api-stubs
DroidDoc took 27 sec. to write docs to out/target/common/docs/system-api-stubs
ninja: build stopped: subcommand failed.
make: *** [ninja_wrapper] Error 1
解决内存不足的3个办法：
1.增加机器内存
2.增加swap分区
3.修改prebuild/sdk/tools/jack-admin文件
第一种方式就不说了，给机器加根内存条。
第二种方式：增加swap分区
第三种方式：
# 备份jack-admin
$ cp prebuild/sdk/tools/jack-admin ~/Docments/jack-admin.original
# 修改jack-admin文件
$ vim prebuild/sdk/tools/jack-admin
# start-server方法，笔者的jack-admin在443行，修改该方法中的一句话：
# JACK_SERVER_COMMAND="java -Djava.io.tmpdir=$TMPDIR $JACK_SERVER_VM_ARGUMENTS -cp $LAUNCHER_JAR $LAUNCHER_NAME"
# 改成下面这行,增加java堆大小。
JACK_SERVER_COMMAND="java -Djava.io.tmpdir=$TMPDIR $JACK_SERVER_VM_ARGUMENTS -Xmx8000M -cp $LAUNCHER_JAR $LAUNCHER_NAME"
以上增加的-Xmx8000M，表示允许java在运行时java堆使用最大不超过8000M内存，这个数值是笔者经历了多次测试得到的结果，2048M，4096M，依旧没通过编译，改成8000M后编译通过，可能跟笔者自身硬件限制有很大关系
另一种修改方式：修改jack-admin第29行的变量：JACK_SERVER_VM_ARGUMENTS="${JACK_SERVER_VM_ARGUMENTS:=-Dfile.encoding-UTF-8 -XX:+TieredCompilation}"
改成：
JACK_SERVER_VM_ARGUMENTS="${JACK_SERVER_VM_ARGUMENTS:=-Dfile.encoding-UTF-8 -XX:+TieredCompilation -Xmx8000M}"
但是这种修改方式仍然不好使，编译失败了。
笔者是尝试了第二，三种方式解决。
jack-server无法运行
解决Jack server failed to (re)start办法：
$ cd /prebuild/sdk/tools/
$ jack-admin stop-server
$ jack-admin start-server
总结
到了这里，相信大家都能轻松搞机了，放2张Nexus 6刷机后的高清截图：
