🐧 ArchLinux安装Waydroid 安卓子系统 🤖

Waydroid是一款基于Wayland显示服务器的Android模拟器，Waydroid与系统的深度集成，实现更流畅的运行体验和更低的资源占用，尤其适合Linux桌面用户运行Android应用。本教程将以Arch系列发行版为例，详细讲解Waydroid的完整安装流程。

📋 一、安装前期准备

在安装Waydroid前需确保系统满足基础运行条件，避免因环境缺失导致安装失败。

🔍 1.1 检查系统环境

🖥️ 显示服务器：Waydroid依赖Wayland显示服务器，需先确认系统当前使用的是Wayland而非X11。可通过在终端执行命令 echo $XDG_SESSION_TYPE 验证，输出“wayland”即为符合要求；若输出“x11”，需在系统登录界面点击用户名旁的设置图标，选择对应Wayland选项（如“Plasma (Wayland)”等，依桌面环境而定）重新登录。
⚙️ 内核要求：需要运行包含 binder 模块的内核，Arch官方仓库中的linux包、linux-lts包、linux-zen包和linux-lilyCNRepo均包含该模块，可直接使用。如果使用不同的内核，则可能需要重新编译或通过 DKMS 安装。
💻 硬件支持：确保CPU支持虚拟化技术（Intel VT-x/AMD-V），可在BIOS/UEFI中开启该功能，以提升Waydroid运行性能。

🔄 1.2 更新系统软件源

安装前先更新系统软件包列表，确保依赖库为最新版本，减少兼容性问题。

sudo pacman -Syu

📥 二、安装Waydroid

目前Waydroid的安装方式主要有官方软件源安装和脚本安装两种，官方源安装更稳定，脚本安装可获取最新版本，建议新手优先选择官方源安装。以下为Arch系列的具体安装方式。

✅ 2.1 官方软件源安装（推荐）

Arch官方仓库包含Waydroid，直接执行以下命令即可安装：

yay -S waydroid

⚡ 三、初始化Waydroid

安装完成后，需进行初始化配置，下载Android系统镜像并完成基础设置，才能正常运行应用。

📥 3.1 初始化系统镜像

Waydroid需要Android系统镜像才能运行，目前支持两种初始化方式，第一次启动时推荐使用可视化界面，操作更直观：

🌟 3.1.1 可视化界面初始化（第一次启动推荐）

安装完成后，无需直接执行命令，在系统应用菜单中找到并启动“Waydroid”，会自动弹出可视化初始化界面。界面中可直接选择需要的镜像类型：

🔵 含Google服务（GAPPS）：适合需要运行依赖Google服务的应用（如部分游戏、社交类APP），对应命令行的-s GAPPS参数。
🟢 纯LineageOS镜像：无Google服务，体积更小、隐私性更强，对应命令行的-s lineage参数。

选择完成后，点击确认即可自动下载对应镜像并完成初始化，整个过程无需手动干预，下载完成后会提示初始化成功。

💻 3.1.2 命令行初始化（适配批量操作或无界面场景）

若需通过终端操作或批量部署，执行以下命令手动下载并初始化镜像：

sudo waydroid init -s GAPPS -f

命令参数说明：

-s GAPPS：指定下载包含Google服务框架（GMS）的镜像；若不需要Google服务，可替换为 -s lineage 下载纯LineageOS镜像。
-f：强制覆盖已有的镜像文件（若之前初始化失败，或需更换镜像类型时添加此参数）。
-s GAPPS：指定下载包含Google服务框架（GMS）的镜像，支持运行依赖Google服务的应用；若不需要Google服务，可替换为 -s lineage 下载纯LineageOS镜像。
-f：强制覆盖已有的镜像文件（若之前初始化失败，可添加此参数重新初始化）。

🚀 3.2 启动Waydroid服务

初始化完成后，启动Waydroid服务：

sudo systemctl start waydroid-container

若想设置开机自动启动服务，执行以下命令：

sudo systemctl enable waydroid-container

🖱️ 3.3 启动Waydroid图形界面

服务启动后，在终端执行以下命令启动Waydroid图形界面：

waydroid show-full-ui

此时会弹出Waydroid的Android桌面界面，按照提示完成语言、时区等基础设置后，即可正常使用。

🔧 四、Waydroid常用命令汇总

掌握以下常用命令可更高效地管理Waydroid，涵盖会话控制、界面启动、应用管理等核心操作：

# 1. 启动Waydroid会话（服务启动后需执行此命令初始化会话）
waydroid session start

# 2. 启动Waydroid图形界面（会话启动后执行）
waydroid show-full-ui

# 3. 进入Waydroid系统Shell（用于执行Android系统级命令）
sudo waydroid shell

# 4. 安装APK应用（替换$path_to_apk为实际APK路径）
waydroid app install $path_to_apk

# 5. 运行已安装应用（替换$package-name为应用包名，可通过列表命令获取）
waydroid app launch $package-name

# 6. 获取已安装应用列表（包含应用包名、名称等信息）
waydroid app list

📱 五、安装Android应用

Waydroid支持通过APK文件安装应用或通过Google Play商店（需初始化时选择GAPPS镜像）安装应用，两种方式如下：

📦 5.1 APK文件安装

waydroid app install /path/to/your/app.apk

将“/path/to/your/app.apk”替换为实际的APK文件路径即可。若需运行已安装应用，可先通过 waydroid app list 查看应用包名，再执行 waydroid app launch 包名 启动应用。

🛒 5.2 Google Play商店安装

若初始化时选择了GAPPS镜像，Waydroid桌面会有Google Play商店图标，点击图标后登录Google账号，即可像普通Android设备一样搜索并安装应用。

🔍 六、常见问题排查

❗ 重要问题1：英伟达（NVIDIA）显卡下Waydroid一直重复重启

解决方案：该问题多因英伟达显卡驱动与Waydroid的硬件解码兼容性不佳导致，需强制Waydroid使用软件解码。具体步骤如下：

# 1. 停止Waydroid服务
sudo systemctl stop waydroid-container

# 2. 编辑配置文件添加软件解码参数
sudo vim /var/lib/waydroid/waydroid_base.prop

# 3. 在文件末尾添加以下内容（按i进入编辑模式，编辑完成后Esc+:+wq保存退出）
ro.hardware.gralloc=default
ro.hardware.egl=swiftshader

# 4. 重启服务并启动
sudo systemctl start waydroid-container
waydroid session start
waydroid show-full-ui

❓ 问题2：ARM架构软件无法使用

解决方案：x86_64架构的Waydroid默认不支持ARM软件，需通过waydroid-script附带的waydroid-extras工具安装ARM转译组件实现兼容。Arch系统推荐通过yay安装该脚本，且转译组件分两种（适配不同CPU），步骤如下：

# 1. 停止Waydroid相关服务
sudo systemctl stop waydroid-container
waydroid session stop

# 2. 通过yay安装waydroid-script（若未安装yay，先执行sudo pacman -S yay）
yay -S waydroid-script

# 3. 运行waydroid-extras安装ARM转译工具（libhoudini，Intel CPU推荐）
# 若为AMD CPU，可替换为sudo waydroid-extras install libndk
sudo waydroid-extras install libhoudini

# 4. 安装完成后重启Waydroid
sudo systemctl start waydroid-container
waydroid session start
waydroid show-full-ui