6x's blog

手持两把锟斤拷，口中疾呼烫烫烫!

0%

给 Xiaomi 6 编译 LineageOS 过程小记

发表于 更新于 分类于 阅读次数： 253

最近给手头的 Xiaomi 6 刷了 LneageOS, 体验了一把 Android 13, 挺香的! 但是这个系统有那么一丢丢 BUG, 于是决定自己来改改.

环境描述

硬件要求

  • CPU >= 4C
  • MEM >= 16G
  • DISK >= 200G
  • NET >= 100M

软件描述

  • Debian 11.7

环境准备

安装 repo 工具

下载&安装:

1
2
3
mkdir -p ~/bin/
curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
chmod a+x ~/bin/repo

若无法下载可镜像下载: curl https://mirrors.tuna.tsinghua.edu.cn/git/git-repo > ~/bin/repo

更新环境变量:

1
2
3
4
5
6
7
8
9
10
11
12
cat >> ~/.profile <<EOF
# set PATH so it includes user's private bin if it exists
if [ -d "$HOME/bin" ] ; then
    PATH="$HOME/bin:$PATH"
fi
EOF
source ~/.profile

cat >> ~/.bashrc <<EOF
export REPO_URL='https://mirrors.tuna.tsinghua.edu.cn/git/git-repo'
EOF
source ~/.bashrc

安装 platform-tools 工具

下载&安装:

1
2
wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
unzip platform-tools-latest-linux.zip

更新环境变量:

1
2
3
4
5
6
7
cat >> ~/.profile <<EOF
# add Android SDK platform tools to path
if [ -d "$HOME/platform-tools" ] ; then
    PATH="$HOME/platform-tools:$PATH"
fi
EOF
source ~/.profile

安装必要软件

1
2
3
4
5
6
7
sudo apt install python3 \
bc bison build-essential ccache curl flex g++-multilib gcc-multilib git git-lfs gnupg gperf imagemagick \
lib32ncurses5-dev lib32readline-dev lib32z1-dev libelf-dev liblz4-tool libncurses5 libncurses5-dev \
libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync \
schedtool squashfs-tools xsltproc \
zip zlib1g-dev
sudo ln -s /bin/python3 /bin/python

软件列表请参考: https://wiki.lineageos.org/devices/sagit/build#install-the-build-packages

配置 git 用户信息

配置基本信息:

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

指定 LineageOS 仓库镜像(清华大学镜像源):

1
2
3
4
5
6
7
8
9
cat >> ~/.gitconfig <<EOF

[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

配置 ccache 软件

1
2
3
4
5
6
7
8
9
cat >> ~/.bashrc <<EOF
export USE_CCACHE=1
export CCACHE_EXEC=/usr/bin/ccache
EOF

ccache -M 50G
ccache -o compression=true

mkdir -p ~/.cache/ccache/

同步代码

1
2
3
4
mkdir ~/android/lineage
cd ~/android/lineage
repo init -u https://github.com/LineageOS/android.git -b lineage-20.0 --git-lfs
repo sync -c -d -j16

编译

初始化编译环境

1
2
source build/envsetup.sh
breakfast sagit

这个环节会根据设备型号拉取对应的内核仓库, 建议使用镜像仓库加速.

对于 Xiaomi 6, 这个环节第一次会失败, 请参考踩坑记录.

导入厂商二进制文件

厂商代码是不开源的, 需要引用现有的二进制; 可以从设备提取, 也可以从现有的 ROM 包里面提取, 二选一即可.

  • 从设备提取
1
2
cd ~/android/lineage/device/xiaomi/sagit/
sudo ./extract-files.sh

这个环节需要开启 Xiaomi 6 设备的 开发者选项的调试模式 , 并连接至编译主机. 然后执行上述命令.

  • 从现有 ROM 包里面提取
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
mkdir ~/android/system_dump/
cd ~/android/system_dump/

unzip path/to/lineage-*.zip system.transfer.list system.new.dat*
unzip path/to/lineage-*.zip vendor.transfer.list vendor.new.dat*

sudo apt-get install brotli
brotli --decompress --output=system.new.dat system.new.dat.br
brotli --decompress --output=vendor.new.dat vendor.new.dat.br

git clone https://github.com/xpirt/sdat2img
python sdat2img/sdat2img.py system.transfer.list system.new.dat system.img
python sdat2img/sdat2img.py vendor.transfer.list vendor.new.dat vendor.img

mkdir system/
sudo mount system.img system/
# sudo rm -rf system/vendor
# sudo mkdir system/vendor
sudo mount vendor.img system/vendor/

cd ~/android/lineage/device/xiaomi/sagit/
sudo ./extract-files.sh ~/android/system_dump/

sudo umount ~/android/system_dump/system/vendor
sudo umount ~/android/system_dump/system
# rm -rf ~/android/system_dump/

启动编译

1
2
croot
brunch sagit

踩坑记录

git lfs 同步失败

错误示例

1
2
3
4
5
6
7
8
9
10
11
12
Downloading webview.apk (91 MB)
Error downloading object: webview.apk (e35a2a1): Smudge error: Error downloading webview.apk (e35a2a15f6dd1055ba3320f280849474eafc73d56ee26cecb7a3273ffbaa24c2): batch response: Repository or object not found: https://mirrors.tuna.tsinghua.edu.cn/git/lineageOS/LineageOS/android_external_chromium-webview_prebuilt_arm.git/info/lfs/objects/batch
Check that it exists and that you have proper access to it

Errors logged to /home/liux/android/lineage/.repo/projects/external/chromium-webview/prebuilt/arm.git/lfs/logs/20230510T215212.15094947.log
Use `git lfs logs last` to view the log.
error: 外部过滤器 'git-lfs filter-process' 失败
fatal: webview.apk：smudge 过滤器 lfs 失败
error.GitError: Cannot checkout LineageOS/android_external_chromium-webview_prebuilt_arm: Cannot initialize work tree for LineageOS/android_external_chromium-webview_prebuilt_arm
error: Cannot checkout LineageOS/android_external_chromium-webview_prebuilt_arm
正在更新文件: 100% (2237/2237), 完成.
正在更新文件: 100% (3547/3547), 完成.
1
2
3
4
5
6
7
error: 工作区中下列未跟踪的文件将会因为检出操作而被覆盖：
	.gitattributes
	.lfsconfig
请在切换分支前移动或删除。
正在终止
error: external/chromium-webview/prebuilt/arm64/: LineageOS/android_external_chromium-webview_prebuilt_arm64 checkout ed88096ab28a21d2fb785899532194b3a67438f1 
error: Cannot checkout LineageOS/android_external_chromium-webview_prebuilt_arm64
1
2
3
4
5
6
7
8
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.

由于上面拉取代码是配置了镜像仓库的, 但是镜像仓库中 git lfs 的部分文件不全, 导致同步失败.

解决办法

取消 https://review.lineageos.org/ 镜像配置, 删除出错的源码目录重新同步. 使用国外服务器建议错峰访问, 晚上比白天慢很多.

1
2
3
4
5
6
rm -rf \
external/chromium-webview/prebuilt/arm \
external/chromium-webview/prebuilt/arm64 \
external/chromium-webview/prebuilt/x86 \
external/chromium-webview/prebuilt/x86_64
repo sync -c -d -j16 --fail-fast

偶现无法解析主机名

错误示例

1
略

解决办法

  • 避免使用过多的线程, 宽带带宽不够的情况下某些线程抢不到资源, 导致连接失败;
  • 检查网络连接质量, 必要时可以考虑科学上网; 
    1
    2
    3
    4
    5
    6
    7
    8
    9
    # http
    git config --global http.proxy http://127.0.0.1:1080 
    git config --global https.proxy https://127.0.0.1:1080
    # socks
    git config --global http.proxy 'socks5://127.0.0.1:1080' 
    git config --global https.proxy 'socks5://127.0.0.1:1080'
    # cancel
    git config --global --unset http.proxy
    git config --global --unset https.proxy

breakfast 报错没有找到文件

错误示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
In file included from build/make/core/config.mk:353:
In file included from build/make/core/envsetup.mk:352:
In file included from build/make/target/product/telephony_vendor.mk:21:
device/xiaomi/sagit/device.mk:54: error:  vendor/xiaomi/sagit/sagit-vendor.mk does not exist..
09:32:24 dumpvars failed with: exit status 1
Device sagit not found. Attempting to retrieve device repository from LineageOS Github (http://github.com/LineageOS).
Found repository: android_device_xiaomi_sagit
Default revision: lineage-20.0
Checking branch info
Using fallback branch: lineage-20
Checking if device/xiaomi/sagit is fetched from android_device_xiaomi_sagit
LineageOS/android_device_xiaomi_sagit already fetched to device/xiaomi/sagit
Syncing repository to retrieve project.
Fetching: 100% (1/1), done in 1.015s
repo sync has finished successfully.
Repository synced!
Looking for dependencies in device/xiaomi/sagit
Looking for dependencies in device/xiaomi/msm8998-common
Looking for dependencies in hardware/xiaomi
hardware/xiaomi has no additional dependencies.
Looking for dependencies in kernel/xiaomi/msm8998
kernel/xiaomi/msm8998 has no additional dependencies.
Done
In file included from build/make/core/config.mk:353:
In file included from build/make/core/envsetup.mk:352:
In file included from build/make/target/product/telephony_vendor.mk:21:
device/xiaomi/sagit/device.mk:54: error:  vendor/xiaomi/sagit/sagit-vendor.mk does not exist..
09:32:29 dumpvars failed with: exit status 1
In file included from build/make/core/config.mk:353:
In file included from build/make/core/envsetup.mk:352:
In file included from build/make/target/product/telephony_vendor.mk:21:
device/xiaomi/sagit/device.mk:54: error:  vendor/xiaomi/sagit/sagit-vendor.mk does not exist..
09:32:30 dumpvars failed with: exit status 1

** Don't have a product spec for: 'lineage_sagit'
** Do you have the right repo manifest?

解决办法

IMPORTANT: Some devices require a vendor directory to be populated before breakfast will succeed. If you receive an error here about vendor makefiles, jump down to Extract proprietary blobs. The first portion of breakfast should have succeeded, and after completing you can rerun breakfast

某些设备需要填充供应商目录，然后才能成功 breakfast。需要先执行 导入厂商二进制文件 步骤然后再 breakfast。

执行 extract-files.sh 找不到文件

错误示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Extracting 505 files in ./../../xiaomi/msm8998-common/proprietary-files.txt from /tmp/tmp.JtDCH6RDpg/system_dump:
  - etc/cne/Nexus/ATT/ATT_profiles.xml
    + keeping pinned file with hash 33e568627fd3f94dc45bca1c01ad10e6d8fb5b52
  - etc/cne/Nexus/ROW/ROW_profiles.xml
    + keeping pinned file with hash 238e785e9674b27c4b2365958d127533d7293132
  - etc/cne/Nexus/VZW/VZW_profiles.xml
    + keeping pinned file with hash 0f63b632e3a3f114def7aeadaabd13851c8ceec5
  - system_ext/etc/permissions/qti_libpermissions.xml
    !! system_ext/etc/permissions/qti_libpermissions.xml: file not found in source
  - system_ext/etc/permissions/qti_permissions.xml
    !! system_ext/etc/permissions/qti_permissions.xml: file not found in source
  - vendor/lib64/com.qualcomm.qti.imscmservice@2.0.so
    !! vendor/lib64/com.qualcomm.qti.imscmservice@2.0.so: file not found in source
  - vendor/lib64/com.qualcomm.qti.imscmservice@2.1.so
    !! vendor/lib64/com.qualcomm.qti.imscmservice@2.1.so: file not found in source
  - vendor/lib64/com.qualcomm.qti.uceservice@2.0.so
    !! vendor/lib64/com.qualcomm.qti.uceservice@2.0.so: file not found in source
  - system_ext/lib64/lib-imscamera.so
    !! system_ext/lib64/lib-imscamera.so: file not found in source

解决方法

需要使用 root 权限执行.

参考

  • 本文作者： 6x
  • 本文链接： https://6xyun.cn/article/169
  • 版权声明： 本博客所有文章除特别声明外，均采用 BY-NC-ND 许可协议。转载请注明出处！