WSABuilds 教程:在 Windows 10/11 上快速装好带 Google Play 和 Root 的 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(又名 MagiskOnWSA)提供预构建的 Windows 安卓子系统(WSA)安装包:内置 Google Play,可选 Magisk 或 KernelSU 作为 Root 方案。官方 WSA 没有 Google 服务(GMS,很多 App 启动必需)、也没有 Root,WSABuilds 把这些全部打进一个 .7z 压缩包,解压即装,装完即用。
⚡ 快速上手:5 步装好
确认系统:Windows 11 构建 22000.526 及以上,或 Windows 10 22H2(19045.2311)及以上;在「可选功能」里启用Virtual Machine Platform和Windows Hypervisor Platform,BIOS 中打开虚拟化;C 盘为 NTFS 分区且剩余 10GB 以上,内存建议 16GB(8GB 起步)。
先移除官方 WSA:装过官方版的必须彻底卸载。想保留数据的话,卸载前备份
%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx,装完再还原。下载并解压:从项目 Releases 页取最新 .7z,用 7-Zip 解压(不建议用系统自带解压),把解压出的文件夹改名为
WSA放到文档等固定位置。这个文件夹不能删,路径别太长。执行安装:双击文件夹里的
Run.bat。如果弹窗一闪而过没装成功,用管理员终端进入该文件夹执行:PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1验证:安装完成后 WSA 会自动启动(首次会弹诊断信息授权框)。打开 WSA 设置应用,在「关于」页核对版本号。
注意:2025 年 6 月之后的 Win11 上 GApps 版有已知崩溃问题,项目 README 已标注,可改用包名带NoGApps的版本,或选较老的 2211/2210 版本过渡。
✅ 它好在哪
| 维度 | 官方 WSA | WSABuilds |
|---|---|---|
| Google 服务 | 无 GMS / Play 商店,大量 App 无法运行 | 内置 MindTheGapps,Play 商店开箱可用 |
| Root | 无 | Magisk / KernelSU 二选一 |
| 更新 | 由微软控制 | 直接下新版包覆盖旧文件夹、重跑 Run.bat,App 和数据保留;已承诺长期支持(LTS),Magisk/GApps 版本跟随官方滚动更新 |
仓库里还附带完整的自建流水线:跑 MagiskOnWSA/scripts/ 下的 run.sh,交互式选择架构(x64/arm64)、WSA 渠道(零售/预览/测试)、Root 方案、是否装 GApps、输出压缩格式,就能自己产出一个 .7z,不受发布版限制。
原理浅析:预构建包里装了什么
核心机制是打包流水线:run.sh 收集参数后由 build.sh 依次调用 Python 脚本——extractWSA.py 解开官方 WSA 的 msix 包并重构 Android 文件系统,extractMagisk.py 把 Magisk 连同 SELinux 策略(sepolicy.rule、post-fs-data.sh)注入系统,generateGappsLink.py 拉取匹配的 MindTheGapps,最后压成成品。版本号不用你操心:Update Check/目录里每个组件各有一个脚本,分别轮询 WSA、Magisk、KernelSU、GApps 的官方发布渠道,组件一更新就出新的构建,你跟着 Releases 走就行。
安装环节则用Add-AppxPackage -Register注册未打包文件,这正是「安装文件夹不能删」的原因:注册的是你磁盘上那套实体文件。
🛠 常见问题
- Run.bat 报 0x80073CF0→ 多为下载/解压损坏或文件夹路径过长 → 重新下载,压缩包和解压目录都改短名,用 7-Zip 解压,确认目标是 NTFS 分区。
- adb 连接报 10061「目标计算机积极拒绝」→ Hyper-V 抢占 adb 端口 → 先重启电脑;反复出现则用 netsh 把 58526 端口排除出 Hyper-V 动态端口范围再重启,步骤见 Documentation/Fix Guides/ 下同名文档。
- WSA 起不来或画面花屏→ Intel HD 530 及更老核显、或 Nvidia 显卡兼容性问题 → 按 ChangingGPU.md 指南切到另一块 GPU 或 Microsoft Basic Renderer。
- adb connect localhost:58526 连不上→ 未开 WSA 开发者模式 → 在 WSA 设置里开启,到 Developer 页查看实际 IP 后执行
adb connect ip:5555。
🚀 进阶玩法
- 侧载 APK:adb 连上后用
adb push+pm install即可装任意 APK;批量管理可用 WSA-Sideloader、WSAPacman 等工具,参考 Documentation/Usage Guides/Sideloading Guides/ 下的分篇指南。 - 搬家到数据盘:WSA 数据都在 C 盘且体积不小,照 MoveToExtDrive.md(有中文版 MoveToExtDrive_CN.md)操作即可整体迁移到其他磁盘。
🛡 安全边界
WSA 运行在 Hyper-V 虚拟化沙箱中,与宿主机隔离;系统分区以只读方式挂载,想改系统只能走 Magisk 模块,无法直接写分区。虚拟机身份决定了它过不了 SafetyNet / Play Integrity 校验,依赖强设备验证的 App 可能受限。Root 权限意味着 Magisk 模块要自己甄别,项目只内置 Root 框架,装什么模块、承担什么风险由使用者自己决定。
想在 Windows 电脑上跑带 Root 和 Google Play 的 Android 应用,WSABuilds 的预构建包是解压就能装完即用的现成方案。
【免费下载链接】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),仅供参考