WSABuilds 深度指南：Windows 上安装完整 Android-育师

WSABuilds 深度指南：Windows 上安装完整 Android

【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds

需要在 Windows 电脑上用一款只有 Android 版的工具时，很多人第一反应是开一个完整的安卓模拟器，但那又重又慢。而官方 WSA 已被微软宣布停止支持，且缺少 Play 商店和 root。WSABuilds 提供内置 Google Play 商店（MindTheGapps）和 Magisk/KernelSU root 的预构建 WSA 二进制文件，让你在 Windows 10/11 上十几分钟装好一套能用的 Android 环境。

🎯 技术背景：为什么选预构建的 WSA

先看清三个选项的差异，再决定要不要用它：

维度	官方 WSA	完整安卓虚拟机	WSABuilds
Google Play 商店	无（只有 Amazon Appstore）	看镜像而定	内置 MindTheGapps
Root 权限	无	需要自行折腾	内置 Magisk / KernelSU
资源占用	低	高	低（共享 Windows 进程）
维护状态	微软已宣布 EoS	依赖第三方	社区 LTS 维护中

技术基座很简单：WSABuilds 本质是微软 WSA 的注册式 Appx 包，跑在 Windows 的 Virtual Machine Platform / Hyper-V 之上。它不做二次虚拟化整套安卓，而是把系统镜像、GApps 和 root 方案预先打进包里，你只需注册即可运行，这是它比传统虚拟机轻得多的原因。

🗂️ 项目结构速览

仓库按"安装—运行—更新—文档"四层组织，东西都在这些地方：

MagiskOnWSA/installer/—— 安装入口。Run.bat一键安装，Install.ps1和MakePri.ps1分别负责注册 Appx 包和生成 PRI 容器文件，x64/、arm64/子目录对应不同 CPU 架构的脚本。
MagiskOnWSA/libhoudini/—— ARM 转译层（Houdini）。x86 机器上跑 ARM 应用时，它通过etc/binfmt_misc/下的 binfmt 规则把 ARM 可执行文件动态分派给转译器执行，这就是 ARM 应用能在你的 x86 电脑上运行的原因，代价是性能略低于原生。
MagiskOnWSA/Update Check/—— 版本监控脚本。WSARetailUpdateCheck.py、MagiskStableUpdateCheck.py、KernelSUUpdateCheck.py等持续追踪各组件的新版本，供维护者判断何时发布新构建。
Documentation/—— 全部用户文档。WSABuilds/是主文档（安装、升级、备份），Fix Guides/收录各错误码排查，Usage Guides/是进阶教程，遇到问题先来这里找。

🚀 动手指南：10 分钟装好带 Root 的 WSA

前置条件：

系统版本：Windows 11 Build 22000.526 及以上，或 Windows 10 22H2 10.0.19045.2311 及以上
硬件：内存最低 8GB（建议 16GB），C 盘至少 10GB 空闲，CPU 为 x86_64 或 arm64
分区格式：安装目录所在的分区必须是 NTFS，exFAT 不行
系统功能：在"可选功能"中启用 Virtual Machine Platform 和 Windows Hypervisor Platform
虚拟化：BIOS/UEFI 中已开启虚拟化。可先用下面的命令确认状态：

systeminfo | findstr /I "虚拟化"

如果之前装过官方 WSA，需先彻底卸载（想保留数据就先备份，见下文），否则注册会冲突。

安装步骤：

下载构建：去项目 Releases 页面，按你的系统选对应.7z文件（区分 Windows 10/11、x64/arm64，以及是否含 GApps/Magisk）。不要下 "Source code"。
解压并改名为WSA：用 7-Zip 解压，把解压出来的文件夹改名为WSA。
放到永久位置：把WSA文件夹移到不会再动的位置（如C:\Documents\WSA）。
提示：WSA 是注册式安装，系统直接引用这个文件夹里的文件，日后不能删除或改名，移动位置会导致 WSA 无法启动。
运行安装：双击文件夹里的Run.bat，脚本会自动注册包并拉起 WSA。若弹窗一闪而过、安装没成功，就在管理员终端中手动执行，替换为你的实际路径：
```
cd "C:\WSA" PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1
```
首次授权：脚本跑完后 WSA 自动启动，首次会弹出诊断信息许可窗口（有时弹两个，都点同意即可）。
收尾：回到 PowerShell 窗口按任意键关闭窗口。
验证成功：在开始菜单打开 "Windows Subsystem for Android Settings"，能看到设置界面即安装成功；装 GApps 版本的话，打开 WSA 内的 Play 商店能正常浏览即代表 GMS 就绪。

⚙️ 进阶玩法：GPU 切换、磁盘迁移与 Magisk 模块

GPU 切换避坑

什么时候需要：Intel HD Graphics 530 及更老的核显上 WSA 可能起不来或花屏，Nvidia 显卡也有已知的图形兼容问题。

怎么操作：WSA 设置 → "Turn off" 关掉 WSA → 切到 "Graphics and Performance" 标签 → 在 "GPU used for apps" 下拉框里换一张卡（另一颗核显/独显，或最稳的 Microsoft Basic Renderer）。

效果：Basic Renderer 牺牲一点图形性能换稳定性，是排查"WSA 起不来"时的首选对照；确认换卡能跑起来后，再试回显卡找平衡。详细截图版步骤见 GPU 切换指南。

把 WSA 数据迁到别的磁盘

什么时候需要：userdata.vhdx会越用越大，把 C 盘吃满。目标磁盘必须是 NTFS，建议预留 20GB。

怎么操作：先完整卸载 WSA 并删掉%LOCALAPPDATA%\Packages下的MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe文件夹，把 WSA 安装到新磁盘装好、数据用起来后，关闭 WSA，将Packages下该文件夹整体复制到目标磁盘，删除原文件夹，再在管理员命令行建目录联接（右侧替换为你的目标路径）：

mklink /J "%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe" "D:\WSAData\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe"

效果：WSA 以为数据还在 C 盘，实际读写都落在 D 盘。完整步骤（含保留现有数据的备份环节）见外盘迁移指南（中文版）。

Magisk 模块本地安装

什么时候需要：Magisk 的在线模块仓库已被官方下架，Magisk 管理器里的模块列表是空的，但本地安装模块完全可用。

怎么操作：把模块 zip 推到 WSA 里再调用 magisk 安装（需先 adb 连上，见文末调试入口）：

adb push module.zip /data/local/tmp adb shell su -c "magisk --install-module /data/local/tmp/module.zip"

效果：模块立即生效，重启 WSA 后在 Magisk 管理器"模块"页可见。注意 WSA 的 system 分区由 Hyper-V 只读挂载，不要尝试直接改 system 分区，一切修改走 Magisk 模块。

🔍 常见问题速查

注册 WSA 时报 0x80073CFx 系列错误

按 Fix Guides 里对应错误码的文档处理，通用排查是手动注册拿详细日志。先进 WSA 安装目录，再执行（用报错里的 ActivityID 替换<uuid>）：

Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID <uuid>

日志会给出失败的具体原因，常见为虚拟化未开、组件缺失或路径过长（参考FixPathTooLong.md）。

GApps 版在 Windows 11 上闪退 / 装完打不开

2025 年 6 月之后的部分 Windows 11 版本上，含 GApps 的构建出现了崩溃问题，项目方正在修复。当前可用的绕过方案有三：换用文件名带NoGApps的构建、使用较老的 2211/2210 版构建、或按官方 issue 中给出的临时修复操作（以仓库 README 最新说明为准）。装完后 WSA 完全没反应、连闪屏都没有的，对照 WSA Does Not Load 排查文档。

adb 连不上 localhost:58526

先确认 WSA 设置 → Developer 页里开发者模式已开启；再记下该页面显示的 IP 地址，改用 IP 直连试试：

adb connect localhost:58526

若本地回环不通，用 Developer 页显示的 IP 执行adb connect <ip>:5555。

升级后老应用卡加载页或闪屏

升级构建后先清出问题的应用的数据和缓存，或卸载重装；仍不行就做一次干净安装（先备份userdata.vhdx，见备份与恢复文档）。

📦 版本策略与升级流程

项目目前维护两条构建线，以 Releases 页面最新标注为准：

构建线	特点	适合谁
LTS（长期支持）	基线 WSA 版本保持稳定，Magisk / KernelSU / GApps 随新 Release 更新，当前为 LTS 7 Hotfix（v2407.40000.4.0），GApps 版默认捆绑 Magisk	日常使用、求稳
非 LTS	跟随 WSA 新版本迭代，不含捆绑 Magisk	需要新 WSA 特性、可接受尝鲜

升级流程（不丢应用和数据）：

WSA 设置里点 "Turn off"，等加载圈消失；确保 WSA-System-Control、WSAPacman 等工具未运行。
下载目标版本.7z，用 7-Zip 打开它内部的版本子文件夹（如WSA_2xxx.xxxxx...）。
全选子文件夹内文件，解压到你现有的 WSA 安装目录。
提示替换时选"对所有项目执行此操作"，替换文件选"替换目标中的文件"。
重新运行Run.bat，打开 WSA 设置 → About，确认版本号已更新。

提示：升级前建议把userdata.vhdx（位于%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\）复制一份备份，升级翻车时这是唯一的数据出口。

🌐 社区与维护现状

项目 Discord：官方答疑社区，安装问题、升级咨询优先来这里问，响应最快。
GitHub Issues：提交 bug、请求自定义构建（如特定 Magisk / GApps 组合）走这里，维护者会在 issue 里同步修复进度。
XDA 论坛 WSA 专帖：长期讨论串，适合查历史问题的解决脉络。

维护状态客观说明：微软已宣布 WSA 于 2025 年 3 月起停止官方支持（Amazon Appstore 及依赖应用不再更新），WSABuilds 因此进入 LTS 维护模式——仓库不归档，继续为 WSA ≥ 2311.40000.5.0 的版本发布更新 Magisk、KernelSU 和 GApps 的新构建，后续计划以仓库内公告为准。

🛠️ 调试入口与学习路径

日常调试主要靠三个入口：

ADB：adb connect localhost:58526（需开发者模式），是装模块、推文件、看日志的主力通道。
Logcat：adb logcat，或直接读文件%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat，应用闪退原因基本都能在里面找到。
WSA 设置 About 页：核对 WSA 版本、确认升级是否生效。

学习路径建议（都在仓库内，按顺序读）：