WSABuilds 完整部署指南:10 分钟在 Windows 上跑起带 Root 的安卓子系统
【免费下载链接】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
你需要在 PC 上跑安卓应用,或者想要一个带 Root 权限、能装 Google Play 的安卓环境来做测试,而官方的 Windows Subsystem for Android(WSA)又功能受限、折腾起来麻烦?WSABuilds 就是一站式的预编译部署工具:它把 WSA 核心、Google Play 服务(MindTheGapps)以及 Magisk 或 KernelSU 打包成开箱即用的安装包,让你跳过繁琐的手工配置,直接得到一个可用的安卓子系统。
下面按「先跑起来 → 再查环境 → 分人群配置 → 调优排错」的顺序带你走一遍。
先跑起来:3 步完成最小安装
别急着看配置清单,先把环境立起来。整个过程只需要三步:
拿到安装包。克隆项目仓库,从项目的 Releases 页面下载对应你系统的预编译 .7z 包:
git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds版本选择建议:优先 LTS 版(版本号形如
v2407.40000.4.0_LTS_7),稳定性更好;想尝鲜新特性再选非 LTS 版(如v2407.40000.4.0_v2)。解压并放置文件夹。用 7-Zip 解压 .7z 包,把解压出来的文件夹重命名为
WSA(⚠️ 名称里不要带空格和特殊字符),然后移到非系统盘根目录,例如D:\WSA。路径短能避免"路径过长"类的启动失败。双击
Run.bat。脚本会以管理员权限执行安装,遇到 UAC 提示点"是"。装完后开始菜单里会出现 "Windows Subsystem for Android" 图标,首次启动需要初始化,耐心等几分钟。
✅ 看到安卓界面亮起,你就成功了。接下来才轮到查环境和调配置。
安装失败时:先对照这张系统前置检查表
如果Run.bat弹一下就闪退、或报虚拟化相关错误,大概率是下面某项没满足。逐项过一遍:
| 检查项 | 要求 | 备注 |
|---|---|---|
| Windows 11 版本 | Build 22000.526 及以上 | 定制系统(ReviOS、Tiny 10/11 等)可能不兼容,建议原版 Windows |
| Windows 10 版本 | 22H2 10.0.19045.2311 及以上 | 更老的 20H1 需先装补丁才可能有戏 |
| 内存 | 最低 8GB,推荐 16GB | 4~6GB 能跑但不推荐 |
| 存储 | SSD 优先,至少 10GB 可用空间 | 分区必须是NTFS,不支持 exFAT |
| 处理器 | x86_64 或 arm64,支持虚拟化 | Win11 机型建议不低于 i3 8 代 / Ryzen 3000 / 骁龙 8c |
| 显卡 | Intel / AMD / Nvidia 均可 | Intel HD 530 及更早的核显容易图形异常,见后文调优部分 |
然后以管理员身份打开 PowerShell,确认两个关键功能已开启:
dism /online /enable-feature /featurename:VirtualMachinePlatform /all dism /online /enable-feature /featurename:HypervisorPlatform /all执行完重启电脑。同时进 BIOS/UEFI 确认虚拟化已开启(Intel 平台叫 VT-x,AMD 平台叫 SVM)。也可以直接按Win + R输入OptionalFeatures.exe,在图形界面里勾选这两项。
版本怎么选:LTS 与非 LTS 一张表看懂
WSABuilds 同时维护两条发布线,文件名和版本号直接决定了你拿到的是什么:
| 对比维度 | LTS 版 | 非 LTS 版 |
|---|---|---|
| 当前版本 | v2407.40000.4.0_LTS_7 | v2407.40000.4.0_v2 |
| 更新节奏 | 每月一次 | 每月多次 |
| Root 方案 | 带 GApps 的构建默认捆绑 Magisk | 可选择不捆绑 Magisk 的构建 |
| 适合谁 | 日常使用、办公、求稳 | 开发测试、追新特性 |
| 架构 | x86_64 与 arm64 | x86_64 与 arm64 |
下载时认准文件名里的关键字:带MindTheGapps的是含 Google Play 的构建,带NoGApps的没有,带AMZ/Removed AMZ的表示是否保留 Amazon Appstore。
⚠️ 一个需要知道的现状:项目 README 提示,2025 年 6 月之后 GApps 构建在 Windows 11 上出现过崩溃问题。如果你中招,临时方案是换成文件名含NoGApps的构建,或使用更老的 2211 / 2210 版本构建,并关注仓库内 issue 的修复进展。
自动安装没反应?走手动注册这条路
Run.bat本质是帮你执行管理员权限下的安装脚本。如果弹窗一闪而过、WSA 没装上,手动来:
按
Win + X,选择Windows Terminal(管理员)。进入你的 WSA 文件夹并执行安装脚本:
cd "D:\WSA" # 替换为你的实际路径 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1如果还是失败,可以手动注册包并拿日志定位原因(需要管理员权限):
Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID <uuid>第一条命令会失败并返回一个 ActivityID(UUID),把它填进第二条命令查详细日志,按日志提示修。若手动注册也不行,基本可以判定这台机器不支持跑 WSA。
按你的身份选配置:开发 / 日常 / 企业三档
装好只是开始,下面三档配置对号入座:
开发者档
- 选非 LTS 版,拿最新 API 支持
- 打开 Windows 设置 > 系统 > 开发者选项
- 用 ADB 连上子系统:
adb connect localhost:58526,配好 Android Studio 即可深度调试
日常用户档
- 选LTS 版 + GApps 构建,装好直接进 Google Play
- 在 WSA 设置里开启文件共享,方便 PC 与安卓侧传文件
- 有独显的机器确认 WSA 走的是独显渲染,图形性能更好
企业用户档
- 参照 Documentation/WSABuilds/Custom Builds.md 制作企业定制构建
- 规划多实例与数据隔离
- 把
userdata.vhdx纳入定期备份策略,路径见下节
想继续深究某一档的细节,项目文档里有完整的安装与使用指南:Documentation/WSABuilds/Installation.md、Documentation/WSABuilds/Usage Guide.md。
让 WSA 长期好用:调优与数据保护
调资源分配。打开 WSA 设置 > 系统 > 资源:CPU 建议给 4 核及以上,内存推荐 8GB,虚拟硬盘(vhdx)建议 64GB。改完重启 WSA 生效。
老显卡图形异常就换渲染器。如果你用的是 Intel HD 530 及更早的核显(或部分 Nvidia 显卡出现花屏、WSA 起不来),按 Documentation/Usage Guides/General Usage Guides/ChangingGPU.md 切换到你机器的独显、第二核显,或退回 Microsoft Basic Renderer。
更新构建时保留数据。更新流程是:在 WSA 设置里点 "Turn off" 完全关闭子系统 → 用 7-Zip 打开新版 .7z,把包内子文件夹里的文件解压合并到你原来的 WSA 目录,全部选择"替换" → 重跑
Run.bat。你的应用和数据会保留,最后到设置的 About 页核对版本号即可。步骤细节见 Documentation/WSABuilds/Updating.md。备份关键文件。WSA 的全部用户数据集中在一个文件里:
%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx重装、迁移、大版本更新前把它拷走,装完拷回去即可无损恢复。
⚠️一条铁律:WSA 的 WSA 安装文件夹不能删除、不能移动。因为Add-AppxPackage -Register注册的是"未打包文件",运行时依赖原始路径下的文件,动过位置就只能重新走安装流程。
高频故障速查表
| 症状 | 排查动作 |
|---|---|
| 安装报虚拟化相关错误(如 0x80073CF6 一类) | 先确认 BIOS 虚拟化和 Optional Features 两项都开了;仍不行就卸载后在"启用或关闭 Windows 功能"里先关掉Hyper-V、Virtual Machine Platform、Windows Hypervisor Platform、WSL 再重装,参考 Documentation/Fix Guides/Post-Install Issues/FixVirtError.md |
| 提示"路径过长"或解压失败 | WSA 文件夹挪到盘符根目录(如D:\WSA),目录名不超过 8 个字符,别嵌套目录,参考 Documentation/Fix Guides/Pre-Install Issues/FixPathTooLong.md |
adb connect localhost:58526连不上 | 先确认开发者模式已开启;还不行就到 WSA 设置 > 开发者页看实际 IP,改用adb connect ip:5555 |
| 应用闪退 / 卡在启动画面 | 确认应用架构兼容、WSA 版本满足其最低要求;再试 设置 > 应用 > 清除数据,参考 Documentation/Fix Guides/Post-Install Issues/ 下的对应文档 |
| Google Play 连不上网 | 检查 Windows 代理设置,必要时在 WSA 设置里重置网络,参考 Documentation/Fix Guides/Post-Install Issues/FixInternet.md |
| 卸载不干净 | 先关闭 WSA,通过"添加或删除程序"卸载,然后删掉 WSA 文件夹,最后检查%LOCALAPPDATA%\Packages\下MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe是否残留,残留就删,流程见 Documentation/WSABuilds/Uninstallation.md |
从 10 分钟装好第一个 WSA 实例,到按身份调档、数据备份、故障速查,WSABuilds 能把"在 Windows 上稳定跑安卓"这件事的门槛压得很低。装好后如果还想深挖 Magisk 模块、KernelSU 提权或自定义构建,Documentation/目录下的各篇指南都值得一读;遇到仓库没覆盖的问题,到项目社区(Discord / Issues)里问,往往有人遇到过同样的坑。
【免费下载链接】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),仅供参考