WSABuilds 安装指南:5 步装好带 Root 和 Play 的 WSA
【免费下载链接】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
WSABuilds 提供现成的 WSA(Windows Subsystem for Android)安装包,内置 Google Play(MindTheGapps)以及 Magisk 或 KernelSU 两种 root 方案,免自行打包。本文带你从零装到 WSA 能启动、能装应用,卡住时按症状 30 秒定位。
适合谁:先花 10 秒判断要不要继续
能不能跑只看一条:CPU 硬件虚拟化开了没有,其余都是裕量问题。
| 场景 | 是否推荐 |
|---|---|
| Windows 10 2004+/Win11,想在 PC 上跑 Android 应用并装 Google Play | 推荐 |
| 需要 Magisk 或 KernelSU 刷模块、折腾 root | 推荐 |
| 只要官方 WSA 体验、不碰 root | 不推荐,直接去 Microsoft Store 装官方版 |
| 魔改精简系统(ReviOS、Ghost Spectre 等) | 不推荐,已知可能与 WSA 冲突 |
| 虚拟内存小于 8GB 或无硬件虚拟化的老机器 | 不推荐,WSA 本质是虚拟机,虚拟化是硬门槛 |
开工前自查:6 项打勾再动手
功能开关和旧版 WSA 是注册失败的头号原因,全部确认后再下载。
- Windows 10 2004(22H2)以上或 Windows 11 —— 确认:按
Win+R输入winver回车 - CPU 虚拟化已开启 —— 确认:任务管理器 → 性能 → CPU,右侧「虚拟化:已启用」
- 内存不低于 8GB —— 确认:任务管理器 → 性能 → 内存
- 安装盘为 NTFS 且至少 10GB 空闲 —— 确认:管理员终端执行
wmic logicaldisk get size,freespace,filesystem - 启用「虚拟机平台」和「Windows 基于虚拟化的安全」相关功能 —— 确认:
Win+R输入OptionalFeatures.exe,两个选项已勾选 - 未装过官方 WSA 或旧版 MagiskOnWSA —— 确认:PowerShell 执行
Get-AppxPackage *WindowsSubsystemForAndroid*,无输出即干净
装过旧版又想留数据:卸载前先复制%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx,装完再放回去。
坑|只勾了功能却没重启,注册照样失败 —— 勾完立刻重启一次。
主线操作:5 步装完
只要解压后的文件夹改名为 WSA,注册就不会卡在长路径上。
第 1 步:下载对应构建。到发布页的 Assets 区下载 .7z 压缩包,不要下载 Source code。选错构建是最常见的后悔来源:
| 构建变体 | 内置了什么 | 谁该选 |
|---|---|---|
| MindTheGapps + Magisk/KernelSU | Google Play 全家桶 + root | 默认选择,功能最全 |
| NoGApps + Magisk/KernelSU | 仅 root,无 Google 服务 | 不需要 Google 服务,或绕开 Win11 上 GApps 构建的崩溃问题 |
| 带 Amazon Appstore 变体 | 额外含 Amazon 商店 | 需要 Amazon 生态应用 |
| 无 Root 变体 | 纯净 WSA | 完全不折腾 root |
看到什么算成功:下载目录里有一个 .7z 文件。不对就回发布页确认选中的是 Assets 而非 Source code。
第 2 步:解压、改名、就位。用 7-Zip 解压,把解压出来的文件夹重命名为WSA,删掉 .7z,把 WSA 文件夹移到固定位置(文档目录即可)。
坑|长文件夹名(尤其脚本自动生成的名字)会直接导致 WSA 装完起不来,必须在安装前改短;坑|这个文件夹之后不能删,注册的是未打包的 appx 文件,删了 WSA 就废了。
看到什么算成功:WSA 文件夹里有Run.bat、Install.ps1、AppxManifest.xml。不对就回第 1 步重下,确认没有解错层。
第 3 步:双击 Run.bat。弹窗一律允许管理员权限。若之前装过 MagiskOnWSA,脚本会自动卸载旧版并保留数据。
看到什么算成功:黑窗口开始执行注册,随后出现 WSA 启动画面或诊断信息同意框(首次安装可能弹两个相同窗口,都点确认即可)。不对就跳第 4 步。
第 4 步:手动跑 Install.ps1(管理员终端)。弹窗一闪而过且没装上时用这步:
cd "X:\path\to\WSA" PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1看到什么算成功:脚本执行完,WSA 启动或开始菜单里出现 Windows Subsystem for Android。仍失败说明这台机器不支持 WSA,别再反复重试,跳「卡点急救站」确认硬件项。
第 5 步:收尾。点击 PowerShell 窗口按任意键关闭它,再关掉文件资源管理器,WSA 主界面或设置应用即完成首跑。
看到什么算成功:WSA 能进入桌面或设置应用能打开。不对就跳「验收清单」逐项定位。
验收清单:装完先打勾这 4 项
4 项全过才算装好,任何一项不过都别急着装应用。
- 开始菜单搜索 Windows Subsystem for Android,设置应用能打开且不退出不闪屏
- 设置 关于 页签的版本号与所下载构建一致
- Google Play(或 Amazon 商店,取决于构建)能正常打开并登录
- 侧载通道通:设置 开发人员 页签开启开发人员模式,然后
adb connect 127.0.0.1:58526返回 connected 即通过。
卡点急救站:按症状对表
九成卡点落在下面这 6 种症状里,对照排查动作直接做,不用从头读一遍。
| 症状 | 排查动作 | 判断依据 |
|---|---|---|
| 装完起不来、无闪屏 | 核对:BIOS 虚拟化已开、文件夹名就是 WSA、两个系统功能已启用 | 任务管理器性能页虚拟化显示「已禁用」就先改 BIOS |
| Run.bat 弹窗一闪而过 | 手动执行 Install.ps1;再失败就在 WSA 目录执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml,用输出的 ActivityID 执行Get-AppPackageLog -ActivityID <ActivityID>查日志 | 日志里报错行就是失败原因 |
| Win11 上 GApps 构建的 Play/Google 服务崩溃 | 换 NoGApps 构建完整重装(2025 年 6 月后部分 Win11 上 GApps 构建存在已知崩溃,仓库 README 已提示) | 换 NoGApps 后服务正常即可确认是该问题 |
adb connect报 10061 target machine actively refused | 先重启;仍不行按文档 端口占用修复 释放 58526 端口 | 开发人员模式已开还拒连,多半是 Hyper-V 抢占了端口 |
| 连不上 127.0.0.1:58526(无 10061 报错) | 读设置 开发人员 页签显示的 IP,改用adb connect ip:5555 | 页签显示的 IP 才是当前有效地址 |
| 想在 GApps 和 NoGApps 之间切换 | 不能直接切换,必须完整卸载后重装 | FAQ 明确 GApps 包之间互斥 |
维护与资料入口
更新就是覆盖文件不丢数据,备份只认 userdata.vhdx 一个文件。
- 更新:WSA 设置里 Turn off 并等加载动画消失 → 把新版 .7z 的子目录文件全部覆盖到原 WSA 文件夹(替换提示全选「是」)→ 重跑 Run.bat → 关于 页签核对版本。应用和数据都在 userdata.vhdx 里,不受影响。
- 备份/恢复:把
%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx复制到安全位置;恢复时先完整卸载,装好 WSA 后把 vhdx 放回该目录,详见 备份与恢复。 - 扩展:换 GPU、ADB 侧载、WSAFiles/WSAPacman 侧载、KernelSU 都有独立文档,按需取用。
资料入口:安装说明、FAQ、排障总览、更新流程、GPU 切换、侧载指南。
速查卡
| 动作 |
|---|
winver确认系统版本;任务管理器确认「虚拟化:已启用」 |
OptionalFeatures.exe勾选虚拟机平台相关功能,重启 |
| 下载 .7z → 文件夹重命名为 WSA → 双击 Run.bat |
| 没装上:管理员终端手动跑 Install.ps1 |
| 验收:设置应用能打开 + 关于页版本号正确 + adb 连上 58526 |
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考