waydroid模拟器使用

前言

一般而言要在电脑上运行 Android 引用,很多人的选择是虚拟机或模拟器。可是 Android 系统本身就是基于 Linux 系统开发的,所以我们应该是可以在 Linux 上运行一个完整的 Android 系统。我们借助 waydroid 可以允许我们在 Wayland 桌面环境上,通过容器化技术,完整的启动一个 Android 系统

环境准备

桌面环境是 Wayland

waydroid 依赖于 Wayland 桌面环境,使用 X11 的无法正常使用

1
echo $XDG_SESSION_TYPE

确保输出的内容是 Wayland

安装 waydroid

这里以 Ubuntu 为例,安装 waydroid 本体和相关依赖

1
sudo apt install waydroid

启动服务

在安装完成后可以启动 waydroid 容器服务

1
sudo waydroid container start

安装 Android 镜像

waydroid 会根据命令拉取是否带有 GApps 的系统镜像

1
2
waydroid init           # 不带 GApps 
waydroid init -s GAPPS # 带 GApps

waydroid 基础优化

waydroid 安装的 Android 系统是和宿主机的 CPU 架构是一样的。对于常规的 Android 应用,他们是运行再 arm 架构上所以我们要安装翻译层用来在 x86_64 上支持 arm

我们使用的是 waydroid_script 可以根据 github 上的指南进行操作

1
2
3
4
git clone https://github.com/casualsnek/waydroid_script
cd waydroid_script
python3 -m venv venv
venv/bin/pip install -r requirements.txt

系统依赖

waydroid_scirpt 脚本依赖系统的 lzip。没有该内容的可以通过系统包管理器进行安装

1
sudo apt install lzip

脚本运行

然后进入终端交互式界面

1
sudo venv/bin/python3 main.py

1. 选择安卓版本

新版本的 waydroid 的 Android 镜像一般是 Android 13(视自己的情况而定)

选择安卓版本

2.选择运行模式

我们选择里面的 Install 来安装我们需要的内容

选择运行模式

3. 选择要安装的组件

这里提供一些脚本作者的推荐的组件

选择要安装的组件

  • gapps: Google 全家桶与 Google 服务框架,提供 GMS 服务但是会提高占用,视需求安装
  • microg: 是 Google Play Services 的开源替代实现,更加轻量,但是可能存在兼容性问题
  • libndk: 提供 Android Native Development Kit 相关运行库。
  • libhoudini:这是 Intel 的 ARM 转译层。
  • magisk:Android Root 管理工具。
  • smartdock:用于桌面模式增强,修改 dock 栏等
  • fdroidpriv:这是 F-Droid 的特权扩展,配合 F-Droid 应用商店
  • widevine:Google 的 DRM 解密组件,播放受版权保护的视频

一般而言推荐安装 libndk,magisk,smartdock 三个组件。分别提供 arm 应用运行,root 管理和桌面的基础美化

一般而言,在 AMD 平台上,libndk 的性能似乎比 libhoudini 更好。而 libhoudini 适用于英特尔/AMD x86 CPU。但是不是绝对的,所以遇到兼容性问题可以两者均尝试

waydroid 使用

确保 waydroid-container.service 已经启动,然后 就可以执行

1
waydroid session start

来启动 waydroid 会话,下面给出一些 waydroid 交互命令

  • 启动 GUI
1
waydroid show-full-ui

waydroid GUI 启动界面

  • 启动 shell
1
waydroid shell
  • 安装程序

我们通过 adb 调试的方式进行安装。

首先我们要安装 adb

1
sudo apt install adb

然后 adb 连接 waydroid

我们首先要获取 waydroid 网络 ip 可以通过

1
waydroid status

waydroid status

发现 ip 为 192.168.240.112 然后 adb 连接其 5555 端口就可以

1
adb connect 192.168.240.112:5555

这里必须已经启动了 GUI 界面,因为连接时候会有弹窗要求我们进行确定。然后就可以安装应用了

1
adb install <package path>

waydroid模拟器使用
https://blog.556756.xyz/2026/05/09/linux/waydriod模拟器使用/
作者
Free
发布于
2026年5月9日
许可协议