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

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

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

sudo apt install git-lfs
git lfs install

# 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

nano ~/.bashrc

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

source ~/.bashrc

adb version

adb devices

which repo

nano /home/cyrus/bin/repo

#!/bin/bash

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

# 定义要添加的配置
config=$(cat <> ~/.gitconfig
    echo "URL替换已添加到 ~/.gitconfig"
fi


cat ~/.gitconfig 

#!/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

mkdir lineage-17.1

cd lineage-17.1

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

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)

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

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

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

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

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

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

mkdir -p /mnt/case_sensitive/ccache

cat >> ~/.bashrc <

执行下面命令使配置生效

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]