WSABuilds 完整部署指南:10 分钟在 Windows 上跑起带 Root 的安卓子系统
2026/9/9 13:19:14 网站建设 项目流程

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 步完成最小安装

别急着看配置清单,先把环境立起来。整个过程只需要三步:

  1. 拿到安装包。克隆项目仓库,从项目的 Releases 页面下载对应你系统的预编译 .7z 包:

    git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds

    版本选择建议:优先 LTS 版(版本号形如v2407.40000.4.0_LTS_7),稳定性更好;想尝鲜新特性再选非 LTS 版(如v2407.40000.4.0_v2)。

  2. 解压并放置文件夹。用 7-Zip 解压 .7z 包,把解压出来的文件夹重命名为WSA(⚠️ 名称里不要带空格和特殊字符),然后移到非系统盘根目录,例如D:\WSA。路径短能避免"路径过长"类的启动失败。

  3. 双击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,推荐 16GB4~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_7v2407.40000.4.0_v2
更新节奏每月一次每月多次
Root 方案带 GApps 的构建默认捆绑 Magisk可选择不捆绑 Magisk 的构建
适合谁日常使用、办公、求稳开发测试、追新特性
架构x86_64 与 arm64x86_64 与 arm64

下载时认准文件名里的关键字:带MindTheGapps的是含 Google Play 的构建,带NoGApps的没有,带AMZ/Removed AMZ的表示是否保留 Amazon Appstore。

⚠️ 一个需要知道的现状:项目 README 提示,2025 年 6 月之后 GApps 构建在 Windows 11 上出现过崩溃问题。如果你中招,临时方案是换成文件名含NoGApps的构建,或使用更老的 2211 / 2210 版本构建,并关注仓库内 issue 的修复进展。

自动安装没反应?走手动注册这条路

Run.bat本质是帮你执行管理员权限下的安装脚本。如果弹窗一闪而过、WSA 没装上,手动来:

  1. Win + X,选择Windows Terminal(管理员)

  2. 进入你的 WSA 文件夹并执行安装脚本:

    cd "D:\WSA" # 替换为你的实际路径 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1
  3. 如果还是失败,可以手动注册包并拿日志定位原因(需要管理员权限):

    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 长期好用:调优与数据保护

  1. 调资源分配。打开 WSA 设置 > 系统 > 资源:CPU 建议给 4 核及以上,内存推荐 8GB,虚拟硬盘(vhdx)建议 64GB。改完重启 WSA 生效。

  2. 老显卡图形异常就换渲染器。如果你用的是 Intel HD 530 及更早的核显(或部分 Nvidia 显卡出现花屏、WSA 起不来),按 Documentation/Usage Guides/General Usage Guides/ChangingGPU.md 切换到你机器的独显、第二核显,或退回 Microsoft Basic Renderer。

  3. 更新构建时保留数据。更新流程是:在 WSA 设置里点 "Turn off" 完全关闭子系统 → 用 7-Zip 打开新版 .7z,把包内子文件夹里的文件解压合并到你原来的 WSA 目录,全部选择"替换" → 重跑Run.bat。你的应用和数据会保留,最后到设置的 About 页核对版本号即可。步骤细节见 Documentation/WSABuilds/Updating.md。

  4. 备份关键文件。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),仅供参考

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

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

立即咨询