WSABuilds 完整上手教程：在 Windows 上运行安卓应用、装 Google Play 与 Magisk
WSABuilds 完整上手教程在 Windows 上运行安卓应用、装 Google Play 与 Magisk【免费下载链接】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/WSABuildsWSABuilds 是一个社区项目它把微软的 Windows Subsystem for AndroidWSA打包成可直接安装的预构建二进制并预集成了 Google Play 商店MindTheGapps以及 Magisk / KernelSU 两种 root 方案——让你在 Windows 10 / 11 上一个文件夹就拥有能跑安卓应用和游戏、带 root 的安卓运行环境。⚙️ WSABuilds 是什么为什么用它替代官方 WSA先说清它和官方 WSA 的差别你就知道它到底解决了什么问题。微软已于 2025 年 3 月 5 日起停止对 WSA 的支持而官方 Microsoft Store 版既不含 Google 服务、也不提供 root。WSABuilds 则把这几件事一次性打包好能力官方 WSAMicrosoft StoreWSABuildsGoogle Play 商店不含预集成 MindTheGappsRoot 方案不含Magisk / KernelSU 可选分发方式Microsoft Store 应用预构建 .7z 二进制本地注册设备型号 / 配置固定支持自定义默认 Pixel 5它最适合这几类人想在 PC 上玩安卓手游或跑安卓独占 App 的需要 Magisk / KernelSU 做 root 与模块化的做安卓 App 兼容性测试、要一个稳定沙盒环境的。如果你只用微软生态应用官方 WSA 就够不必上 WSABuilds。 WSABuilds 安装前自查系统要求与前置条件清单装之前先确认机器达标能省掉大半的报错排查。核心条件如下项目要求Windows 11Build 22000.526 及以上Windows 1022H210.0.19045.2311及以上20H119041.264及以上可能可用需先装 KB5014032 与 KB5022834内存8 GB 起推荐 16 GB磁盘C 盘至少 10 GB 空闲SSD 推荐分区仅支持 NTFS不支持 exFATCPU 架构x86_64 或 arm64显卡Intel / AMD / Nvidia 均可Nvidia 偶有兼容问题Windows 功能Virtual Machine Platform、Windows Hypervisor Platform虚拟化BIOS/UEFI 与系统层面均需启用Windows 功能那两项按Win R输入OptionalFeatures.exe打开可选功能勾选后应用即可虚拟化若没开Run.bat也会提示你最终仍需在 BIOS/UEFI 里打开。一个常被忽略的前置条件如果你装过官方 WSA必须先完全卸载否则两者会冲突。想保留数据的话先把userdata.vhdx备份出来路径见文末备份与迁移。 WSABuilds 一键安装从 .7z 解压到 Run.bat最短的安装路径核心就四步解压、改名、放好、跑脚本。拿构建文件去 Releases 页下载与你系统匹配的.7zWindows 10 / 11、x64 / arm64别下 Source code。仓库里的构建脚本与文档见 MagiskOnWSA/scripts/ 与 Documentation/。解压并改名把 .7z 解压后将生成的文件夹重命名为WSA。这一步很关键——过长的文件夹名会导致 WSA 无法启动。挪到固定位置把WSA文件夹移到稳定路径文档文件夹很合适并删掉原始 .7z。注意这个文件夹要一直留着删了 WSA 就跑不起来。跑安装脚本进WSA文件夹双击Run.bat。若弹窗一闪而过、WSA 没装上就改用管理员 PowerShell 手动跑脚本cd C:\WSA PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1第一条切到安装目录第二条以绕过执行策略的方式运行真正的安装脚本。装完 WSA 会自动启动首次安装会先弹出诊断信息同意框正常点过即可有时会出现两个相同的框都点掉没问题。若连这套都不行基本就是硬件 / 系统不支持 WSA先回到上一节核对条件。️ WSABuilds 安装后配置必配项与可选优化装好别急着开 App先花两分钟把必配项落实再按需做可选优化。必配 A核对版本与 Google 服务打开Windows Subsystem for Android Settings开始菜单搜即可在 About 页确认版本号就是你装的那一版GApps 构建里顺带确认 Google Play 能打开。必配 B开启开发者模式为 ADB / 侧载铺路Settings → Advanced Settings → 打开Developer mode记下页面显示的 IP 与端口。后续 ADB 侧载、调试都靠它。可选 C切换 GPU游戏和图形应用对显卡敏感。Settings → Graphics and Performance →GPU used for apps for Android里可换显卡。Intel HD 530 及更早的核显、以及部分 Nvidia 卡容易出图形问题遇到就切到另一张卡或 Microsoft Basic Renderer详见 ChangingGPU.md。 WSABuilds 报错排查注册失败、无法启动与不兼容出问题别急着重装按下面的顺序查命中率最高。注册失败 / 脚本跑不动在管理员 PowerShell 里手动重注册并抓日志能看到 ActivityID 和具体失败原因Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID 上一步输出的 UUIDWSA 起不来优先确认虚拟化真的开了、文件夹名已改回WSA显卡是 Intel HD 530 及更早或某些 Nvidia 的先换 GPU。应用卡启动页 / 不兼容多数情况清一下该应用的数据和缓存、或重装应用即可仍不行就是构建与 App 不匹配做一次干净安装记得先备份。应用兼容矩阵在 App Compatibility.md。GApps 构建在 Win11 崩溃已知问题2025 年 6 月之后含 GApps 的构建在 Win11 上会普遍崩溃。临时解法有三个用官方给出的 workaround、改选名字里带NoGApps的构建、或回退到 2211 / 2210 老版本。抓 logcat 定位 App 级报错不想装工具的话日志直接在这个文件里%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcatadb connect localhost:58526连不上时回 Settings → Developer 页看实际 IP改成adb connect ip:5555再试。 WSABuilds 进阶ADB 侧载、无损更新与自定义构建跑通基础流程后这三样能显著提效。ADB 侧载任意 APK开启开发者模式拿到 IP 与端口后在 Windows 终端执行adb pair IP:port adb connect IP:port adb install APK文件路径分别完成配对、连接、安装。装好一个浏览器和文件管理器后后续很多 App 就能像普通安卓机一样在 WSA 里直接侧载了。完整流程见 ADB-Sideloading.md。无损更新保留应用与数据下载新构建后先在 Settings 里把 WSA 关掉用 7-Zip 打开 .7z 里的子文件夹全选文件解压覆盖到你现有的WSA文件夹替换时选对所有项执行再跑一次Run.bat数据全程保留。细节见 Updating.md。自定义构建Releases 里没有你要的组合时可开 issue 请求把这几项说清设备型号默认 Pixel 5、root 方案Magisk / KernelSU / 无、Magisk 变体、是否要 GApps、是否保留 Amazon Appstore。想完全自己掌控用仓库里的 MagiskOnWSA/ 脚本自建即可请求规范见 Custom Builds.md。 WSABuilds 备份与卸载数据迁移指南备份迁移 / 更新前必做用户数据集中在一个虚拟磁盘文件里把它拷到安全位置即可%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx卸载确认 WSA 已关闭 → 在设置 / 程序里卸载Windows Subsystem For Android Settings→ 删掉你解压安装的WSA文件夹 → 再进%LOCALAPPDATA%\Packages\看是否还残留MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe有就删掉。步骤细节见 Uninstallation.md。恢复备份先卸载干净 WSA再编辑WSA文件夹里的Install.ps1把开头Start-Process wsa://...那几行Android Settings / Magisk / Play Store 等删掉然后跑脚本出现一串弹窗时先别点把userdata.vhdx拷回...LocalCache\下最后再关闭弹窗启动 WSA数据即恢复。完整图文见 Backup and Restore.md要把 WSA 挪到别的盘 / 分区看 MoveToExtDrive.md。到这里WSABuilds 就能在你的 Windows 上跑起来了。遇到具体报错先翻 Troubleshooting.md 和 Having Issues.md构建状态与版本是否可用查 Information.md高频问题见 FAQ.md更深的使用与侧载指南都收在 Documentation/ 下。【免费下载链接】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），仅供参考