WSABuilds 快速上手:在 Windows 10/11 安装带 Google Play 与 Root 的 Android 子系统(WSA)
2026/9/18 15:25:27 网站建设 项目流程

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 11Build 22000.526 或更高
Windows 1022H2,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 没有装上,改用管理员终端手动注册:

  1. Win + X,选择"Windows 终端(管理员)"。
  2. 进入 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 版本

  1. 在 WSA 设置中点击"关闭",等待子系统完全停止(WSA-Sideloader 等第三方工具也要先退出)。
  2. 用解压工具打开新版 .7z,进入其中的子文件夹,全选文件解压到原来的 WSA 文件夹,遇到替换提示选择"对当前所有项目执行"。
  3. 重新运行Run.bat,然后打开 WSA 设置 →"关于"页,确认版本号已更新。

侧载 APK

adb install /path/to/your/app.apk

资源与性能

  • 在 WSA 设置的"常规"选项卡中调高内存与存储分配。
  • 关闭不必要的后台应用,定期清理缓存。
  • 渲染异常时可尝试切换 GPU 模式,具体步骤见仓库内的 ChangingGPU.md。

⚠️ 再次提醒:WSA 安装文件夹(含Run.bat的那个)不能删除,删除后子系统无法启动。

安装失败或使用异常时怎么排查

按"现象 → 可能原因 → 处理动作"逐条对照:

现象可能原因处理动作
安装报错 0x80073CF9Microsoft 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

重装或升级前的备份流程

  1. 先关闭 WSA(设置中点击"关闭")。
  2. userdata.vhdx复制到安全位置(如外部硬盘)。
  3. 完成重装后,把备份文件复制回原路径,应用和数据即可恢复。

风险提醒

  • 复制前确认文件位置正确,%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),仅供参考

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

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

立即咨询