跳转至

Waydroid 设置指南

什么是 Waydroid?

Google Play Store|650x500

Attention

Waydroid 在 Nvidia 硬件上无法使用。

Waydroid

Waydroid 是一个在 Linux 上运行的 Android 容器。汽核 OS 用户可以通过这种方式运行 Android 应用。

首次设置

打开主机终端并输入以下命令来设置 Waydroid:

ujust configure-waydroid

初始化 Waydroid

Waydroid 需要用户首次初始化,可以通过选择以下选项完成: Initialize Waydroid

通过输入以下命令确认是否成功:

/usr/bin/waydroid-launcher

这将首次启动 Waydroid。

配置 Waydroid

自定义你的 Waydroid 容器

第 1 步:停止 Waydroid 会话

Waydroid 需要停止运行才能正确配置。

打开主机终端并输入以下命令:

waydroid session stop

第 2 步:配置

打开主机终端并输入以下命令:

ujust configure-waydroid

选择 Configure Waydroid 将允许用户通过 Waydroid Extras Scripts 安装额外的 Android 调整。

  1. 选择你已安装的 Android 版本。要查看已安装的 Android 版本,启动 Waydroid,打开"设置"应用,然后进入"关于本机"。你的 Android 版本将是 11 或 13。
  2. 选择要安装的项目
可用的 Waydroid 扩展:
  • GApps(默认 Android 应用,包括 Google Play Store)或 microG(Google 应用的免费替代品)

  • ARM 转译(libndk 或 libhoudini)

  • libhoudini 比 libndk 提供更好的整体兼容性。

    • 某些游戏可能仅在 libhoudini 或 libndk 之一上运行。在 Android 11 上,如果你使用 AMD CPU,libhoudini 的运行速度会明显慢于 libndk。
    • 不要同时安装两者。如果需要切换,请先卸载当前的转译层,再安装新的。
  • Magisk(Android 高级用户工具套件)

  • Logitech Smartdock 支持(SmartDock 硬件支持)

  • F-Droid 特权扩展(完善的 F-Droid 支持)

  • widevine(视频串流 DRM 支持)

获取 Google 设备 ID 以通过认证(GApps)

Waydroid_DeviceID|690x182

  1. 启动 Waydroid (Waydroid 必须正在运行)

  2. 选择你当前的 Android 版本后,选择 Get Google Device ID to Get Certified,特别是如果你打算使用 Google Play Store(GApps)。

  3. 按照终端输出中的说明操作。

验证完成后,通常需要等待一段时间你的设备才能通过 Google Play 认证。

添加为非 Steam 快捷方式

这对使用 Steam 游戏模式的 AeroCore OS 镜像很有用。

确保将 /usr/bin/waydroid-launcher 作为非 Steam 游戏添加到 Steam 中,以便 Waydroid 在 Steam 游戏模式中正常运行。

Waydroid Launcher 添加到 Steam|960x540

启用多点触控支持

要在 Steam 游戏模式下使用 Waydroid 的多点触控手势,需要在 Steam 的控制器设置中启用"Touchscreen Native Support":

  1. 在你的 Waydroid 快捷方式中,进入控制器设置。
  2. 进入编辑布局 > Action Sets > Default。
  3. 选择添加常驻命令。
  4. 在System 下,选择Touchscreen Native Support 命令。

Waydroid Launcher Steam 多点触控|640x400


Waydroid 提示和技巧

本节专门介绍在汽核 OS 上运行 Waydroid 的更具体操作和问题。

Waydroid Helper 应用

Waydroid_Helper|400x400

waydroid-helper 是一个 GUI 应用,可对 Waydroid 安装进行更高级的配置和控制。

要安装它,请运行以下 ujust 命令:

ujust configure-waydroid helper

你也可以直接前往其发布页面,通过 GearLever 安装最新的 AppImage。

在失去焦点时禁用 Waydroid 输入

Waydroid 存在一个问题:即使窗口未获得焦点,它也会注册来自控制器、键盘和其它输入设备的输入。

禁用此功能:

Note

Waydroid 必须正在运行!

在主机终端中运行以下命令:

waydroid prop set persist.waydroid.uevent false

如果要撤销此更改,运行相同步骤,但将同一命令中的 false 改为 true。

将鼠标点击转为触摸输入

某些应用不接受鼠标点击,只响应触摸屏点击。

Note

Waydroid 必须正在运行!

可以在主机终端中使用以下命令为单个应用启用此功能:

waydroid prop set persist.waydroid.fake_touch "PACKAGE_NAME_HERE"

Note

包名通常采用 "com.example.appname" 格式。 可以在"设置"应用的"应用信息"页面底部找到应用包名。

也支持通配符,因此 "com.rovio.*" 会应用于 Rovio 的所有游戏。

以应用 "Fate/Grand Order" 为例: waydroid prop set persist.waydroid.fake_touch "com.aniplex.fategrandorder.en"

Waydroid 内的应用需要重启才能使更改生效。

Warning

仅对特定应用使用此命令! 使用通配符全局设置会导致鼠标光标行为异常。

要撤销这些更改,在主机终端中使用以下命令:

waydroid prop set persist.waydroid.fake_touch ""

分辨率和密度选项

面向遇到 Waydroid 分辨率、缩放问题或嵌套运行 Waydroid 问题的用户。这是可选的。

打开主机终端并输入以下命令:

sudoedit /etc/default/waydroid-launcher
sudoedit /etc/default/steamos-nested-desktop

完成后保存文本文件。

Waydroid 混合显卡修复

仅面向硬件中有多个 GPU 且在 Waydroid 中遇到图形错误的用户。

在主机终端中输入:

ujust configure-waydroid

然后选择 Select GPU for Waydroid,将给出选择 Waydroid 使用哪个 GPU 的选项,以修复图形错误。

重置 Waydroid

Warning

你将丢失所有 Waydroid 数据。

如果遇到问题或想要全新的 Waydroid 容器,在输入以下命令后选择 Reset Waydroid:

ujust configure-waydroid