编译LineageOS模拟器镜像，导出到AndroidStudio
版权归作者所有，如有转发，请注明文章出处：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. 设置REPO_URL
找到 repo 所在路径
which repo
编辑 repo
nano /home/cyrus/bin/repo
可以看到repo会优先取环境变量中的REPO_URL，否则默认使用googlesource
Ctrl +X 退出nano
通过下面的命令设置 REPO_URL 环境变量，设置为清华大学镜像源，解决国内访问不了 googlesource 问题
export REPO_URL=https://mirrors.tuna.tsinghua.edu.cn/git/git-repo/
5. 下载源码
创建目录
mkdir lineageos
进入到 lineageos 目录
cd lineageos
如果可正常访问 github，使用下面的命令初始化 repo
repo init -u https://github.com/LineageOS/android.git -b lineage-21.0 --git-lfs
否则，使用清华大学镜像初始化 repo，并修改 default.xml
repo init -u https://mirrors.tuna.tsinghua.edu.cn/git/lineageOS/LineageOS/android.git -b lineage-21.0 --git-lfs
打开 .repo/manifests/default.xml，将
<remote name="github"
fetch=".."
review="review.lineageos.org" />
改成
<remote name="github"
fetch="https://github.com/" />
<remote name="lineage"
fetch="https://mirrors.tuna.tsinghua.edu.cn/git/lineageOS/"
review="review.lineageos.org" />
将
<remote name="aosp"
fetch="https://android.googlesource.com" >
改成
<remote name="aosp"
fetch="https://mirrors.tuna.tsinghua.edu.cn/git/AOSP">
将 remote=“github”
<default revision="..."
remote="github">
改成 remote=“lineage”
<default revision="..."
remote="lineage">
或者直接修改 .gitconfig，把访问 LineageOS 仓库的 url 替换为使用清华大学镜像源
cat >> ~/.gitconfig <<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
最后，同步源码
repo sync
6. 解决同步不完整问题
error: Unable to fully sync the tree
error: Checking out local projects failed.
Failing repos:
android
device/generic/goldfish
device/generic/mini-emulator-x86
external/ImageMagick
build/blueprint
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
Cannot initialize work tree for device/generic/goldfish
Cannot initialize work tree for device/generic/mini-emulator-x86
Cannot initialize work tree for LineageOS/android_external_ImageMagick
Cannot initialize work tree for platform/build/blueprint
尝试使用单线程同步，减少同步过程中的冲突。
repo sync -j1 --fail-fast
这会在第一个错误发生时终止同步，以便更容易定位和解决问题。
或者，清理工作树，手动删除有问题的项目并重新同步
rm -rf .repo/projects/device/generic/goldfish.git
rm -rf .repo/projects/device/generic/mini-emulator-x86.git
rm -rf .repo/projects/external/ImageMagick.git
rm -rf .repo/projects/build/blueprint.git
repo sync
设置缓存
创建缓存目录
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
开始编译
# 初始化编译环境
source build/envsetup.sh
# 设置构建目标
breakfast sdk_phone_x86_64 eng
# 开始编译
mka
breakfast 是 LineageOS 构建系统中的一个命令，用于设置构建环境。它会下载并配置设备相关的源代码和依赖项。
sdk_phone_x86_64 指目标设备的代码名称。在这个例子中，它代表一个用于 Android 模拟器的 x86_64 架构的虚拟手机设备。
具体参考：https://wiki.lineageos.org/emulator
在构建 LineageOS 时，eng 和 userdebug 是两种不同的构建类型，它们主要在调试功能和安全性方面有所区别
eng：
适用于开发者调试使用。
含有完全无优化的调试功能，允许广泛的日志记录、调试器连接和各种测试。
安全性较低，没有启用某些生产环境中的安全措施。
userdebug：
适用于调试接近生产环境的构建。
含有用户构建的所有功能，但保留了一些调试工具，安全性高于 eng 构建。
更加接近最终用户使用的环境，同时仍然允许调试。
总之，eng 更适合深入的开发调试，而 userdebug 适合在接近生产环境的条件下进行调试。
解决编译报错
__1. exit status 137 __
[ 55% 50817/91235] //packages/apps/HTMLViewer:HTMLViewer r8
Warning: The rule `-checkdiscard interface kotlin.coroutines.jvm.internal.DebugMetadata` matches a class not in the program.
18:03:04 ninja may be stuck, check /mnt/case_sensitive/lineageos/out/soong.log for list of running processes.
18:03:04 ninja may be stuck, check /mnt/case_sensitive/lineageos/out/soong.log for list of running processes.
18:03:04 ninja failed with: exit status 137
#### failed to build some targets (02:14:44 (hh:mm:ss)) ####
exit status 137 通常表示进程因内存不足被系统杀死。可以使用 htop 或 free -h 命令检查内存使用情况。 如果内存不足，可以尝试增加虚拟机的内存，或在本地机器上添加交换分区。
# 创建一个新的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
2. Read-only file system: ‘/home/*/.repo.gitconfig.json’_
这个错误表明在编译过程中尝试写入一个只读文件，报错如下
OSError: [Errno 30] Read-only file system: '/home/cyrus/.repo_.gitconfig.json'
\nWrite to a read-only file system detected. Possible fixes include
1\. Generate file directly to out/ which is ReadWrite, #recommend solution
2\. BUILD_BROKEN_SRC_DIR_RW_ALLOWLIST := <my/path/1> <my/path/2> #discouraged, subset of source tree will be RW
3\. BUILD_BROKEN_SRC_DIR_IS_WRITABLE := true #highly discouraged, entire source tree will be RW
19:26:39 ninja failed with: exit status 1
给 .repo_.gitconfig.json 文件添加写入权限，再重新编译
cyrus@cyrus-studio:/mnt/case_sensitive/lineageos$ chmod a+w ~/.repo_.gitconfig.json
cyrus@cyrus-studio:/mnt/case_sensitive/lineageos$ ls -alh /home/cyrus/.repo_.gitconfig.json
-rw-rw-rw- 1 cyrus cyrus 442 Aug 30 21:41 /home/cyrus/.repo_.gitconfig.json
发现还是不行，使用 nano 命令编辑 .repo_.gitconfig.json 随便修改一下保存，再编辑改回来，再重新编译，可以了。
nano /home/cyrus/.repo_.gitconfig.json
编译完成
启动模拟器
执行 emulator 命令启动模拟器
启动失败，报错如下
INFO | Storing crashdata in: /tmp/android-cyrus/emu-crash-34.2.7.db, detection is enabled for process: 1799459
INFO | Android emulator version 34.2.7.0 (build_id 11381971) (CL:N/A)
INFO | Storing crashdata in: /tmp/android-cyrus/emu-crash-34.2.7.db, detection is enabled for process: 1799459
INFO | Duplicate loglines will be removed, if you wish to see each individual line launch with the -log-nofilter flag.
INFO | Changing default hw.initialOrientation to portrait
ProbeKVM: This user doesn't have permissions to use KVM (/dev/kvm).
The KVM line in /etc/group is: [kvm:x:109:]
If the current user has KVM permissions,
the KVM line in /etc/group should end with ":" followed by your username.
If we see LINE_NOT_FOUND, the kvm group may need to be created along with permissions:
sudo groupadd -r kvm
# Then ensure /lib/udev/rules.d/50-udev-default.rules contains something like:
# KERNEL=="kvm", GROUP="kvm", MODE="0660"
# and then run:
sudo gpasswd -a $USER kvm
If we see kvm:... but no username at the end, running the following command may allow KVM access:
sudo gpasswd -a $USER kvm
You may need to log out and back in for changes to take effect.
ERROR | x86_64 emulation currently requires hardware acceleration!
CPU acceleration status: This user doesn't have permissions to use KVM (/dev/kvm).
The KVM line in /etc/group is: [kvm:x:109:]
If the current user has KVM permissions,
the KVM line in /etc/group should end with ":" followed by your username.
If we see LINE_NOT_FOUND, the kvm gr
More info on configuring VM acceleration on Linux:
https://developer.android.com/studio/run/emulator-acceleration#vm-linux
General information on acceleration: https://developer.android.com/studio/run/emulator-acceleration.
这个错误是因为 QEMU 启用硬件加速（ KVM）失败了。
确认 /dev/kvm 的权限是否正确。你可以通过以下命令检查
$ ls -l /dev/kvm
crw-rw---- 1 cyrus kvm 10, 232 Aug 31 21:01 /dev/kvm
输出应该类似于 crw-rw—- 1 YourUserName kvm 10, 232 date /dev/kvm，其中 kvm 是该设备的组。
如果权限设置不正确，你可以尝试以下命令修复
sudo apt install qemu-kvm
sudo adduser $USER kvm
sudo chown $USER:kvm /dev/kvm
sudo chmod 660 /dev/kvm
最后重新执行 emulator 启动模拟器
导出用于 Android Studio/AVD
将构建的镜像导出为 Android Studio/AVD 可使用的格式，通过以下命令
LineageOS 20 及以下版本
mka sdk_addon
构建完成后在 out/host/linux-x86/sdk_addon 目录，会生成一个 ZIP 文件（文件名以 -img.zip 结尾），其中包含在外部运行模拟器镜像所需的所有文件。
LineageOS 21 及以上版本
mka emu_img_zip
构建完成后在 out/target/product/ 目录，会生成一个 ZIP 文件 sdk-repo-linux-system-images.zip，其中包含在外部运行模拟器镜像所需的所有文件。
将 zip 文件解压到 android sdk 的 system-images 目录下，解压路径如下
system-images/android-<sdk version>/<tag>/<arch> （其中 <tag> 是 default/google_apis/google_apis_playstore 中的一个）
在 Android Studio 的【Device Manager】【Create Virtual Device】中创建虚拟设备并选择 LineageOS 镜像
最终在Android Studio下运行效果如下
