Build aosp for Nexus 5X - brunch:7.1.1 (N4F26U)

Build aosp for Nexus 5X

前言：在编译AOSP时， 多次遇到问题，
下载和编译时间较长，最终编译成功后
flash到Nexus 5X时也遇到了各种各样的
问题。为了避免大家走同样的湾路，整理
如下Build AOSP的步骤，仅供参考。

    ----- 2018.11.19   Eric Y

开始之前，请先浏览下面的官网熟悉一下思路。准备好大硬盘（250G）。
电脑要好的配置速度才能嗖嗖的。
https://source.android.com/setup/build/requirements
（请自行想办法打开网页）

Step 1: 安装repo，下载AOSP

目标机： Nexus 5X
编译环境：ubuntu 16.04.5 LTS
选择下载的分支：android-7.1.1_r31 ， 也就是对应的7.1.1 (N4F26U, Apr 2017)
首先是repo的配置过程
1、根目录下创建.bin文件夹
mkdir ~/.bin

2、配置为临时环境变量（也可配置为永久的）
PATH=~/.BIN:$PATH

3、下载repo

git clone https://gerrit-googlesource.lug.ustc.edu.cn/git-repo

4、将git-repo中的repo文件复制到步骤1中创建的.bin目录中

5、修改权限

chmod a+x ~/.bin/repo

6、创建同步源码的工作目录

mkdir android-e-7.1.1-r31

7、在工作目录中创建.repo目录

cd android-e-7.1.1-r31

mkdir .repo

8、将下载的git-repo拷贝到.repo下，并改名为repo

9、修改REPO_URL，(使用清华镜像)
在已加入系统环境变量的.bin文件夹中有一个repo文件，打开，将REPO_URL=后的内容进行修改，如下：

REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'

修改完成之后，初始化仓库：Android7.1.1版本：
repo init -u https://aosp.tuna.tsinghua.edu.cn/platform/manifest -b android-7.1.1_r31

注意1：后面的分支可以在这里查询：https://source.android.com/setup/start/build-numbers
这里选择的是：
N4F26U android-7.1.1_r31 Nougat Nexus 5X, Nexus 6P 2017-04-01
怎么查找合适的分支，以及对应的那款手机，可以参考
Platform Codenames, Versions, API Levels, and NDK Releases
https://source.android.com/setup/start/build-numbers

注意和下载的binary要一致

注意2：初始化需要usermail和username
git config --global user.email "you@example.com"
git config --global user.name "Your Name"

10 最后同步源码树
repo sync

经i过漫长的等待后，，，，，，，
下载后的大小：
总92G， 其中目录.repo有70G, 代码20G，.out文件637M

Step 2: 编译之前的准备

下载Nexus 5x的vendor文件，这步很重要，不然刷机后一直显示Google Logo，不会进入系统。

进行文件下载

https://source.android.com/source/requirements.html#binaries

对于运行带标记的 AOSP 版本分支的受支持设备，您可以从 Google 的 Nexus 驱动程序页面

https://developers.google.com/android/drivers

【在这里下载Nexus 5X binaries for Android 7.1.1 (N4F26U)，记住这个分支：bullhead牛头不对马嘴】

下载相关的官方二进制文件。有了这些二进制文件，您将有权使用采用非开放源代码的其他硬件功能。要编译 AOSP 的 master 分支，请使用 Nexus 设备的二进制文件预览。

https://developers.google.com/android/blobs-preview

在代码的根目录解压缩下载的文件将会得到一个sh的文件，通过终端 xxx.sh 运行
tar -xzvf ***.tar.gz

此处需要agree用户协议，你只需要按住向下键，就可以划到最后输入 I ACCEPT 就可以了。

sh运行完成之后会得到一个vendor文件夹，在源代码的根目录下。

为了确保新安装的二进制文件在解压后会被适当考虑在内，请使用以下命令删除所有以前编译操作的已有输出：

make clobber

Step 3: 编译环境的设置

1. CCache设置， 提高编译速度
   The suggested cache size is 50-100GB.
   下载代码后，使用预编译工具：
   prebuilts/misc/linux-x86/ccache/ccache -M 50G
2. Install JDK 1.8
   sudo apt-get install openjdk-8-jdk
   如果没有安装，编译时会报错，报错时亦可再安装。

Step 4： 开始编译

1. 设置环境

使用 envsetup.sh 脚本初始化环境。
source build/envsetup.sh

2. 选择目标

使用 lunch 选择要编译的目标
目标是nexus5x 的手机，所以选择的编译选项为aosp_bullhead-userdebug 【数字是21】

编译类型 使用情况
user 权限受限；适用于生产环境
userdebug 与“user”类似，但具有 root 权限和可调试性；是进行调试时的首选编译类型
eng 具有额外调试工具的开发配置

3. 编译代码

make -jN ， 其中N 是处理并行任务数，是硬件线程数的 1-2 倍之间
make -j4 其中N取决于CPU的核数。
经过漫长的等待后，，，，，，，，，，
期间要常观察，因为会不断有error打断。。。。。。。。。。。
编译成功的界面：

Step 5：开始刷机

1. 将nexus5 调至 fastboot模式
方法一： 能够adb链接的时候执行 adb reboot bootloader。
方法二： 关机状态下，同时按音量上下键。

在fastboot模式下，执行 fastboot oem unlock解锁bootloader，如果已经解锁，启动界面的google图标下有一把打开的锁。

2. fastboot
方式有很多，这里的操作可以为：
在./out/host/linux-x86/bin下运行./fastboot devices.

【先切换到su用户下，不然后面会有no devices, no permissions等错误】

【如果找不到设备，运行./fastboot devices，检查是否有连接的设备。】

执行./fastboot -w flashall写入。

之前会有这样的错误：error: neither -p product specified nor ANDROID_PRODUCT_OUT set，
解决方法：
export ANDROID_PRODUCT_OUT=your AOSP path /out/target/product/bullhead

再执行./fastboot -w flashall开始刷机.

运行界面如下：有个错误提示，不知道为什么？

系统信息如下:

Step 6：编译中的问题及解决办法

1. 硬盘空间不够
   挂接大硬盘：
   sudo fdisk -l 查看硬盘信息

   建个挂载点
   sudo mkdir /mnt/android-os
   sudo mount /dev/sdb1 /mnt/android-os

2. error: no java jdk fonud
   install openJDK 1.8: 上面有命令
3. 关于Bison错误
   /bin/bash: prebuilts/misc/linux-x86/bison/bison: No such file or directory
   [ 0% 5/48525] host Java: doclava (out/host/common/obj/JAVA_LIBRARIES/doclava_intermediates/classes)
   Note: Some input files use unchecked or unsafe operations.
   Note: Recompile with -Xlint:unchecked for details.
   ninja: build stopped: subcommand failed.
   build/core/ninja.mk:148: recipe for target 'ninja_wrapper' failed
   make: *** [ninja_wrapper] Error 1

make failed to build some targets (29 seconds)

解决方法：
sudo apt-get install bison
安装之后可能还会报错、/bin/bash: prebuilts/misc/linux-x86/bison/bison: No such file or directory 。原因可能是某些其他安装包没有安装
sudo apt-get install g++-multilib gcc-multilib lib32ncurses5-dev lib32readline-gplv2-dev lib32z1-dev
如果，就
sudo apt-get install g++-multilib gcc-multilib lib32ncurses5-dev lib32z1-dev

4. Java memory问题
   GC overhead limit exceeded.
   Try increasing heap size with java option '-Xmx<size>'.
   Warning: This may have produced partial or corrupted output.
   [ 30% 14610/48521] Compiling SDK Stubs with Jack: out/target/common/obj/JAVA_LIBRARIES/android_stubs_current_intermediates/classes.jack
   ninja: build stopped: subcommand failed.
   build/core/ninja.mk:148: recipe for target 'ninja_wrapper' failed
   make: *** [ninja_wrapper] Error 1

make failed to build some targets (01:35:41 (hh:mm:ss))

出现这个错误是由于电脑内存不足，在命令行分别执行以下三条语句，然后继续编译

export JACK_SERVER_VM_ARGUMENTS="-Dfile.encoding=UTF-8 -XX:+TieredCompilation -Xmx4g"
./prebuilts/sdk/tools/jack-admin kill-server
./prebuilts/sdk/tools/jack-admin start-server

5. /bin/bash: xmllint: command not found
   /bin/bash: xmllint: command not found
   [ 78% 26644/33913] target Package: Settings (out/target/product/bullhead/obj/APPS/Settings_intermediates/package.apk)
   nothing matches overlay file suw_navbar_ic_back.xml, for flavor anydpi-v21
   nothing matches overlay file suw_navbar_ic_more.xml, for flavor anydpi-v21
   nothing matches overlay file suw_navbar_ic_next.xml, for flavor anydpi-v21
   nothing matches overlay file suw_progress_bar.xml, for flavor v21
   ninja: build stopped: subcommand failed.
   build/core/ninja.mk:148: recipe for target 'ninja_wrapper' failed
   make: *** [ninja_wrapper] Error 1

make failed to build some targets (01:54:14 (hh:mm:ss))

解决方法:

安装xmllint : sudo apt-get install libxml2-utils