Ubuntu 16.04 LTS 下编译 LineageOS 源码

0x01 介绍

在 Ubuntu 16.04 下编译 LineageOS/CM 等 AOSP 源码可能会踩到很多坑。下面就跟我一起来配置避免入坑吧。Ubuntu 16.04 LTS 请选择 64 位的。

硬件设施最低要求

CPU: Core i3 530 及以上的 CPU（推荐 Intel Core i7 6 代以上或 AMD Ryzen 系列 CPU）
RAM: 8GB 及以上的 CPU（推荐 16GB 及以上）
HDD: HDD 120GB 及以上剩余存储空间（推荐 SSD 256GB 及以上）

当然 CPU 差点没事，只不过是浪费时间与电费而已。源码所在目录最低剩余空间不要小于 100GB。

操作系统

Ubuntu 16.04 64bit

0x02 安装依赖组件

主要组件：

sudo apt install -y bc bison build-essential curl flex gcc-multilib git git-core gnupg gperf g++-multilib libesd0-dev libgl1-mesa-dev liblz4-tool libncurses5-dev libreadline6-dev \
libsdl1.2-dev libwxgtk3.0-dev libxml2 libxml2-utils libx11-dev lib32ncurses5-dev lib32z1-dev lzop pngcrush schedtool squashfs-tools \
unzip xsltproc zip zlib1g-dev

额外组件，可能会使用到：

sudo apt install imagemagick libbz2-dev libssl-dev lzma ncftp bash-completion

0x03 安装 JDK

Open JDK 8 安装：

CM 14.1 及 LineageOS 14.1 以上，需要安装 JDK 8，直接安装即可，不要添加 PPA 源。

使用如下命令：

sudo apt install -y openjdk-8-jdk

CM 14 以下，需添加 JDK 7 的 PPA 源：

由于 Ubuntu 官方已经移除了对 Open JDK 7 的支持，所以要使用第三方的仓库。这真是大坑。

注：Android 7.1+ 已经支持 Open JDK 8，不要安装 Open JDK 7。

sudo apt install software-properties-common

sudo add-apt-repository ppa:openjdk-r/ppa 
sudo apt update
sudo apt install -y openjdk-7-jdk

注：第一条命令导入 PPA 时，按回车键继续导入即可。

安装完毕后不需要设置 JAVA 环境变量，是直接可以用的。

0x04 设置 repo

Google 可能无法下载。建议爬墙访问。PS：如果有 TZ 需要，可以找我哦（发邮件到 admin@htcp.net）。

mkdir -p ~/bin
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
echo "export PATH=~/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

关于清华的源：

无力吐槽清华源，老是出问题。当然您可以自己试试看使用这个，总有好的时候不是么 :)。

0x05 设置 git

1. 设置 git 用户名和邮箱
示例如下：
git config --global user.email "you@example.com"
git config --global user.name "Your Name"

双引号中的 “you@example.com” 填写您的 github 所使用的邮箱。注意格式，不要把双引号去掉。
双引号中的 “Your Name” 填写您的 github 用户名，不要把双引号去掉。

2. 生成 ssh 并添加到 github：

您可以参考官方的文档：

https://help.github.com/articles/connecting-to-github-with-ssh/

如果您不将 ssh 添加到 github 的话，您可能会遭遇下载受限，从而导致接下来的同步源码失败。

0x06 下载源码

注：千万不要使用中文路径！千万不要包含空格或一些特殊字符！不要将使用 Windows 的坏习惯带入到 Linux 中来！

6.1 新建源码目录：

（假如您想使用 Lineage 14.1，则可将 lineage-15.1 改为 cm-14.1）

mkdir -p ~/android/los/lineage-15.1

cd ~/android/los/lineage-15.1

6.2 初始化源码：

（假如想使用 Lineage 14.1，则将 lineage-15.1 改为 cm-14.1）

repo init -u https://github.com/LineageOS/android.git -b lineage-15.1

Enable color display in this user account (y/N)? y

6.3 正式同步源码：

<1> 使用如下命令：
在过程中可能会提示 clone 失败的信息，可以添加参数 --no-clone-bundle 到命令末尾。

repo sync -j4 -c --no-clone-bundle

由于国内环境不太好。网络比较差的同学，可以试试自动化 repo 同步脚本。

复制粘贴如下代码到终端中，回车将会保存为 repo.sh。注意将源码的路径改成您设置的源码路径。

cat > repo.sh <<EOF
#!/bin/bash
echo "======start repo sync======"
~/bin/repo sync -j4 -c --no-clone-bundle
while [ $? == 1 ]; do
echo "======sync failed, re-sync again======"
sleep 3
~/bin/repo sync -j4 --no-clone-bundle
done
EOF

假如您在服务器上编译，建议使用 screen 开启一个新的窗口，避免 ssh 掉线后导致同步终止。
假如 ssh 断掉，使用 screen -r 窗口名 即可恢复这个窗口。在 ssh 断掉的时候，这个窗口始终会保持程序的运行。具体的使用方法您可以使用 Google 搜索看一下文档。

安装 screen：

sudo apt install screen -y

开启窗口：

screen -S sync

<2> 然后执行这个脚本：

chmod a+x repo.sh
bash repo.sh

网速很慢的话（10M 带宽以下），估计要下 1 天左右。

当同步源码接近完毕后，会提示 Syncing work tree，直到同步完毕后会自动退出这个脚本。

0x07 编译源码

7.1 设置编译机型的 device tree、kernel 和私有文件。在这里以 shamu（Nexus 6）为例。其他机型请参照对应机型的相关设备源码来设置。

以下仅供参考，您需要根据设备的具体依赖自行修改：

（请将这里的 lineage-15.1 修改为您自己使用的源码目录）

mkdir ~/android/los/lineage-15.1/.repo/local_manifests
vim shamu.xml

<?xml version="1.0" encoding="UTF-8"?>
<manifest>
  <project name="LineageOS/android_device_moto_shamu" path="device/moto/shamu" remote="github" />
  <project name="LineageOS/android_kernel_moto_shamu" path="kernel/moto/shamu" remote="github" />
  <project name="TheMuppets/proprietary_vendor_motorola" path="vendor/motorola" remote="github" />
</manifest>

Lineage-14.1 可能要在 上面再加一行（Lineage15.1+ 不要这个，会冲突并报错）：

<project name="LineageOS/android_device_qcom_common" path="device/qcom/common" remote="github" />

7.2 再次 repo sync。

repo sync

7.3 设置 ccache 提高编译效率。

sudo apt install ccache -y

echo export USE_CCACHE=1 >> ~/.bashrc
prebuilts/misc/linux-x86/ccache/ccache -M 50G

7.4 解决 jack 内存不足导致编译失败的问题

7.4.1 允许 jack 使用更多的内存

echo 'export JACK_SERVER_VM_ARGUMENTS="-Dfile.encoding=UTF-8 -XX:+TieredCompilation -Xmx4096m"' >> ~/.bashrc
source ~/.bashrc

可以将这个添加进 ~/.bashrc 末尾最后一行中，然后 source 一下。否则每次打开终端时都要执行一次。

7.4.2 重启 jack：

./out/host/linux-x86/bin/jack-admin kill-server
./out/host/linux-x86/bin/jack-admin start-server

7.5 开启自带的 Root 权限

默认不带 Root，可通过输入如下命令开启（每次打开终端时执行一次，或者将这个加入到 ~/.bashrc 中并执行 source）：

export WITH_SU=true

7.6 设置编译变量

. ./build/envsetup.sh

7.7 开始编译

使用如下命令，会将编译过程中的所有屏幕输出保存至 build.log 文件中，方便排错。假如是其他设备，请修改对应的 brunch 机型。

croot
brunch lineage_clark-userdebug 2>&1 | tee build.log

假如只需要编译 recovery，则：

make recoveryimage -j8 2>&1 | tee build.log

提示：j 后面的是线程数，一般是 CPU 核心数的 2 倍。不要设置的太大，否则会适得其反并且炸内存。

0x08 编译完成

编译完成后，会在 源码目录/out/target/product/您的机型 文件夹生成对应的刷机包、镜像和一些编译出来的文件。

假如在编译过程中遇到报错，尝试 Google 对应的报错内容，不建议使用国内搜索引擎。

每次重新编译，可执行清理步骤：

make clean

然后重新执行 0x07 分段中的第 7.6 和 7.7 步。

0x09 其他

9.1 使用高通 LLVM（Lineage 15.1 没有试过）

貌似高通的 Snapdragon LLVM Compiler for Android 不错？被人安利了，但感觉没有什么区别？！另外，这个东西不支持 MacOS 操作系统。

9.1.1 您可以从此处下载（需要注册并登录高通账户才可下载）：

https://developer.qualcomm.com/software/snapdragon-llvm-compiler-android

9.1.2 解压下载的 snapdragon-llvm-3.8.*-linux64.tar.gz，然后再解压 Snapdragon-llvm-3.8.*-toolchain.tar.gz，您将会得到 toolchains 文件夹。

9.1.3 将 ./toolchains/llvm-Snapdragon_LLVM_for_Android_3.8/prebuilt 下的 linux-x86_64 文件夹复制到 prebuilts/clang/linux-x86/host 下，并重命名为 sdclang-3.8。

cp -rf toolchains/llvm-Snapdragon_LLVM_for_Android_3.8/prebuilt/linux-x86_64 ~/android/los/cm-14.1/prebuilts/clang/linux-x86/host/sdclang-3.8

9.1.4 在您的 源码目录/device/您的设备厂商/您的设备开发代号/BoardConfig.mk 中添加下面几行代码：

ifneq ($(HOST_OS),darwin)
SDCLANG := true
SDCLANG_PATH := prebuilts/clang/linux-x86/host/sdclang-3.8/bin
SDCLANG_LTO_DEFS := device/qcom/common/sdllvm-lto-defs.mk
endif

9.1.5 参照 0x07 重新编译试试看。

文章最后修订于：2018 年 02 月 02 日 02:00 CST。