Waydroid 是一种基于容器的、能在常规的 Linux 系统上启动完整 Android 系统的方法。
准备工作
CPU 要求
CPU 要求取决于 CPU 架构。更多信息可参阅此表格。
可以使用 cat /proc/cpuinfo
检查是否具备所需的 CPU 指令集。
GPU 要求
Waydroid 目前最适合在 Intel GPU 上使用(可开箱即用)。
已支持所有 AMD GPU;如果 Waydroid 不工作,您可能需要构建一个新的 Waydroid 映像(在 Radeon 680M 上正常工作),或者尝试以下有关 NVIDIA 的说明。
NVIDIA GPU 目前不被支持。有两种解决方法:
- 可能的话,切换到集成显卡
- 使用软件渲染(参见#软件渲染)
Wayland 会话管理器
Waydroid 只在 Wayland 会话管理器中工作,因此请确保您处于 Wayland 会话中。
请注意,即使处于 X11 会话中,许多 Wayland 会话管理器也支持嵌套会话,因此可以在 X11 会话中运行 Waydroid(最简单的例子是 cage包)。
内核模块
需要运行包含 binder 模块的内核,linux包、linux-lts包、linux-zen包 和 linux-lilyCNRepo均包含该模块。若您使用不同的内核,则可能需要重新编译或通过 DKMS 安装 。
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。下面提供了有关这两者的说明。
使用 binder
模块既可以被编译到内核中 (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
停下的位置继续执行。
使用 binderfs
已知 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()
中) 。
设置 binder 设备
确保已经安装 Waydroid 软件包的最新版本。Waydroid 将自动处理此问题。
安装
可以选择通过 AUR 安装 waydroid-imageAUR 或 waydroid-image-gappsAUR 来提供所需的 Android 映像。然而,让 Waydroid 自己下载映像是更推荐的做法。
在初始化 Waydroid 之后,如果映像不可用,将会自动下载最新的 Android 映像(可能会耗时很久;你也可以自行下载之后将文件放到 /usr/share/waydroid-extra/images/
)。
# 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/
。
不兼容 ARM 应用
使用 casualsnek 的脚本安装翻译层。
为提高翻译性能,推荐在 AMD CPU 上使用 libndk,在英特尔 CPU 上使用 libhoudini。然而部分应用仅支持一种翻译层,因此当某个游戏不工作或性能极差时,您可能需要把两个翻译层都试一遍。
安装 libndk arm 翻译层
# python3 main.py install libndk
安装 libhoudini arm 翻译层
# python3 main.py install libhoudini
旋转的应用程序无法使用
参见 [1]。
按 F11 可将当前应用切换到窗口模式。
无法启动剪贴板管理服务
安装 python-pyclipAUR 及其依赖(为 X11 安装 xclip包,为 Wayland 安装 wl-clipboard包)。
无法使用物理键盘
按左 Alt 键。
dnsmasq: failed to open pidfile /run/waydroid-lxc/dnsmasq.pid: Permission denied
没有设置 apparmor 规则,在 /etc/apparmor.d/usr.sbin.dnsmasq
的末尾添加
#/etc/apparmor.d/usr.sbin.dnsmasq @{run}/waydroid-lxc/ r, @{run}/waydroid-lxc/* rw,
Waydroid shell 中的命令输出无法访问或命令未找到
在基于 Arch 的发行版上,使用 lxc-attach 时可能会出现一个 "bug",可能会导致 waydroid shell
内的命令出现此问题,如 adbd
或 settings
。
一个可能的解决方案是用
# lxc-attach -P /var/lib/waydroid/lxc/ -n waydroid --clear-env
替代 # waydroid shell
。
WARNING: Service manager /dev/binder has died
参见 Issue 136。
请注意 Waydroid 不在 Liquorix 内核上工作,因为其使用的某些调度器不兼容 PSI。
多 GPU 系统上图形损坏
目前 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
该设备未通过 Play Protect 认证
参阅官方文档。 若您收到该错误,请进入 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。
无法输入中文
默认的安卓系统不包括中文输入法。在容器内部安装一个中文输入法即可。
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
应用程序需要未 root 的设备
根据 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