LineageOS源码下载和编译（Xiaomi Mi 6X，wayne）

版权归作者所有，如有转发，请注明文章出处：https://cyrus-studio.github.io/blog/

源码下载

LineageOS源码 github 地址：https://github.com/LineageOS/android

LineageOS源码国内镜像地址：https://mirrors.tuna.tsinghua.edu.cn/help/lineageOS/

源码大概需要150GB的硬盘空间，编译完成差不多300G

1. 配置git

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

2. 安装 repo

mkdir ~/bin
PATH=~/bin:$PATH
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo

3. 安装 Git LFS

sudo apt install git-lfs
git lfs install

4. 安装 Android SDK Platform-Tools

在 Linux 中配置 Android SDK Platform-Tools，可以按照以下步骤进行

4.1 下载 Android SDK Platform-Tools：

# cd 到存放 platform-tools 的目录
cd /mnt/case_sensitive
# 下载 platform-tools
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
# 解压 platform-tools
unzip platform-tools-latest-linux.zip

4.2 配置环境变量：

为了在任何地方都能使用 adb 和 fastboot 命令，你需要将 platform-tools 目录添加到你的 PATH 中。

编辑 ~/.bashrc 文件

nano ~/.bashrc

在文件末尾添加以下行

export PATH=$PATH:/mnt/case_sensitive/platform-tools

然后重新加载 .bashrc 文件

source ~/.bashrc

4.3 验证配置

你可以通过以下命令检查 adb 是否配置成功

adb version

测试连接设备，确保你的 Android 设备已经通过 USB 连接，并且启用了开发者模式和 USB 调试。

adb devices

这将列出已连接的设备。

5. 镜像设置

找到 repo 所在路径

which repo

编辑 repo

nano /home/cyrus/bin/repo

可以看到repo会优先取环境变量中的REPO_URL，否则默认使用googlesource

Ctrl +X 退出nano

通过下面的脚本设置 REPO_URL 环境变量的值为清华大学镜像源，解决国内访问不了 googlesource 问题，并且修改 .gitconfig，把访问 LineageOS 仓库的 url 替换为使用清华大学镜像源。

add_mirrors.sh（设置镜像）

#!/bin/bash

export REPO_URL=https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/
echo "REPO_URL="$REPO_URL

# 定义要添加的配置
config=$(cat <<EOF
[url "https://mirrors.tuna.tsinghua.edu.cn/git/git-repo"]
    insteadof = https://gerrit.googlesource.com/git-repo
[url "https://mirrors.tuna.tsinghua.edu.cn/git/lineageOS/"]
    insteadof = https://review.lineageos.org/
[url "https://mirrors.tuna.tsinghua.edu.cn/git/AOSP/"]
    insteadof = https://android.googlesource.com/
[url "https://mirrors.tuna.tsinghua.edu.cn/git/lineageOS/LineageOS/"]
    insteadof = https://github.com/LineageOS/
EOF
)

# 检查配置是否已存在于 ~/.gitconfig
if grep -q "https://mirrors.tuna.tsinghua.edu.cn/git/git-repo" ~/.gitconfig; then
    echo "URL替换已经存在，未进行重复添加。"
else
    # 如果配置不存在，添加到 ~/.gitconfig
    echo "$config" >> ~/.gitconfig
    echo "URL替换已添加到 ~/.gitconfig"
fi


cat ~/.gitconfig

remove_mirrors.sh（移除镜像）

#!/bin/bash

unset REPO_URL
echo "REPO_URL="$REPO_URL

# 使用sed命令删除整个URL配置块，包括URL和相关的instedof行
sed -i '/\[url "https:\/\/mirrors\.tuna\.tsinghua\.edu\.cn\/git\/git-repo"\]/,+1d' ~/.gitconfig
sed -i '/\[url "https:\/\/mirrors\.tuna\.tsinghua\.edu\.cn\/git\/lineageOS\/"\]/,+1d' ~/.gitconfig
sed -i '/\[url "https:\/\/mirrors\.tuna\.tsinghua\.edu\.cn\/git\/AOSP"\]/,+1d' ~/.gitconfig
sed -i '/\[url "https:\/\/mirrors\.tuna\.tsinghua\.edu\.cn\/git\/lineageOS\/LineageOS"\]/,+1d' ~/.gitconfig

echo "URL替换已从 ~/.gitconfig 中移除"


cat ~/.gitconfig

给脚本文件增加执行权限

chmod +x add_mirrors.sh remove_mirrors.sh

设置使用镜像

./add_mirrors.sh

6. 下载源码

创建目录

mkdir lineage-17.1

进入到 lineageos 目录

cd lineage-17.1

如果可正常访问 github，使用下面的命令初始化 repo

repo init -u https://github.com/LineageOS/android.git -b lineage-17.1 --git-lfs --depth=1

否则，使用清华大学镜像初始化 repo，并修改 default.xml

repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/lineageOS/LineageOS/android.git -b lineage-17.1 --git-lfs --depth=1\

最后，同步源码

repo sync

或者使用下面命令下载浅克隆的源码

repo sync --no-clone-bundle --current-branch --no-tags -j$(nproc)

这会浅克隆当前分支最新的 LineageOS 源码，节省下载时间和空间。

7. 解决 webview 同步失败问题

error: Unable to fully sync the tree
error: Checking out local projects failed.
Failing repos:
external/chromium-webview/prebuilt/arm
external/chromium-webview/prebuilt/arm64
external/chromium-webview/prebuilt/x86
external/chromium-webview/prebuilt/x86_64
Try re-running with "-j1 --fail-fast" to exit at the first error.
================================================================================
Repo command failed due to the following `SyncError` errors:
Cannot initialize work tree for LineageOS/android_external_chromium-webview_prebuilt_arm
Cannot initialize work tree for LineageOS/android_external_chromium-webview_prebuilt_arm64
Cannot initialize work tree for LineageOS/android_external_chromium-webview_prebuilt_x86
Cannot initialize work tree for LineageOS/android_external_chromium-webview_prebuilt_x86_64

从镜像地址同步 weview 一直失败

删除 chromium-webview/prebuilt

rm -rf external/chromium-webview/prebuilt/*

执行 remove_mirrors.sh 移除镜像，开启代理，重新从 github 同步就可以了。

repo sync --no-clone-bundle --current-branch --no-tags -j$(nproc)

8. 手动添加设备仓库

在 .repo/local_manifests 创建 wayne.xml，手动添加 wayne（小米 6x）的设备配置仓库。

执行 nano .repo/local_manifests/wayne.xml 命令

mkdir .repo/local_manifests
nano .repo/local_manifests/wayne.xml

配置 Device tree、Common tree、Kernel、Vendor 仓库

<manifest>
<remote  name="real_github"
           fetch="https://github.com" />

<project name="LineageOS-MI-A2-MI-6X/android_device_xiaomi_wayne" path="device/xiaomi/wayne" remote="real_github" revision="lineageos-17.1"/>
<project name="LineageOS-MI-A2-MI-6X/android_device_xiaomi_sdm660-common" path="device/xiaomi/sdm660-common" remote="real_github" revision="lineageos-17.1"/>
<project name="LineageOS-MI-A2-MI-6X/android_kernel_xiaomi_sdm660" path="kernel/xiaomi/sdm660" remote="real_github" revision="master"/>
<project name="LineageOS-MI-A2-MI-6X/android_vendor_xiaomi_sdm660-common" path="vendor/xiaomi/sdm660-common" remote="real_github" revision="master"/>
<project name="LineageOS-MI-A2-MI-6X/android_vendor_xiaomi_wayne-common" path="vendor/xiaomi/wayne-common" remote="real_github" revision="master"/>
</manifest>

其中：

name="GitHub 用户名/仓库名称"
path 是存放代码的位置。

Kernel：内核是操作系统的核心，负责硬件与软件的交互。Android 内核是基于 Linux 内核开发的，负责管理设备的资源和硬件驱动。

Device Tree：设备树是一种硬件描述文件，用来告诉操作系统设备的硬件布局，避免内核代码与具体硬件的紧耦合。设备树通常位于 device/ 目录中，包含设备特定的配置。

Common Tree：通用树包含多个设备共享的通用代码和配置。例如，某些设备共享相同的硬件平台（如 sm7250），这些配置放在 Common Tree 中，避免重复代码。

Vendor Tree：Vendor Tree 包含特定设备或硬件供应商（如 Qualcomm、Xiaomi）提供的专有二进制驱动程序、库和其他软件组件。这些组件是设备能够正确运行的关键部分，特别是涉及专有硬件（如调制解调器、相机、GPU等）的功能。

Vendor Tree 通常包含在 vendor/ 目录中，是设备厂商提供的闭源组件。与 Kernel 和 Device Tree 不同，它涉及硬件相关的二进制文件和库，而不是内核或硬件描述。

完成后，运行 repo sync 同步源码

repo sync --no-clone-bundle --current-branch --no-tags -j$(nproc)

或者手动去 clone 一下

git clone https://github.com/LineageOS-MI-A2-MI-6X/android_device_xiaomi_wayne.git device/xiaomi/wayne
git clone https://github.com/LineageOS-MI-A2-MI-6X/android_device_xiaomi_sdm660-common.git device/xiaomi/sdm660-common
git clone https://github.com/LineageOS-MI-A2-MI-6X/android_kernel_xiaomi_sdm660.git kernel/xiaomi/sdm660
git clone https://github.com/LineageOS-MI-A2-MI-6X/android_vendor_xiaomi_sdm660-common.git vendor/xiaomi/sdm660-common
git clone https://github.com/LineageOS-MI-A2-MI-6X/android_vendor_xiaomi_wayne-common.git vendor/xiaomi/wayne-common

代理设置

由于在编译过程需要连接 github 下载设备树和内核，所以需要先设置一下代理。

关于Linux下代理设置可以参考这篇文章。

设置缓存

创建缓存目录

mkdir -p /mnt/case_sensitive/ccache

把缓存配置添加到环境变量配置文件.bashrc结尾

cat >> ~/.bashrc <<EOF
# 使用缓存
export USE_CCACHE=1
# ccache文件路径
export CCACHE_EXEC=/usr/bin/ccache
# 设置缓存目录
export CCACHE_DIR=/mnt/case_sensitive/ccache
EOF

执行下面命令使配置生效

source ~/.bashrc

设置最大缓存空间为 50GB

ccache -M 50G

启用 ccache 的压缩功能，可以减少缓存文件所占用的磁盘空间

ccache -o compression=true

源码编译

1. 初始化编译环境

# 初始化编译环境
source build/envsetup.sh

# 设置编译目标
# 如果本地没有设备仓库将会从LineageOS仓库中下载设备的Device tree和Kernel
breakfast wayne

2. 补充厂商文件

由于厂商文件是闭源的，而且版权原因不能直接放进去， Lineageos 没有直接提供厂商文件。

执行 breakfast 命令后如果提示缺少 vendor

In file included from build/make/core/config.mk:291:
In file included from build/make/core/envsetup.mk:266:
vendor/xiaomi/wayne-common/wayne-common-vendor.mk:782: error: _nic.PRODUCTS.[[device/xiaomi/wayne/lineage_wayne.mk]]: "vendor/xiaomi/wayne/wayne-vendor.mk" does not exist.
16:24:01 dumpvars failed with: exit status 1
In file included from build/make/core/config.mk:291:
In file included from build/make/core/envsetup.mk:266:
vendor/xiaomi/wayne-common/wayne-common-vendor.mk:782: error: _nic.PRODUCTS.[[device/xiaomi/wayne/lineage_wayne.mk]]: "vendor/xiaomi/wayne/wayne-vendor.mk" does not exist.
16:24:01 dumpvars failed with: exit status 1

根据错误提示可以通过以下2种方式之一补充对应的 vendor 文件

2.1 使用 TheMuppets 的厂商仓库

在 LineageOS 项目中，部分设备的厂商文件已经由社区维护，并保存在名为TheMuppets 的仓库中。

仓库地址：https://github.com/orgs/TheMuppets/repositories

把 vendor 仓库 clone 到本地

git clone https://github.com/TheMuppets/proprietary_vendor_xiaomi_sdm660-common.git vendor/xiaomi/sdm660-common

git clone https://github.com/TheMuppets/proprietary_vendor_xiaomi_wayne-common.git vendor/xiaomi/wayne-common

git clone https://github.com/TheMuppets/proprietary_vendor_xiaomi_wayne.git vendor/xiaomi/wayne

2.2 从设备中提取

注意：此步骤要求设备已经安装当前编译分支对应的 LineageOS。（可以先刷机再提取）

现在确保你的设备通过 USB 线连接到计算机，并启用 adb调试和 root，并且位于 device/xiaomi/wayne 目录下

在这个目录下，通常可以找到两个关键文件：

extract-files.sh: 用于从设备或固件中提取厂商文件的脚本。
proprietary-files.txt: 该文件列出了设备所需的所有厂商文件。

运行 extract-files.sh 脚本

./extract-files.sh

厂商驱动文件将会自动拉取到 vendor/xiaomi 文件夹中。

3. 开始编译

# 回到 Android 源码树的根目录
croot
# 开始编译
brunch wayne

解决WSL中编译提示文件系统不支持大小写敏感问题

21:38:08 ************************************************************
21:38:08 You are building on a case-insensitive filesystem.
21:38:08 Please move your source tree to a case-sensitive filesystem.
21:38:08 ************************************************************
21:38:08 Case-insensitive filesystems not supported

1. 创建一个区分大小写的文件系统

创建一个大小为300GB的ext4文件系统映像文件，并将其挂载到/mnt/case_sensitive，以提供一个区分大小写的文件系统

# 创建一个大小为300GB的空文件
dd if=/dev/zero of=/mnt/e/case_sensitive.img bs=1G count=300



# 将这个文件格式化为ext4文件系统
mkfs.ext4 /mnt/e/case_sensitive.img

# 创建一个新的挂载点目录
sudo mkdir /mnt/case_sensitive

# 将格式化后的文件挂载到新创建的挂载点
sudo mount /mnt/e/case_sensitive.img /mnt/case_sensitive

# 将你的LineageOS源码目录复制到新挂载的虚拟磁盘上
# -a: 归档模式，意味着递归复制目录，并且保留符号链接、权限、时间戳、拥有者等信息。
# -v: 显示详细信息。
# --progress: 显示文件传输进度。
sudo rsync -av --progress /mnt/e/android_source_code/lineageos/ /mnt/case_sensitive/lineageos/
# 或
# 将你的LineageOS源码目录移动到新挂载的虚拟磁盘上
sudo mv /mnt/e/android_source_code/lineageos /mnt/case_sensitive/

cd /mnt/case_sensitive/lineageos

为了确保 case_sensitive.img 在每次系统启动时自动挂载到 /mnt/case_sensitive。

打开 /etc/fstab 文件

sudo nano /etc/fstab
添加以下行

/mnt/e/case_sensitive.img /mnt/case_sensitive ext4 loop 0 0

2. 在windows下访问case_sensitive

\wsl.localhost\Ubuntu\mnt\case_sensitive\lineageos

确保 Windows 用户对该目录有足够的权限。你可能需要在 WSL 中设置一些权限

sudo chmod -R 777 /mnt/case_sensitive

这样，你应该可以在 Windows 中访问和使用 WSL 中的大小写敏感文件系统。

3. 如果case_sensitive.img空间不够用如何扩容？

卸载文件系统

sudo umount /mnt/case_sensitive

这一行命令卸载当前挂载的 case_sensitive.img 文件系统，以确保文件系统在扩展过程中不被使用。

增加镜像文件的大小

dd if=/dev/zero bs=1G count=100 >> /mnt/e/case_sensitive.img

参数说明：

dd 命令用于向 case_sensitive.img 文件追加 100GB 空间。
if=/dev/zero：表示输入文件是 /dev/zero，一个无限输出零字节的设备文件。
bs=1G：表示块大小为 1GB。
count=100：表示写入 100 个 1GB 的块。
>> /mnt/e/case_sensitive.img：表示将输出追加到现有的 case_sensitive.img 文件。

检查和修复文件系统

sudo e2fsck -f /mnt/e/case_sensitive.img

参数说明：

e2fsck 命令用于检查和修复 ext2/ext3/ext4 文件系统。
-f 选项强制进行文件系统检查，即使文件系统看起来是干净的。

调整文件系统大小

sudo resize2fs /mnt/e/case_sensitive.img

resize2fs 命令用于调整 ext2/ext3/ext4 文件系统的大小以适应新的镜像文件大小。

检查分区表

首先，需要使用 parted 来检查并调整分区表。

sudo parted /mnt/e/case_sensitive.img

在 parted 中执行以下命令

(parted) print

这将打印出当前的分区信息。然后，使用以下命令调整分区大小

(parted) resizepart 1 100%

退出 parted

(parted) quit

重新挂载文件系统

sudo mount /mnt/e/case_sensitive.img /mnt/case_sensitive

通过这些步骤，你可以扩展 case_sensitive.img 的空间而不影响现有数据。

解决编译提示内存不足

21:38:07 You are building on a machine with 7.62GB of RAM
21:38:07
21:38:07 The minimum required amount of free memory is around 16GB,
21:38:07 and even with that, some configurations may not work.
21:38:07
21:38:07 If you run into segfaults or other errors, try reducing your
21:38:07 -j value.
21:38:07 ************************************************************

创建虚拟内存

# 创建一个大小为8GB的文件，路径为/mnt/case_sensitive/swapfile。fallocate是一个快速创建大文件的工具。
sudo fallocate -l 8G /mnt/case_sensitive/swapfile

# 更改/swapfile的权限，使其只有所有者（root）有读写权限。这是为了安全，防止其他用户访问交换文件。
sudo chmod 600 /mnt/case_sensitive/swapfile

# 将/mnt/case_sensitive/swapfile初始化为交换空间。这个命令会设置文件系统标记，使操作系统知道这是一个交换文件。
sudo mkswap /mnt/case_sensitive/swapfile

# 启用/mnt/e/swapfile作为交换空间。这个命令会激活交换文件，使其可以被系统使用。
sudo swapon /mnt/case_sensitive/swapfile

# 查看交换空间的使用情况
swapon --show

如何内存还不够？

将虚拟内存大小从8G改为16G

# 关闭当前的交换文件
sudo swapoff /mnt/case_sensitive/swapfile

# 创建一个新的16G交换文件
sudo fallocate -l 16G /mnt/case_sensitive/swapfile

# 将交换文件的权限设置为600，以确保只有root用户可以读取和写入该文件。
sudo chmod 600 /mnt/case_sensitive/swapfile

# 将交换文件格式化为swap格式
sudo mkswap /mnt/case_sensitive/swapfile

# 启用新的交换文件
sudo swapon /mnt/case_sensitive/swapfile

# 使用 swapon --show 或 free -h 命令验证新的交换文件是否已正确启用。
swapon --show
# 或
free -h

为了确保 /mnt/case_sensitive/swapfile 在重启后仍然有效，将其添加到/etc/fstab文件中

echo '/mnt/case_sensitive/swapfile swap swap sw 0 0
' | sudo tee -a /etc/fstab

设置完成后再编译，如果真实物理内存没有超过16G，提示还会存在，但不影响正常编译。

WSL默认会设置最大可用内存为真实物理内存的50%，如果想修改WSL的最大可用内存可以通过修改.wslconfig 实现：

- [wsl2]

- memory=16GB

解决编译报错

**'duplicate entry for genfs entry *' at token 'genfscon'**

FAILED: out/target/product/wayne/obj/ETC/sepolicy_neverallows_intermediates/sepolicy_neverallows

device/xiaomi/sdm660-common/sepolicy/vendor/genfs_contexts:31:ERROR 'duplicate entry for genfs entry (sysfs, /devices/soc/800f000.qcom,spmi/spmi-0/spmi0-00/800f000.qcom,spmi:qcom,pm660@0:qcom,pm660_rtc/rtc)' at token 'genfscon' on line 85793:
# Touchscreen
genfscon proc /nvt_wake_gesture                                 u:object_r:proc_dt2w:s0
checkpolicy:  error(s) encountered while parsing configuration

在 sepolicy 配置文件中存在重复的 genfscon 条目。

路径 /devices/soc/800f000.qcom,spmi/spmi-0/spmi0-00/800f000.qcom,spmi:qcom,pm660@0:qcom,pm660_rtc/rtc 被定义了两次。

在 device/xiaomi/sdm660-common/sepolicy/vendor/genfs_contexts 文件中找到并移除重复定义的那一行。

清理缓存并重新编译

make clean
brunch wayne

编译完成

编译完成后可以在 out/target/product/wayne 目录下看到下面两个zip文件：

lineage-17.1-20240914-UNOFFICIAL-wayne.zip 是完整的 LineageOS ROM，通常用于全新安装或重刷设备。
lineage_wayne-ota-eng.cyrus.zip 是一个 OTA 更新包，可能用于增量更新现有的 LineageOS 安装，通常不用于首次刷机。

刷机

进入recovery，先格式化数据，再用 adb sideload 开始刷机

等待刷机完成，重启系统。

详细的刷机教程可以参考这篇文章【LineageOS刷机教程】。

参考：
https://wiki.lineageos.org/devices/wayne/build/
[ROM][OTA][10.x] LineageOS 17.1 Unofficial [wayne/ Mi 6X]