WSABuilds 项目针对微软 WSA（Windows Subsystem for Android）将于 2025 年 3 月停止官方支持的问题，提供预构建二进制镜像，让 Windows 10/11 用户继续运行完整 Android 环境。该方案集成 MindTheGapps（Google Play 服务）和 root 工具（如 Magisk 或 KernelSU），绕过 OEM 解锁限制，支持 APK 侧载、自定义 ROM 安装以及性能参数调整，实现生产力和游戏场景的无缝迁移。
核心优势在于自动化构建流程：项目使用 GitHub Actions 每日检测 WSA、Magisk 和 GApps 更新，生成 LTS（长期支持）版本如 v2407.40000.4.0，确保安全补丁持续可用。相比手动配置原生 WSA，该方案将部署时间从数小时缩短至 10-15 分钟，支持 x64 和 arm64 架构。用户无需编译镜像，直接下载预置包运行脚本，即可获得带 root 的独立 Android 子系统。
安装过程需先确认系统准备：BIOS 中启用 VT-x/AMD-SVM 虚拟化，Windows 功能中勾选 “虚拟机平台” 和 “Windows Hypervisor 平台”，重启后验证任务管理器 “虚拟化：已启用”。克隆仓库 git clone https://github.com/MustardChef/WSABuilds，进入 MagiskOnWSA/installer/{x64|arm64}，右键管理员运行 Install.ps1。脚本会提示选择：
- GApps：选 MindTheGapps（约 500MB），启用完整 Play 商店。
- Root：Magisk（模块生态丰富，兼容性强）或 KernelSU（内核级，轻量低开销）。
- 变体：NoGApps（无 Google 服务，节省空间）或带 Amazon Appstore。
安装后，WSA 出现在开始菜单，首次启动初始化 2-3 分钟。验证 root：打开 Magisk Manager App（已预装），显示 “已安装”。为侧载 APK，启用开发者模式（WSA 设置 > 系统 > 开发者选项 > USB 调试），PowerShell 执行 adb connect localhost:58526，然后 adb install app.apk。批量侧载清单：
- ES 文件浏览器：管理 /sdcard 与 Windows 文件共享（\wsl$\WSA）。
- Termux：运行 BusyBox 工具集（项目预置 houdini 层支持 ARM APK）。
- GSpace：绕过部分应用设备检查。
自定义 ROM 支持依赖 root：Magisk 模块如 MagiskOnWSA 允许 overlayfs 修改系统分区。参数示例：
- 备份原 ROM：
adb pull /system system_backup.tar。 - 刷入 LineageOS：解压 ROM 到 /sdcard，Magisk 安装 ZIP。
- 回滚：使用项目 Uninstall Script，完全清理残留（WSABuilds Utilities/Uninstall Script/WSAUninstaller.py）。
性能调优点针对游戏和高负载场景。WSA 设置中调整：
- 内存：系统 RAM 的 1/4（如 16GB 设 4096MB），避免 OOM。
- GPU：切换独立显卡（设置 > 图形 > 高性能），帧率提升 40-60%。
- 网络：LocalHostLoopback 工具桥接代理，降低延迟。
高级 tweaks 通过 root 编辑 /data/local.prop（需 adb shell su）：
ro.config.low_ram=false
dalvik.vm.heapsize=512m
debug.sf.hw=1 # 硬件叠加
persist.sys.scrollingcache=3
重启 WSA 生效。监控指标：任务管理器观察 WSAClient.exe CPU<20%、内存峰值 < 分配 80%；logcat 捕获崩溃 adb logcat > crash.log。风险阈值：若更新后崩溃率 > 10%，回滚至上个 LTS 版（releases 下载 .7z 包）。
常见故障参数：
- 0x80073CF9：运行
dism /online /enable-feature /featurename:VirtualMachinePlatform /all，重启。 - Play 登录失败：
python scripts/fixGappsProp.py修复 build.prop。 - 无网络：防火墙允许 WsaService，重置 WSA 网络。
该方案特别适用于开发者测试（ADB 调试跨平台 App）和游戏玩家（大屏 120FPS）。相比模拟器如 BlueStacks，WSA 原生集成节省 50% 资源，支持 Vulkan 渲染。社区活跃（12.8k stars），Discord/XDA 提供实时 fix。
资料来源：
- GitHub: https://github.com/MustardChef/WSABuilds (预构建下载与文档)
- 项目文档：Documentation/WSABuilds/Installation.md（安装指南）