WSABuilds 安装指南:5 步装好带 Root 和 Play 的 WSA
2026/9/17 4:43:21 网站建设 项目流程

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/KernelSUGoogle 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.batInstall.ps1AppxManifest.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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询