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

CYRUS STUDIO2024-09-18 14:29

版权归作者所有，如有转发，请注明文章出处：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 "[email protected]"
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 文件系统，以确保文件系统在扩展过程中不被使用。

  1. 增加镜像文件的大小

    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 文件。

  1. 检查和修复文件系统

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

参数说明：

  • e2fsck 命令用于检查和修复 ext2/ext3/ext4 文件系统。

  • -f 选项强制进行文件系统检查，即使文件系统看起来是干净的。

  1. 调整文件系统大小

    sudo resize2fs /mnt/e/case_sensitive.img

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

  1. 检查分区表

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

复制代码 
sudo parted /mnt/e/case_sensitive.img

在 parted 中执行以下命令

复制代码 
(parted) print

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

复制代码 
(parted) resizepart 1 100%

退出 parted

复制代码 
(parted) quit

  1. 重新挂载文件系统

    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]

相关推荐
二J1 小时前
管理100个小程序-很难吗
android·小程序
s11show_1631 小时前
hz修改后台新增keyword功能
android·java·前端
IT技术图谱2 小时前
【绝非标题党】网络监听新姿势：APT编译时注解实现高扩展框架
android·面试·架构
RichardLai882 小时前
[Flutter 基础] - Flutter基础组件 - Text
android·flutter
姜行运3 小时前
数据结构【树和二叉树】
android·数据结构·算法·c#
东风西巷3 小时前
Control Center安卓版：自定义控制中心，提升手机操作体验
android·智能手机·性能优化·软件需求
布拉德很帅3 小时前
Android如何通过aspectj打造一个无侵入式动态权限申请框架
android
CYRUS_STUDIO4 小时前
Android 加壳应用运行流程 与 生命周期类处理方案
android·安全·逆向
隐-梵4 小时前
Android studio进阶开发（四）--okhttp的网络通信的使用
android·ide·okhttp·android studio
_一条咸鱼_4 小时前
Android大厂面试通关秘籍
android·面试·android jetpack
热门推荐
01KGG转MP3工具|非KGM文件|解密音频02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03我决定放弃搞 Java 了04✨分享我在飞书多维表格中使用DeepSeek的经历✨05YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】06苍穹外卖面试总结07Coze扣子平台完整体验和实践（附国内和国际版对比）08yolov8，yolo11，yolo12 服务器训练到部署全流程 笔记09DeepSeek各版本说明与优缺点分析10如何在WPS和Word/Excel中直接使用DeepSeek功能