Waydroid
Waydroid 是一种基于容器的、能在常规的 Linux 系统上启动完整 Android 系统的方法。
CPU 要求取决于 CPU 架构。更多信息可参阅此表格。
可以使用 cat /proc/cpuinfo 检查是否具备所需的 CPU 指令集。
Waydroid 目前最适合在 Intel GPU 上使用(可开箱即用)。
已支持所有 AMD GPU;如果 Waydroid 不工作,您可能需要构建一个新的 Waydroid 映像(在 Radeon 680M 上正常工作),或者尝试以下有关 NVIDIA 的说明。
NVIDIA GPU 目前不被支持。有两种解决方法:
- 可能的话,切换到集成显卡
- 使用软件渲染(参见#软件渲染)
Waydroid 只在 Wayland 会话管理器中工作,因此请确保您处于 Wayland 会话中。
请注意,即使处于 X11 会话中,许多 Wayland 会话管理器也支持嵌套会话,因此可以在 X11 会话中运行 Waydroid(最简单的例子是 cage包)。
需要运行包含 binder 模块的内核,linux包、linux-lts包、linux-zen包 和 linux-lilyCNRepo均包含该模块。若您使用不同的内核,则可能需要重新编译或通过 DKMS 安装 。
安装 binder_linux-dkmsAUR 并使用 devices=binder,hwbinder,vndbinder 内核选项加载 binder_linux 内核模块(参见 bug 报告)。
# modprobe binder-linux devices=binder,hwbinder,vndbinder
此外,您也可以通过在 /etc/modules-load.d/ 和 /etc/modprobe.d/ 创建配置文件来让 binder_linux 在启动时被加载(这是可选的,参阅内核模块以获取更多信息)。
/etc/modules-load.d/binder_linux.conf
# Load binder_linux at boot binder_linux
/etc/modprobe.d/binder_linux.conf
# Options for binder_linux options binder_linux devices=binder,hwbinder,vndbinder
您还需要使用 ibt=off 内核参数来解决 5.18+ 版本内核上的一个问题,参阅 Segmentation fault when mounting /dev/binderfs
另外,可以用必要的选项重新编译 linux包 内核——或者其他内核版本 (>=5.7)。参见内核#编译。
当构建一个最小内核时,请遵循以下需求:
- IPv6 支持:若内核没有构建 IPV6,Waydroid 会没有 IPv4 连接。
- Netlink 套接字 (
CONFIG_NF_CT_NETLINK=y)。 - PSI (
CONFIG_PSI=y)。 - Loop block 设备 (
CONFIG_BLK_DEV_LOOP=m):loop模块必须在 Waydroid 启动前被加载。
当设置编译选项时,有两个选项:binder 和 binderfs。下面提供了有关这两者的说明。
模块既可以被编译到内核中 (y),也可以被编译到模块中 (m),或者不编译 (n) 。此外,配置中的选项不能任意组合,有些选项依赖于其他选项。
以下配置选项会将 binder 编译成模块,与此同时最后一个选项指定了在 binder 模块加载时,将在 /dev/ 目录下创建 3 个设备。
CONFIG_ANDROID=y CONFIG_ANDROID_BINDER_IPC=m CONFIG_ANDROID_BINDERFS=n CONFIG_ANDROID_BINDER_DEVICES="binder,hwbinder,vndbinder"
当从 AUR 构建内核时,可以按照以下步骤更新配置:
- 执行
makepkg --nobuild,将会下载源代码、验证并解压源代码包,然后执行prepare()函数。 - 编辑位于内核根目录下的
.config文件 (注意文件名里的点)。 - 在
prepare()函数尾部的命令很可能被用于从配置文件信息重新生成 Makefile (可能是make olddefconfig) 。将这条命令移动到build()函数里,或者单独执行。 - 执行
makepkg --noextract,将自动从makepkg --nobuild停下的位置继续执行。
已知 binder 内核模块会给部分用户造成一些问题。为了解决这些问题,binderfs 应运而生。编译内核时,必须要在新旧方式之间做出选择。使用以下选项,可以使用 binderfs 来替代 binder。
内核源代码也附带了用于设置配置选项的简单脚本。此脚本不会做依赖检查,就像手动编辑配置文件一样。当与 .config 处于相同目录时,可以执行以下命令:
$ scripts/config --enable CONFIG_ANDROID $ scripts/config --enable CONFIG_ANDROID_BINDER_IPC $ scripts/config --enable CONFIG_ANDROID_BINDERFS $ scripts/config --set-str CONFIG_ANDROID_BINDER_DEVICES ""
当从 AUR 构建内核时,将这几行插入到 PKGBUILD 中的合适位置即可 (通常在 prepare() 中) 。
确保已经安装 Waydroid 软件包的最新版本。Waydroid 将自动处理此问题。
可以选择通过 AUR 安装 waydroid-imageAUR 或 waydroid-image-gappsAUR 来提供所需的 Android 映像。然而,让 Waydroid 自己下载映像是更推荐的做法。
在初始化 Waydroid 之后,如果映像不可用,将会自动下载最新的 Android 映像(可能会耗时很久;你也可以自行下载之后将文件放到 /etc/waydroid-extra/images/[1])。
# waydroid init
初始化支持 GApps 的 Waydroid:
# waydroid init -s GAPPS
接下来启动/启用 waydroid-container.service。
# systemctl enable --now waydroid-container
Waydroid 现在应该能正常工作了。
确保 waydroid-container.service 已启动,然后执行:
$ waydroid session start
Waydroid 会话现在已处于活动状态,以下是一些与 Waydroid 交互的实用命令:
启动 GUI:
$ waydroid show-full-ui
启动 shell:
# waydroid shell
安装应用程序:
$ waydroid app install $path_to_apk
运行应用程序:
$ waydroid app launch $package-name
$package_name 是 list 命令所示的 packageName(包名)属性,并非 Name(应用名称)属性。获取应用程序列表:
$ waydroid app list
网络应该开箱即用,否则可能需要确保在执行 waydroid session start 之前,内核中已启用包转发并且允许以下规则通过防火墙:
以 ufw包 为例:
- 允许 DNS 流量:
# ufw allow 67
# ufw allow 53
- 允许包转发:
# ufw default allow FORWARD
对于 firewalld包, 可以使用这些命令:
- DNS:
# firewall-cmd --zone=trusted --add-port=67/udp
# firewall-cmd --zone=trusted --add-port=53/udp
- 包转发:
# firewall-cmd --zone=trusted --add-forward
/usr/lib/waydroid/data/scripts/waydroid-net.sh 文件中的 LXC_USE_NFT 设置为 false,否则会出现ip分配正确,但是流量发送出去但是转发不回来的现象。waydroid-container.service 前没有启用 TUN Proxy,避免导致错误的网络设置;在启动后可以启用。
- 将 waydroid 接口添加为可信:
# firewall-cmd --zone=trusted --add-interface=waydroid0
trusted 内。如果不是这样,请调整上述命令,或将 waydroid0 移动到 trusted。为了使重新启动时能保留更改,可能还需要执行以下命令:# firewall-cmd --runtime-to-permanent
Waydroid 默认全屏运行,若您想让 Waydroid 上的应用与您的桌面环境实现窗口整合(即应用拥有独立的窗口而不影响其他 Linux 应用窗口),请先启动 Waydroid 会话:
$ waydroid session start
然后设定所需属性:
$ waydroid prop set persist.waydroid.multi_windows true
重启会话:
$ waydroid session stop $ waydroid session start
现在应用可以在其独立的窗口中运行了。另请参阅Waydroid 官方文档。
确保您已经执行:
# waydroid init
(参阅#安装章节以获取更多信息)
接下来,向 waydroid.cfg 添加以下内容:
/var/lib/waydroid/waydroid.cfg
[properties] ro.hardware.gralloc=default ro.hardware.egl=swiftshader
然后执行以下命令以应用配置:
waydroid upgrade --offline
最后,重启 waydroid-container.service。
用以下命令将 Waydroid 窗口尺寸调整到您喜欢的大小:
$ waydroid prop set persist.waydroid.width 576 $ waydroid prop set persist.waydroid.height 1024
然后重启 waydroid-container.service。
如果您遇到了问题,可参见官方的问题跟踪:Waydroid 问题跟踪
Waydroid 正在快速发展中,因此如果您遇到问题,这里有一系列值得尝试的步骤:
- 确保 Waydroid 软件包处于最新。
- 通过执行以下命令,确保已安装最新的 Waydroid 映像:
# waydroid upgrade
- 重置 Waydroid:停止
waydroid-container.service,执行# waydroid init -f
并重新启动服务。 - 可能还需要做一下简单的清理,执行以下命令:
# rm -rf /var/lib/waydroid /home/.waydroid
$ rm -rf ~/waydroid ~/.share/waydroid ~/.local/share/applications/*aydroid* ~/.local/share/waydroid
- 提示:如果您是在 2021-09 后安装,那么您不必移除
/home/.waydroid/。
使用 casualsnek 的脚本安装翻译层。
为提高翻译性能,推荐在 AMD CPU 上使用 libndk,在英特尔 CPU 上使用 libhoudini。然而部分应用仅支持一种翻译层,因此当某个游戏不工作或性能极差时,您可能需要把两个翻译层都试一遍。
安装 libndk arm 翻译层
# python3 main.py install libndk
安装 libhoudini arm 翻译层
# python3 main.py install libhoudini
参见 [2]。
按 F11 可将当前应用切换到窗口模式。
安装 python-pyclipAUR 及其依赖(为 X11 安装 xclip包,为 Wayland 安装 wl-clipboard包)。
按左 Alt 键。
没有设置 apparmor 规则,在 /etc/apparmor.d/usr.sbin.dnsmasq 的末尾添加
#/etc/apparmor.d/usr.sbin.dnsmasq
@{run}/waydroid-lxc/ r,
@{run}/waydroid-lxc/* rw,
在基于 Arch 的发行版上,使用 lxc-attach 时可能会出现一个 "bug",可能会导致 waydroid shell 内的命令出现此问题,如 adbd 或 settings。
一个可能的解决方案是用
# lxc-attach -P /var/lib/waydroid/lxc/ -n waydroid --clear-env
替代 # waydroid shell 。
参见 Issue 136。
请注意 Waydroid 不在 Liquorix 内核上工作,因为其使用的某些调度器不兼容 PSI。
目前 Waydroid 需要与其窗口混成器运行在同一 GPU 上。有两种方法修复,一种是编辑 /var/lib/waydroid/lxc/waydroid/config_nodes,选择合适的 GPU,另一种是让窗口混成器切换 GPU。
根据 waydroid/issue/509,Waydroid 与 docker 存在 nftable 冲突。
欲修复,请关闭 LXC_USE_NFT:
/usr/lib/waydroid/data/scripts/waydroid-net.sh
LXC_USE_NFT="false"
或执行以下命令:
# systemctl stop docker # systemctl restart iptables # ip link delete docker0 # systemctl restart waydroid-container
参阅官方文档。 若您收到该错误,请进入 waydroid shell 并检索 Android ID:
# waydroid shell # ANDROID_RUNTIME_ROOT=/apex/com.android.runtime ANDROID_DATA=/data ANDROID_TZDATA_ROOT=/apex/com.android.tzdata ANDROID_I18N_ROOT=/apex/com.android.i18n sqlite3 /data/data/com.google.android.gsf/databases/gservices.db "select * from main where name = \"android_id\";"
之后将 ID 输入这个网站:https://www.google.com/android/uncertified 稍等几分钟后重启 Waydroid。
默认的安卓系统不包括中文输入法。在容器内部安装一个中文输入法即可。
可能是由于音频服务器死机,请参阅 Issue 576 和 Issue 829 以获取详细信息。
一种方法是运行:
# sysctl -w kernel.pid_max=65535
要使其持久化,请在 /etc/sysctl.d/ 创建一个 .conf 文件,并向其添加 kernel.pid_max=65535。
/etc/sysctl.d/99-sysctl.conf
kernel.pid_max=65535
根据 Issue 1060,添加以下内容可以通过 root 检测:
/var/lib/waydroid/waydroid.cfg
[properties] ro.product.brand=google ro.product.manufacturer=Google ro.system.build.product=redfin ro.product.name=redfin ro.product.device=redfin ro.product.model=Pixel 5 ro.system.build.flavor=redfin-user ro.build.fingerprint=google/redfin/redfin:11/RQ3A.211001.001/eng.electr.20230318.111310:user/release-keys ro.system.build.description=redfin-user 11 RQ3A.211001.001 eng.electr.20230318.111310 release-keys ro.bootimage.build.fingerprint=google/redfin/redfin:11/RQ3A.211001.001/eng.electr.20230318.111310:user/release-keys ro.build.display.id=google/redfin/redfin:11/RQ3A.211001.001/eng.electr.20230318.111310:user/release-keys ro.build.tags=release-keys ro.build.description=redfin-user 11 RQ3A.211001.001 eng.electr.20230318.111310 release-keys ro.vendor.build.fingerprint=google/redfin/redfin:11/RQ3A.211001.001/eng.electr.20230318.111310:user/release-keys ro.vendor.build.id=RQ3A.211001.001 ro.vendor.build.tags=release-keys ro.vendor.build.type=user ro.odm.build.tags=release-keys
然后使用以下命令以应用配置:
waydroid upgrade --offline