版权归作者所有，如有转发，请注明文章出处：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. 配置gitgit config --global user.email "you@example.com"
git config --global user.name "Your Name"
2. 安装 repomkdir ~/bin
PATH=~/bin:$PATH
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo
3. 安装 Git LFSsudo 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 < [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 仓库 fetch="https://github.com" /> 其中： 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 < # 使用缓存 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 确保 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 的空间而不影响现有数据。 4. 查看磁盘空间大小cyrus:/mnt/case_sensitive$ df -h /mnt/case_sensitive Filesystem Size Used Avail Use% Mounted on /dev/loop0 393G 212G 162G 57% /mnt/case_sensitive Size：总空间 Used：已用 Avail：剩余 Use%：使用率 解决编译提示内存不足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 /bin/bash -c "(ASAN_OPTIONS=detect_leaks=0 out/host/linux-x86/bin/checkpolicy -M -c 30 -o out/target/product/wayne/obj/ETC/sepolicy_neverallows_intermediates/sepolicy_neverallows.tmp out/target/product/wayne/obj/ETC/sepolicy_neverallows_intermediates/policy.conf ) && (out/host/linux-x86/bin/sepolicy-analyze out/target/product/wayne/obj/ETC/sepolicy_neverallows_intermediates/sepolicy_neverallows.tmp neverallow -w -f out/target/product/wayne/obj/ETC/sepolicy_neverallows_intermediates/policy_2.conf || ( echo \"\" 1>&2; echo \"sepolicy-analyze failed. This is most likely due to the use\" 1>&2; echo \"of an expanded attribute in a neverallow assertion. Please fix\" 1>&2; echo \"the policy.\" 1>&2; exit 1 ) ) && (touch out/target/product/wayne/obj/ETC/sepolicy_neverallows_intermediates/sepolicy_neverallows.tmp ) && (mv out/target/product/wayne/obj/ETC/sepolicy_neverallows_intermediates/sepolicy_neverallows.tmp 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：Recovery + Sideload 全流程实操指南 https://wiki.lineageos.org/devices/wayne/build/ [ROM][OTA][10.x] LineageOS 17.1 Unofficial [wayne/ Mi 6X]