Waydroid 安装与基础设置

# 检查当前图形会话协议
echo $XDG_SESSION_TYPE
# 期望输出: wayland

# 如果输出 x11，检查当前登录管理器是否支持 Wayland
loginctl show-session $(loginctl | grep $(whoami) | awk '{print $1}') -p Type

# 检查必需指令集
grep -o -E 'ssse3|sse4_1|sse4_2' /proc/cpuinfo | sort -u

# 转译组件可能要求其中部分指令，不是所有 Waydroid 场景的统一要求:
# ssse3
# sse4_1
# sse4_2

# 一行版本：所有指令都存在则返回 3
grep -o -E 'ssse3|sse4_1|sse4_2' /proc/cpuinfo | sort -u | wc -l
# 期望输出: 3

# 检查 binder 或 rust_binder 模块是否可用
modprobe --dry-run binder_linux 2>&1 || modprobe --dry-run rust_binder 2>&1

# 如果上述命令报 "modprobe: FATAL: Module binder not found"
# 说明内核未编译 binder 支持，需重新编译内核或更换支持 Android 的内核

# 检查模块是否已加载
lsmod | grep -E 'binder'

# 检查 PSI 是否已启用
cat /proc/pressure/cpu
# 如果文件存在且有输出，说明 PSI 已启用
# 如果报 "No such file or directory"，说明未启用

# 检查内核启动参数中是否有 psi=1
cat /proc/cmdline | grep -o 'psi=1'

# 检查 IPv6 是否启用
sysctl net.ipv6.conf.all.disable_ipv6
# 期望输出: net.ipv6.conf.all.disable_ipv6 = 0

# 如果为 1，临时启用
sudo sysctl net.ipv6.conf.all.disable_ipv6=0

# 永久启用：确保 /etc/sysctl.conf 或 /etc/sysctl.d/ 中没有
# net.ipv6.conf.all.disable_ipv6 = 1

# 检查 LXC 版本
lxc-info --version
# 期望输出: 5.0.x 或 4.0.x

# 同时检查 Python LXC 绑定
python3 -c "import lxc; print(lxc.__version__)"

# 1. 添加官方 apt 仓库并安装 GPG 密钥（需要 curl）
#    该脚本自动检测发行版版本并配置对应的 apt source
curl -s https://repo.waydro.id | sudo bash

# 2. 安装 Waydroid 主程序
sudo apt install waydroid

# 3. 可选：安装 Google Play Services 支持
# GAPPS 通过 waydroid init -s GAPPS 选择，不假定有 waydroid-gapps 包

# 安装 Waydroid（含所有运行时依赖）
sudo pacman -S waydroid

# 内核模块：Arch 的 linux/linux-lts 内核默认包含 binder
# 确认 binder 已加载：
lsmod | grep binder

# 如果需要额外工具
yay -S waydroid-image       # 第三方来源：先确认包仍存在； 预下载的镜像（可选，跳过 init 下载）
yay -S waydroid-script-git  # 第三方来源：先确认包仍存在； 额外辅助脚本（可选）

# /etc/nixos/configuration.nix 或 flake 配置
{
  virtualisation.waydroid = {
    enable = true;
    # package = pkgs.waydroid-nftables;  # 默认随 networking.nftables.enable 选择，不固定
  };

  # 26.05 模块已经配置 psi=1 并检查 Binder/BinderFS/MEMFD
  # 自定义内核另行检查实际支持，不盲目重复指定模块
}

sudo nixos-rebuild switch
sudo waydroid init

# 启用 COPR 仓库
# 当前常规安装不需要启用旧 COPR

# 安装 Waydroid
sudo dnf install waydroid

# SELinux 可能需要调整（如遇权限问题）
# 先查看 SELinux AVC 日志并修正标签/策略，不默认关闭 SELinux
# 永久：需编写 SELinux 策略模块（超出本文范围）

# 最简初始化：下载标准 LineageOS 镜像（无 Google 服务）
sudo waydroid init

# 带 Google Play Services 的初始化
sudo waydroid init -s GAPPS

# 强制重新下载（即使已有镜像）
sudo waydroid init -f # 强制初始化；先核对当前状态与备份

# 指定下载渠道
sudo waydroid init -c https://ota.waydro.id/system  # 默认渠道

# 查看已下载的镜像
ls -lh /var/lib/waydroid/images/
# 期望输出:
# -rw-r--r-- 1 root root  xxxM ... system.img
# -rw-r--r-- 1 root root  xxxM ... vendor.img

graph TD
    A["waydroid init 启动"] --> B{本地已有镜像?}
    B -->|否，或指定 -f| C["从 SourceForge 下载<br/>system.img + vendor.img"]
    B -->|是| D[跳过下载]
    C --> E["校验 SHA256 哈希<br/>确保镜像完整性"]
    D --> E
    E --> F["创建 /var/lib/waydroid/ 目录树"]
    F --> G["挂载 system.img<br/>按实际镜像格式与 overlay 布局"]
    G --> H["创建 /var/lib/waydroid/waydroid_base.prop"]
    H --> I["写入 build.prop 属性<br/>（ro.waydroid.version 等）"]
    I --> J["生成 LXC 配置文件<br/>/var/lib/waydroid/lxc/waydroid/config"]
    J --> K["init 完成"]

# 启动容器服务并设为开机自启
sudo systemctl enable --now waydroid-container

# 检查服务状态
sudo systemctl status waydroid-container

# 期望输出关键行:
# Active: active (running) since ...
# CGroup: /system.slice/waydroid-container.service
#         ├─ /usr/bin/python3 /usr/bin/waydroid -w container start
#         └─ /usr/bin/lxc-start -F -n waydroid -- /init

# 启动 Waydroid 会话
waydroid session start

# 等待日志中出现 "Android with user 0 is ready"
# 这表示 Android 服务框架（system_server, SurfaceFlinger 等）全部就绪

# 跟踪 Waydroid 日志（容器 + 会话）
waydroid log # -c 是清除日志，不是跟踪标志

# 或者只看会话层日志
journalctl -u waydroid-container -b

waydroid show-full-ui

# 1. 状态检查
$ waydroid status
Session:        RUNNING
Container:      RUNNING
Vendor type:    MAINLINE
Session user:   0 (0)
Wayland display: wayland-1

# 2. 列出已安装应用
$ waydroid app list
Name: Settings, package: com.android.settings
Name: Trebuchet, package: com.android.launcher3
...

# 3. 进入容器 shell
$ sudo waydroid shell
waydroid:/ # getprop ro.build.version.release
13
waydroid:/ # pm list packages | head -5
package:com.android.settings
...
waydroid:/ # exit

# 通过包名启动应用
waydroid app launch com.android.settings          # 打开设置
waydroid app launch com.android.launcher3         # 打开启动器

# 安装 APK 文件
waydroid app install /path/to/application.apk     # 安装单个 APK

# 通过 Google Play 安装（GAPPS 变体）
waydroid app launch com.android.vending           # 启动 Play Store
# 然后在 Play Store 中正常搜索安装

# 为 Android 应用创建桌面快捷方式
# 安装 APK 后，waydroid 会自动在 ~/.local/share/applications/ 下
# 生成 waydroid.<package>.desktop 文件
ls ~/.local/share/applications/waydroid.*.desktop

# 查看当前属性
waydroid prop get persist.waydroid.width
waydroid prop get persist.waydroid.height

# 设置属性（影响 Android 设备行为）
waydroid prop set persist.waydroid.width 720        # 设置窗口宽度
waydroid prop set persist.waydroid.height 1280       # 设置窗口高度
waydroid prop set persist.waydroid.fake_wifi "com.example.app"    # 伪装 Wi-Fi 连接
waydroid prop set persist.waydroid.multi_windows true # 启用多窗口模式

# 部分属性修改后需重启会话才能生效
waydroid session stop
waydroid session start

# 先停止 Android 会话
waydroid session stop

# 再停止容器服务
sudo systemctl stop waydroid-container

# 完全清理（停止会话 + 停止容器 + 释放资源）
waydroid session stop && sudo systemctl stop waydroid-container