Hotdry.
systems-engineering

WSABuilds:Win10/11 上即用型 WSA 预构建镜像带 Magisk/KernelSU Root

提供预构建 WSA 镜像,集成 root 与 GApps,支持 Win10/11 x64/arm64 的快速部署与数据无损更新要点。

WSABuilds 项目针对 Windows Subsystem for Android (WSA) 提供了一键即用的预构建镜像,内置 Magisk 或 KernelSU root 解决方案,以及可选的 Google Play 服务(MindTheGapps),让用户无需从源码手动构建即可在 Win10/11 上运行 Android 应用。这种方案的核心优势在于简化部署流程,同时保持 root 权限以支持高级定制,如模块安装和系统修改。

项目基于 LSPosed/MagiskOnWSALocal 脚本自动化集成 root,支持 WSA 版本从 v2210 到最新 v2407.40000.4.0 LTS。预构建镜像分为 LTS(长期支持,稳定版,每月更新)和非 LTS(预览版,跟踪 WSA Preview Channel)。例如,当前 LTS_7 版本(v2407.40000.4.0)适用于 Win11 x64/arm64 和 Win10 x64,提供 Magisk 默认集成(GApps 版)和无 root 选项。下载链接直指 GitHub Releases 和 OneDrive 镜像,确保高可用性。[1]

部署参数高度优化:最低要求 Win11 Build 22000.526+ 或 Win10 22H2 19045.2311+,启用虚拟化(BIOS/UEFI + Windows 功能:Virtual Machine Platform、Windows Hypervisor Platform),8GB RAM(推荐 16GB),NTFS 分区至少 10GB 空闲。x64/arm64 架构均支持,GPU 兼容 Intel/AMD/NVIDIA(NVIDIA / 老 Intel HD 需切换 Microsoft Basic Renderer)。安装清单:

  1. 下载与提取:从 Releases 下载对应 .7z(如 Windows_11_2407.40000.4.0_LTS_7.7z),7-Zip 解压至 WSA 文件夹(避免路径过长),重命名为 WSA。
  2. 权限执行:右键 Run.bat 以管理员运行(或 PowerShell: cd "路径" ; PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1)。首次安装自动注册 Appx 包,保留 userdata.vhdx 数据。
  3. 验证启动:WSA 设置 app 出现,同意诊断,检查版本(About 页)。ADB 连接:adb connect localhost:58526 或 IP:5555。
  4. Root 确认:Magisk app 已预装,版本随镜像更新;KernelSU 需额外 manager app。模块安装:adb push module.zip /data/local/tmp ; adb shell su -c magisk --install-module /data/local/tmp/module.zip

更新无损数据:关闭 WSA(设置 > Turn off),解压新版至原文件夹覆盖,运行 Run.bat。合并文件夹时选 “全部替换”。备份 userdata.vhdx(% LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx)以防万一。监控要点:GitHub Issues 检查兼容(如 #593 Windows 更新冲突,使用 NoGApps 版),Discord 社区反馈稳定性。阈值:RAM 使用超 80% 时限流 app;WSA 不启动时重启 Hyper-V(Restart-Service vmcompute)。

风险控制:微软 2025 年 3 月 5 日终止官方 WSA 支持,但 WSABuilds 进入 LTS 模式持续维护 Magisk/GApps 更新。近期 Windows 更新(如 7 月后)可能破坏安装,优先 LTS 或旧版 v2211。NVIDIA GPU 偶现图形故障,切换 GPU:Documentation/ChangingGPU.md。回滚策略:卸载(设置 > 卸载 + 删除文件夹 + % LOCALAPPDATA%\Packages 清理),恢复备份。

实际参数落地:arm64 镜像针对 Surface Pro X 等,x64 通用 Intel/AMD。GApps 版需 MindTheGapps(pico 变体,轻量),root 版 Magisk Delta/Alpha 可请求自定义构建。性能基准:i7 + RTX 3060 下,Arknights 等游戏稳定 60FPS。侧载 APK:WSA-Sideloader 或 adb install app.apk。本地网络:VirtWifi 桥接 Windows 网络。

此方案参数化部署阈值:更新频率 LTS 月 1 次,非 LTS 周更;兼容 WSA 版本表(✅ 稳定,⚠️ 需修补)。通过预构建 + root,WSABuilds 实现 Android 生态无缝桥接到 Windows,无需 Docker 或复杂 CI/CD。

资料来源
[1] GitHub - MustardChef/WSABuilds (2025-11-26 访问)。
[2] XDA Developers WSA 线程。

(正文字数:约 1250 字)

查看归档