WSABuilds 实操指南：在 Windows 上跑通带 Google Play 商店和 Magisk Root 的 WSA

WSABuilds 实操指南在 Windows 上跑通带 Google Play 商店和 Magisk 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微软已经为 Windows Subsystem for Android简称 WSA画上了句号官方支持在 2025 年 3 月 5 日结束商店版 WSA 也随之停止更新。想继续在 Windows 上跑 Android 应用还想要 Google Play 商店、还想要 root 权限WSABuilds 是目前社区最成熟的答案——它提供一套预构建的 WSA 二进制包内置 MindTheGappsGoogle 服务框架和 Magisk 或 KernelSU下载 .7z 解压后跑一个脚本就能装好。这篇文章按你实际会遇到的顺序来写先判断适不适合你再走安装路径然后是日常用法、常见故障的排查顺序以及更新和数据备份的完整闭环。所有步骤都基于仓库内的官方文档命令可以直接复制。1. 30 秒速览这个项目适不适合你项目说明适合谁想在 Windows 10/11 上运行 Android 应用且需要 Google Play 商店或 root 权限的用户系统要求Windows 11Build 22000.526 及以上或 Windows 10 22H210.0.19045.2311 及以上x86_64 或 arm64 架构硬件要求内存 8GB 起推荐 16GBC 盘至少 10GB 空闲NTFS 分区BIOS/UEFI 中开启虚拟化磁盘分区仅支持 NTFS不支持 exFAT亮点预构建 .7z 免手动拼装内置 MindTheGapps 与 Magisk/KernelSULTS 构建持续更新 Magisk、KernelSU 和 GApps 版本代价安装文件夹必须保留不能删官方 WSA 必须先完全卸载两个前置提醒来自仓库 README 的明确说明如果你已经装过商店版 WSA必须先完全卸载否则无法安装。如果你在用 ReviOS、Tiny 10/11、Ghost Spectre 这类精简/定制版 Windows大概率跑不起来仓库没有提供修复方案。2. 它能做什么为什么能做到用一句话概括WSABuilds 不是给你一个App 安装包而是把整个 WSA 子系统Android 运行时 libhoudini 二进制翻译层 Google 服务 root 方案打包成现成文件用Run.bat完成注册。原理上有一个关键点值得理解它能解释后面几乎所有为什么Install.ps1的核心动作是Add-AppxPackage -Register .\AppxManifest.xml即把已经解压好的散装文件注册成一个 Appx 包。所以安装文件夹就是你的系统文件删掉它 WSA 就废了——这不是警告是机制。ARM 应用能跑靠的是包里的 libhoudini 翻译层源码在 MagiskOnWSA/libhoudini/在 x86 CPU 上翻译 ARM 指令。系统分区在 Hyper-V 下是只读的你不能直接 remount 成读写。想做系统级修改正确姿势是装 Magisk 模块或改 system.img——这也是 root 方案内置的原因。一个可以落地的类比官方 WSA 像应用商店里装的 AppWSABuilds 像你自己拿着完整的源码目录手动注册给系统。好处是可定制root、自定义 GApps代价是目录不能删、更新要手动。安装脚本和工具都在 MagiskOnWSA/installer/包含 x64 和 arm64 两套Install.ps1与Run.bat。3. 上手路径从 0 到能打开 Play 商店3.1 准备阶段所有人不可跳过打开 Windows 功能开关。按 WinR 输入OptionalFeatures.exe确认勾选了Virtual Machine PlatformWindows Hypervisor Platform再确认 BIOS/UEFI 里虚拟化已开启任务管理器 → 性能 → CPU → 虚拟化已启用。两个容易踩的坑Windows 10 老版本20H1 10.0.19041.264 及以上可能先打补丁 KB5014032 和 KB5022834 才能用 WSA具体以仓库最新说明为准。安装路径要短。解压出来的文件夹必须重命名为WSA长路径名会导致 WSA 无法启动这是仓库标注的已知问题。3.2 下载与解压从项目 Releases 页面下载对应系统的 .7zWindows 10/11x64/arm64 都有注意别下Source code。解压把解压出的文件夹重命名为WSA删除 .7z 压缩包。把文件夹放到一个你确定不会删的路径官方文档建议放文档目录。体积为几个 GB以 Releases 页面实际大小为准。如果你更习惯从仓库取源码例如想跑 MagiskOnWSALocal 脚本做自定义构建git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds3.3 安装进入 WSA 文件夹双击Run.bat。脚本会自动完成注册并尝试安装。如果弹窗一闪而过、WSA 没有装上执行策略或权限问题用管理员 PowerShell 手动跑cd X:\你的路径\WSA PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1第一句进入你的安装目录第二句绕过执行策略限制运行安装脚本。加-ExecutionPolicy Bypass是因为企业策略常把 .ps1 默认禁用。如果这样仍然失败仓库的结论是这台 PC 不支持 WSA。3.4 首次验证安装完成后 WSA 会自动启动。首次安装会弹出诊断信息同意窗口可能出现两个一模一样的窗口点两次 OK 即可属正常现象。在 PowerShell 窗口按任意键关闭窗口再关掉文件资源管理器。验证三件事WSA 桌面能进Play 商店能打开GApps 构建Magisk 能获取 rootMagisk 构建。打开Windows Subsystem for Android 设置应用 → 关于页确认版本号符合预期。详细步骤见 安装文档。4. 玩法与进阶按场景走4.1 日常使用装应用、连电脑装 APK三条路可选文档都写好了——ADB 侧载、WSA-Sideloader 图形化工具、WSAPacman 命令行工具。总入口见 侧载指南。快速启动 App用微软的 URI 方案在 Windows 的运行或快捷方式里输入wsa://包名例如wsa://com.android.vending直接拉起 Play 商店。让电脑浏览器访问 WSA 里的本地服务WSA 默认网络是隔离的开启 LocalHost Loopback 后 127.0.0.1 双向可达方法见 LocalHostLoopback.md。adb 连不上 localhost:58526先确认 WSA 设置里开了开发者模式还不行就去设置 → 开发者页看实际 IP然后adb connect ip:5555。应用能不能跑仓库维护了一张很长的实测兼容表应用 游戏标注了需要 GMS 的条目动手前先查 App Compatibility.md比装完再后悔省事。常见误区把应用列表里图标缺失当系统坏了——多数是 launcher 的已知显示问题有专门的修复文档MissingIcons。4.2 深度定制root 玩法的边界装 Magisk 模块Magisk 的在线模块仓库已被官方移除列表是空的属正常。正确做法是本地安装adb push module.zip /data/local/tmp adb shell su -c magisk --install-module /data/local/tmp/module.zip换 root 方案内置 Magisk 和 KernelSU 二选一。要换 KernelSU 按 KernelSU 指南 操作不同 root 方案 不同 GApps 组合的对应文档在 Post-Installation Guides 下按组合分好目录了。系统分区只读是 Hyper-V 层面的限制没有绕过开关。想改系统行为走 Magisk 模块。诚实的边界虚拟机没有 Google 签名过不了 SafetyNet / Play Integrity这是架构决定不是配置问题。对银行类、反作弊严格的应用别指望 root 能解决。GApps 不能中途换OpenGApps 和 MindTheGapps 不能切换要换就完整卸载重装。4.3 性能调优先动 GPU再动内存显卡兼容性这是 WSA 头号性能变量。Intel HD Graphics 530 及更早的核显、部分 Nvidia 显卡会出现 WSA 不启动或花屏。处理方式是切换到另一块独显/核显或 Microsoft Basic Renderer步骤见 ChangingGPU.md。资源分配WSA 设置应用里可以调 CPU 和内存上限跑大内存游戏再往上加日常使用不用动。存储SSD 是仓库明确推荐的HDD 标注为不推荐因为 userdata.vhdx 的随机读写性能直接影响应用启动速度。5. 避坑手册症状 → 定位 → 处理5.1 症状双击 Run.bat 没反应WSA 没装上定位两种可能——当前用户没有管理员权限或 PowerShell 执行策略拦截了 .ps1。处理WinX 打开Windows 终端(管理员)执行 3.3 节的两条命令。若报注册失败用下面两条命令拿到真正的失败原因Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID 上一步报错里的UUID第一条故意会失败并返回 ActivityID第二条打印该次操作的完整日志。按日志里的具体错误码查文档。5.2 症状报错 0x80073CF0 / CF6 / CF9 / CFB / CFD / 0x80073D10 这一串这些错误都发生在 Appx 注册阶段仓库为每个码都写了独立修复文档按报错对照查即可0x80073CF0、0x80073CF6、0x80073CF9、0x80073CFB、0x80073CFD、0x80073D10高频共性原因先自查三件事Windows 功能没开全、安装文件夹没重命名为WSA/ 路径太长路径过长修复、没用管理员身份运行。另有 0x80073B17NamedResource Not Found 是资源缺失类问题。5.3 症状WSA 装了但起不来或设置应用闪退这类问题覆盖无闪屏设置崩溃 应用不加载WSA 突然罢工三种表现仓库的 Post-Install Issues 目录逐一对应无闪屏、设置崩溃、突然停止工作。总索引见 Troubleshooting.md。5.4 症状Windows 11 上 Play 商店/GApps 崩溃这是仓库 README 顶部用大字号标注的当前已知问题2025 年 6 月之后的 Windows 11 构建上带 GApps 的构建会出现崩溃官方修复正在进行中。两个现行方案按 README 给出的规避步骤处理 GApps 构建见项目 README 的 CAUTION 区块直接用文件名带NoGApps的构建——不带 Google 服务的版本不受影响。另外 2211/2210 的老版本 WSA 构建被确认仍可正常工作可作为过渡选择。5.5 症状解压失败、安装目录被网络策略拦截公司网络或安全软件环境常见。对号文档解压错误、网络安全设置拦截、Install.ps1 失败。6. 长期维护更新、备份、回滚的完整闭环6.1 升级数据会保留官方更新流程详见 Updating.md在 WSA 设置里点Turn off等转圈消失。确认 WSA-Sideloader 之类工具没有在后台运行。下载新版 .7z打开它进入里面的子文件夹形如WSA_2xxx.xxxxx.xx.x_xx。全选子文件夹内文件覆盖解压到你现有的 WSA 安装目录提示替换时全部选是。重新运行Run.bat。脚本会自动卸载旧版、保留用户数据、安装新版。在设置应用 → 关于页核对版本号。关于 LTS官方 WSA 停止支持后WSABuilds 对 WSA 2311.40000.5.0 及以上版本进入了长期支持模式——Magisk、KernelSU、GApps 版本会通过新 Release 持续更新。更新频率和版本号以 Releases 页面为准。6.2 备份回答数据会不会丢会。你的应用和数据全部在一个虚拟磁盘文件里%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx备份关闭 WSA 后把userdata.vhdx拷走。完整流程见 Backup and Restore.md。恢复在装好新版之后做先彻底移除旧 WSA如果还在。打开安装目录里的Install.ps1删掉里面Start-Process wsa://...那几行根据构建类型可能是 com.android.settings、com.topjohnwu.magisk 等文档列了每种构建对应的行。运行脚本弹出的一堆对话框全部忽略不要点。把你的 userdata.vhdx 放回上面的LocalCache目录关掉弹窗启动 WSA。6.3 卸载关闭 WSA。在添加/删除程序里卸载 Windows Subsystem for Android。删除 WSA 安装文件夹。检查%LOCALAPPDATA%\Packages\下是否残留MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe文件夹在则删除删不掉就先确认 WSA 已完全关闭。完整步骤见 Uninstallation.md。想清装前永远先做 6.2 的备份。7. 生态与社区问题反馈在项目的 Issues 里提交写清系统版本、WSA 版本、构建类型GApps/NoGApps、Magisk/KernelSU和日志。日志获取adb logcat或翻 Windows 侧%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat。社区项目维护了 Discord 社区、XDA Developers 版块和 r/WSA subreddit遇到文档没覆盖的情况去这三处问效率最高具体入口见项目 README。文档入口FAQ、使用指南总览、项目状态与版本支持表。8. 收尾WSABuilds 的价值一句话在官方 WSA 停更之后它用预构建 一个脚本的方式保住了 Windows 上能装 Play 商店、能 root的 Android 子系统这条路。接下来可以做的 3 件事按 3.1–3.4 装好先用 兼容表 查一遍你目标应用再动手装。备份一次userdata.vhdx到第二块盘把数据会不会丢从问题变成不是问题。遇到 GApps 崩溃Windows 11 用户先看 5.4 节再决定是否切到 NoGApps 构建。【免费下载链接】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），仅供参考