LineageOS源码下载和编译（Xiaomi Mi 6X，wayne）
版权归作者所有，如有转发，请注明文章出处：https://cyrus-studio.github.io/blog/
源码下载
LineageOS官网：https://lineageos.org/
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。 1. 打开 /etc/fstab 文件
sudo nano /etc/fstab
2. 添加以下行 /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空间不够用如何扩容？
1. 卸载文件系统
sudo umount /mnt/case_sensitive
这一行命令卸载当前挂载的 case_sensitive.img 文件系统，以确保文件系统在扩展过程中不被使用。
2. 增加镜像文件的大小
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 文件。
3. 检查和修复文件系统
sudo e2fsck -f /mnt/e/case_sensitive.img
参数说明：
e2fsck 命令用于检查和修复 ext2/ext3/ext4 文件系统。
-f 选项强制进行文件系统检查，即使文件系统看起来是干净的。
4. 调整文件系统大小
sudo resize2fs /mnt/e/case_sensitive.img
resize2fs 命令用于调整 ext2/ext3/ext4 文件系统的大小以适应新的镜像文件大小。
5. 检查分区表 首先，需要使用 parted 来检查并调整分区表。
sudo parted /mnt/e/case_sensitive.img
在 parted 中执行以下命令
(parted) print
这将打印出当前的分区信息。然后，使用以下命令调整分区大小
(parted) resizepart 1 100%
退出 parted
(parted) quit
6. 重新挂载文件系统
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]