WSABuilds 快速上手:在 Windows 10/11 安装带 Google Play 与 Root 的 Android 子系统(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 让你在 Windows 10/11 上运行 Android 子系统(WSA),预构建镜像内置 Google Play 商店,并集成 Magisk 或 KernelSU 等 Root 方案,适合想在 PC 上运行 Android 应用、调试应用或需要 Root 环境的用户。
WSABuilds 能帮你解决哪些问题
WSABuilds 的核心价值,是把"在 Windows 中跑 Android"从一堆手动配置变成一次解压加一个脚本:
- 直接在 Windows 运行 Android 应用:镜像自带 Google Play 商店(MindTheGapps 构建),装好即可下载应用,不必折腾 Google 服务组件。
- 开箱即用的 Root 环境:内置 Magisk 或 KernelSU,方便安装插件框架、调试应用行为,适合开发和测试场景。
- 通过 ADB 与 Windows 侧联动:WSA 可作为 ADB 设备连接,支持侧载 APK、自动化调试。
- 替代 Microsoft Store 版 WSA:如果你需要 Play 服务或 Root,官方商店版 WSA 无法满足,WSABuilds 提供预配置好的替代方案。
安装前需要开启哪些系统功能
结论:先核对系统版本和硬件,再确认三项平台功能已启用,最后评估风险,四组都通过再开始安装。
系统版本
| 检查项 | 要求 |
|---|---|
| Windows 11 | Build 22000.526 或更高 |
| Windows 10 | 22H2,10.0.19045.2311 或更高 |
硬件能力
- 处理器:x86_64 或 arm64 架构(决定下载哪种构建包)。
- 内存:8GB 起步,16GB 更从容。
- 存储:至少 10GB 可用空间,SSD 优先。
- 显卡:兼容的 Intel、AMD 或 NVIDIA GPU 均可。
需要开启的功能(设置 → 程序 → 启用或关闭 Windows 功能 中可找到)
- 虚拟化:BIOS/UEFI 中的 CPU 虚拟化开关,是运行子系统的前提。
- Virtual Machine Platform:提供轻量虚拟机支持,WSA 运行在其上。
- Windows Hypervisor Platform:让 Windows 应用能访问虚拟化平台的能力,供 ADB 等工具使用。
可能风险
- 修改版系统(ReviOS、Tiny 10/11、Ghost Spectre 等)可能无法正常运行 WSA,建议使用官方原版系统。
- 若已安装 Microsoft Store 版 WSA,必须先完全卸载再安装 WSABuilds,两者不能共存。
- 已知问题提示:2025 年 6 月之后,部分含 GApps 的构建在 Windows 11 上出现崩溃问题,选择构建包前请以项目仓库 README 的最新说明为准。
最短安装路径:如何运行 WSA 安装脚本
推荐路径只有四步,全部成功的话不需要手动执行任何命令。
第一步:获取构建包
从项目仓库的 Releases 页面下载与你系统匹配的版本(区分 Windows 10/11、x64/arm64,注意不要下载 "Source code")。也可以直接克隆仓库获取脚本与工具:
git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds第二步:解压并重命名
- 用 7-Zip 或 WinRAR 解压 .7z 压缩包。
- 将解压出的文件夹重命名为
WSA。
第三步:放到固定位置
把WSA文件夹移动到稳定的路径(文档文件夹是常见选择)。注意:这个文件夹是 WSA 运行的基础,只要还在使用 WSA 就不能删除它。
第四步:启动安装
进入 WSA 文件夹,双击Run.bat。若此前装过 MagiskOnWSA,脚本会自动卸载旧版并保留用户数据。
备选路径:自动安装失败时手动执行
如果Run.bat弹出窗口直接消失、WSA 没有装上,改用管理员终端手动注册:
- 按
Win + X,选择"Windows 终端(管理员)"。 - 进入 WSA 文件夹并执行安装脚本:
cd "X:\path\to\WSA" PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1如果这条路仍然失败,通常是系统不满足 WSA 要求,回头核对上一节的四项检查。
安装后如何验证并连接 WSA 到 ADB
- 确认安装成功:安装完成后 WSA 会自动启动;首次启动可能弹出诊断信息同意窗口,点"确定"即可,偶尔出现两个相同窗口属正常现象。
- 打开开发者模式:进入"Windows Subsystem for Android 设置",切到"开发者"选项卡,开启 USB 调试。
- 用 ADB 连接(需本机已安装 Android SDK Platform Tools):
adb connect localhost:58526连接成功后可以用adb devices确认设备在线。端口 58526 是 WSA 的默认 ADB 端口,若连接异常,请以项目文档说明中的实际端口为准。
✅ 验证要点:WSA 能打开、开发者模式可开启、ADB 能连上,三件事都满足即算安装完成。
日常使用与维护:更新、侧载和资源调整
更新 WSA 版本
- 在 WSA 设置中点击"关闭",等待子系统完全停止(WSA-Sideloader 等第三方工具也要先退出)。
- 用解压工具打开新版 .7z,进入其中的子文件夹,全选文件解压到原来的 WSA 文件夹,遇到替换提示选择"对当前所有项目执行"。
- 重新运行
Run.bat,然后打开 WSA 设置 →"关于"页,确认版本号已更新。
侧载 APK
adb install /path/to/your/app.apk资源与性能
- 在 WSA 设置的"常规"选项卡中调高内存与存储分配。
- 关闭不必要的后台应用,定期清理缓存。
- 渲染异常时可尝试切换 GPU 模式,具体步骤见仓库内的 ChangingGPU.md。
⚠️ 再次提醒:WSA 安装文件夹(含Run.bat的那个)不能删除,删除后子系统无法启动。
安装失败或使用异常时怎么排查
按"现象 → 可能原因 → 处理动作"逐条对照:
| 现象 | 可能原因 | 处理动作 |
|---|---|---|
| 安装报错 0x80073CF9 | Microsoft Store 缓存异常 | 运行wsreset.exe清理商店缓存后重试 |
| Google Play 无法登录/闪退 | GApps 属性配置问题 | 运行python MagiskOnWSA/scripts/fixGappsProp.py修复 |
| ADB 提示"目标计算机积极拒绝连接"(10061) | Hyper-V 占用了 58526 端口 | 见下方预留端口命令 |
| 应用闪退或卡顿 | 应用与 WSA 版本不兼容 | 检查 App Compatibility.md 兼容性列表,并把 WSA 更新到最新版本 |
| 安装脚本执行失败 | 系统不满足要求或权限不足 | 核对系统版本与平台功能,改用管理员终端手动执行Install.ps1 |
预留端口的命令(管理员 PowerShell):
netsh int ipv4 add excludedportrange protocol=tcp startport=58526 numberofports=1其他安装错误码(0x80073CF0、0x80073CF6、0x80073CFB 等)均有对应修复文档,位于仓库的 Documentation/Fix Guides 目录,可按错误码逐一查阅。
重装前如何备份用户数据
WSA 的全部应用与用户数据集中在一个虚拟磁盘文件里:
%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx重装或升级前的备份流程
- 先关闭 WSA(设置中点击"关闭")。
- 将
userdata.vhdx复制到安全位置(如外部硬盘)。 - 完成重装后,把备份文件复制回原路径,应用和数据即可恢复。
风险提醒
- 复制前确认文件位置正确,
%LOCALAPPDATA%展开的是当前用户目录(形如C:\Users\用户名\AppData\Local),以实际目录为准。 - 卸载 WSA 时需删除安装文件夹和上述
Packages下的对应文件夹,操作前务必先备份userdata.vhdx,避免误删系统目录或项目目录。 - 项目附带了自动化工具:更新脚本在 WSAUpdater.py,卸载脚本在 WSAUninstaller.py,按各自说明使用即可。
写在最后
WSABuilds 通过预构建二进制包和自动化脚本,把"在 Windows 上运行带 Play 商店和 Root 的 Android 子系统"压缩成一次解压加一步安装,显著降低了 WSA 的使用门槛。完整的安装、更新、侧载与故障排查文档都在仓库的 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),仅供参考