Waydroid

Waydroid

Waydroid docs

安装

Waydroid docs: Install Instructions

Arch Wiki: Waydroid

使用

waydroid session start
waydroid show-full-ui
waydroid session stop

配置

多窗口模式

waydroid session start
waydroid prop set persist.waydroid.multi_windows true
waydroid session stop
waydroid session start

Troubleshooting

网络不可用

Waydroid docs: Networking Issues

sudo ufw allow 53
sudo ufw allow 67
sudo ufw default allow FORWARD

渲染问题

英伟达显卡和Waydroid有冲突，可以使用waydroid_choose_gpu.py脚本选择正确的GPU进行渲染。

Caution

如果你不确定该脚本的安全性，请先查看其源代码。

点击查看 waydroid_choose_gpu.py 源代码

#!/usr/bin/env python3

from datetime import datetime
import os
import re
import subprocess
import sys
from typing import Self


class Gpu:
    # 0:02.0 VGA compatible controller [0300]: Intel Corporation Alder Lake-P GT2 [Iris Xe Graphics] [8086:46a6] (rev 0c)
    # 01:00.0 VGA compatible controller [0300]: NVIDIA Corporation GA106M [GeForce RTX 3060 Mobile / Max-Q] [10de:2560] (rev a1)
    PATTERN = re.compile(r"^(\S+)\s+VGA compatible controller\s+\[0300\]:\s+.*?\[([^\]]+)\]\s+\[[0-9a-fA-F]{4}:[0-9a-fA-F]{4}\]")

    def __init__(self, *, pci: str, name: str, render: str) -> None:
        self.pci = pci
        self.name = name
        self.render = render

    @classmethod
    def get_all(cls) -> list[Self]:
        by_path_dir = os.listdir("/dev/dri/by-path/")
        cmd = subprocess.run(["lspci", "-nn"], capture_output=True, text=True, check=True)
        gpus: list[Self] = []
        for line in cmd.stdout.splitlines():
            if match := re.search(cls.PATTERN, line):
                pci = match.group(1)
                name = match.group(2)
                render = None
                for link in by_path_dir:
                    if pci in link and "render" in link:
                        render = "/dev/dri/by-path/" + link
                if render is not None:
                    gpus.append(cls(
                        pci=pci,
                        name=name,
                        render=os.path.basename(os.readlink(render)),
                    ))
        return gpus

    def __str__(self) -> str:
        return self.name


def select(gpu: Gpu) -> None:
    # Backup
    cfg_path = "/var/lib/waydroid/waydroid.cfg"
    nodes_path = "/var/lib/waydroid/lxc/waydroid/config_nodes"
    timestamp = datetime.now().strftime("%Y-%m-%d-%H-%M-%S")
    for path in (cfg_path, nodes_path):
        if os.path.isfile(path):
            backup = f"{path}.{timestamp}.bak"
            try:
                subprocess.run(["cp", path, backup], check=True)
                print(f"💾 Backed up: {path} -> {os.path.basename(backup)}")
            except subprocess.CalledProcessError:
                print(f"⚠️ Warning: Failed to backup {path}")

    # Apply
    if not os.path.exists(cfg_path):
        print(f"❌ Error: Waydroid config file not found at {cfg_path}")
        sys.exit(1)
    with open(cfg_path, "r") as f:
        lines = f.readlines()
    new_lines: list[str] = []
    for line in lines:
        # 删掉原有的 drm_device 行
        if "drm_device" in line:
            continue
        new_lines.append(line)
        # 在 [waydroid] 标签下方插入新的配置
        if line.strip() == "[waydroid]":
            new_lines.append(f"drm_device = /dev/dri/{gpu.render}\n")
    with open(cfg_path, "w") as f:
        f.writelines(new_lines)
    print("📝 Waydroid configuration updated successfully.")
    print("🔄 Running 'waydroid upgrade --offline'...")
    subprocess.run(["waydroid", "upgrade", "--offline"], check=True)


def main() -> None:
    if os.geteuid() != 0:
        print("❌ Error: This script requires root privileges.")
        exit(1)

    gpus = Gpu.get_all()
    selected_gpu = None

    if len(sys.argv) > 2:
        print(f"Invalid cli arguments: {sys.argv}")
        exit(1)
    elif len(sys.argv) == 2:
        for gpu in gpus:
            if sys.argv[1] in gpu.name:
                selected_gpu = gpu
                break
    while selected_gpu is None:
        for i, gpu in enumerate(gpus):
            print(f"{i}: {gpu}")
        index_str = input(f"Please enter a number between 1 and {len(gpus)}(q to quit).")
        if index_str == "q":
            exit(0)
        elif index_str.isdigit():
            selected_gpu = gpus[int(index_str)]
        else:
            print("⚠️ Invalid input. Please enter a number.")
    print(f"Selected GPU: {selected_gpu}")
    select(selected_gpu)
    print(f"\n🎉 Success! Waydroid GPU has been switched to {selected_gpu}.")


if __name__ == "__main__":
    main()

curl -sL "https://docs-8gs.pages.dev/waydroid_choose_gpu.py" | sudo python3

各种GPU的渲染问题都可以通过清除安卓系统层来解决：

waydroid session stop 2>/dev/null
sudo systemctl stop waydroid-container.service
sudo killall -9 python3 waydroid lxc-start 2>/dev/null
sudo rm -rf /var/lib/waydroid/overlay_rw/system/
curl -sL "https://docs-8gs.pages.dev/waydroid_choose_gpu.py" | sudo python3
sudo waydroid init -f

通用

Danger

该文档里的命令会删除所有数据，包括用户数据，应用数据，系统数据等，请务必做好备份。

Waydroid docs: General Troubleshooting

1. 更新waydroid包

   sudo pacman -Syu

2. 更新waydroid镜像

   sudo waydroid upgrade

3. 重置waydroid

   sudo systemctl stop waydroid-container.service
   sudo rm -rf /var/lib/waydroid # Waydroid 的核心系统文件
   rm -rf /home/.waydroid ~/waydroid ~/.share/waydroid ~/.local/share/waydroid # 用户数据和配置文件
   rm -rf ~/.local/share/applications/*aydroid* # 安卓应用在 Linux 桌面生成的快捷方式
   waydroid init -f
   sudo systemctl start waydroid-container.service