更新系统

1
sudo apt update && sudo apt upgrade

所做修改

• 修正找不到包的问题：git-core / libncurses5 / lib32ncurses5-dev 已不可用，替换为 git / libncurses6 / lib32ncurses-dev
• repo 同步工具：源里已有，不需手动设置 PATH。deb 系更新较慢，会报版本不是最新的警告，可忽略
• ccache：在 build/envsetup.sh 未定义或未手动启用时不会自动开启，参考类原生编译脚本带了它
• libssl-dev：解决编译内核时提示 <openssl/bio.h> 缺失的问题
• git-lfs：部分仓库需要用到，缺少可能导致同步的文件显示 LFS 指针而非本体文件

安装命令

1
sudo apt install git gnupg flex bison build-essential zip curl \
2
  zlib1g-dev libc6-dev-i386 libncurses6 lib32ncurses-dev \
3
  x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev \
4
  libxml2-utils xsltproc unzip fontconfig libssl-dev \
5
  openjdk-8-jdk repo ccache git-lfs libelf-dev rsync

创建源码目录

1
mkdir android && cd android

设置 Repo 下载地址

替换默认被墙的 Google 源，使用清华大学 git-repo 镜像：

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

初始化 Repo

以 AviumUI 为例，清单地址前加上 https://gh-proxy.com/ 使用国内加速，结尾 --depth=1 减少空间占用：

1
repo init -u https://gh-proxy.com/https://github.com/AviumUI/android_manifests \
2
  -b avium-16.2 --git-lfs --depth=1

如果是 AOSP 官方源码或 LineageOS 源码，可以使用国内镜像源，教程参考 清华源文档。

可用的源推荐清华源和中科大源，不同之处就是替换 URL 的问题。

示例

1
<remote name="aosp"
2
        fetch="https://mirrors.ustc.edu.cn/aosp" />
3

4
...
5

6
<remote name="avium"
7
        fetch="https://gh-proxy.com/https://github.com/AviumUI/"
8
        sync-c="true"
9
        sync-j="4"
10
        revision="refs/heads/avium-16" />

自动重试脚本

如果网络不稳定容易失败，可使用以下脚本自动重试直到同步成功或手动退出：

1
#!/bin/bash
2

3
echo "====== start repo sync ======"
4

5
# 执行 repo sync 命令
6
repo sync
7

8
# 使用 while 循环检查命令的退出状态
9
while [ $? -eq 1 ]; do
10
    echo "====== sync failed, re-sync again ======"
11
    sleep 3
12
    repo sync
13
done

使用方法：

1
# 保存为 repo_sync.sh
2
chmod +x repo_sync.sh
3
./repo_sync.sh

设备描述 (device)

以小米 Mix 3 为例，设备厂商为 xiaomi，代号为 perseus：

1. 打开 LineageOS 组织仓库，搜索 perseus
2. 找到代码仓库 android_device_xiaomi_perseus
3. 复制仓库链接，克隆到源码目录：

1
git clone https://github.com/LineageOS/android_device_xiaomi_perseus \
2
  device/xiaomi/perseus

4. 进入目录，打开 lineage.dependencies，查看需要获取的其他设备树文件
5. 按相同方式克隆，如 sdm845-common：

1
git clone https://github.com/LineageOS/android_device_xiaomi_sdm845-common \
2
  device/xiaomi/sdm845-common

内核 (Kernel)

从 lineage.dependencies 中查看，获取 kernel 源码。因为内核提交信息非常多，可加 --depth=1 减少下载量：

1
git clone https://github.com/duckyduckG/android_kernel_xiaomi_sdm845_419 \
2
  kernel/xiaomi/sdm845 --depth=1

ℹ️ 注意

如果你所使用的内核包含 KernelSU 且将 KernelSU 作为子模块，请务必在克隆内核后初始化 KernelSU：

1
git submodule init
2
git submodule update

厂商私有文件 (vendor)

LineageOS 组织没有 vendor 内容。翻阅 LineageOS Wiki 会要求从设备提取，但实际上 vendor 内容保存在 TheMuppets，其中包含了 LineageOS 维护的设备的 vendor 文件。

硬件特性 (hardware)

都在 LineageOS 仓库，具体参考 lineage.dependencies。以小米 Mix 3 为例，需要 android_hardware_xiaomi：

1
git clone https://github.com/LineageOS/android_hardware_xiaomi hardware/xiaomi

1. 确保使用 bash

1
# 如非 bash，请手动切换
2
bash

2. 加载编译环境

1
source build/envsetup.sh

3. 选择编译目标

1
lunch lineage_perseus-bp2a-user

参数说明：

• user：构建类型
• bp2a：代表 Android 16 初始版本 (QPR0)
• lineage_perseus：目标名称，定义在 device/xiaomi/perseus/lineage_perseus.mk

4. 开始编译

1
make bacon