WSABuilds 完整指南：WSA 终止服务后，在 Windows 10/11 上继续运行 Android 应用

WSABuilds 完整指南：WSA 终止服务后，在 Windows 10/11 上继续运行 Android 应用

【免费下载链接】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

微软 WSA 停止服务，还能不能继续在 Windows 上用 Android 应用

2025 年 3 月 5 日起，微软正式结束对 Windows Subsystem for Android（简称 WSA）的支持，Amazon Appstore 及所有依赖 WSA 的应用不再获得官方更新。对于已经在 Windows 上装着 Android 应用的用户，直接卸载意味着应用、账号、存档全部清零。

WSABuilds 就是这个背景下出现的开源方案：它提供一组预构建二进制包（prebuilt binaries），让你在 Windows 10 和 Windows 11 上自行部署 WSA，并且内置可选组件——Google Play 商店与 Google 服务（MindTheGapps）、Magisk 或 KernelSU 两种 root 方案，还可以选择移除 Amazon 应用商店。项目已进入长期支持（LTS）阶段，维护者会持续通过新版本发布来跟进 Magisk、KernelSU 和 GApps 的更新，仓库不会归档。

和普通"官方 WSA 安装包"相比，它给你带来的直接价值是：

• 不受商店限制：官方 WSA 只能从 Microsoft Store 获取，且已下架；WSABuilds 以本地文件注册应用包的方式安装，组件全由社区维护。
• 功能可组合：root、Google 服务、商店都是独立选项，按需要挑选构建版本，而不是被捆绑。
• 数据可迁移：整个 Android 环境的数据都在一个userdata.vhdx虚拟磁盘里，备份、还原、换机都靠它。

先说一个当前状态提醒：README 置顶说明，2025 年 6 月之后的 Windows 11 版本上，带 GApps 的构建存在崩溃问题，维护者正在修复。如果你装的是带 Google 服务的版本且遇到崩溃，建议先用文档给出的临时方案，或改选文件名中带NoGApps的构建。完整问题记录见 Installation.md 与项目页的置顶公告。

检查电脑配置，选对 WSABuilds 构建版本

安装前先核对硬件与系统要求，大部分失败都出在这一步。要求来自 README.md：

两点补充：精简魔改系统（如 Tiny 10/11 一类）可能无法运行 WSA；winver可以查看你的系统版本号。虚拟化功能可在"可选功能"里勾选开启，安装脚本 installer/Install.ps1 也会协助处理。

构建版本按功能组合命名，选包时看三个要素：

• 是否含 GApps：想装 Google Play 商店选 MindTheGapps 包；不需要就选NoGApps包（也是当前 Windows 11 崩溃问题的规避方案）。
• root 方案：Magisk、KernelSU 或无 root。注意 GApps 构建默认捆绑 Magisk；不想要 Magisk 的选非 LTS 发布。
• 是否保留 Amazon 应用商店：文件名带RemovedAmazon表示已移除。

仓库还维护了 旧版本构建列表，需要历史 WSA 版本时可查。

三步完成 WSABuilds 安装

安装文档在 Documentation/WSABuilds/Installation.md。如果你装过官方版 WSA 或旧版 WSABuilds，先彻底卸载（保留数据的方法见下文备份章节）。

第 1 步：获取安装文件

到项目 Releases 页下载对应操作系统的.7z包（区分 Windows 10/11、x64/arm64，不要下 "Source code"）。也可以克隆仓库获取项目文件：

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

第 2 步：解压并固定位置

用 7-Zip 解压后，把解压出来的文件夹重命名为WSA（原文件夹名过长会导致 WSA 无法启动），然后放到一个长期保留的位置（如文档目录）。注意：这个文件夹不能删，它被注册为应用包后是 WSA 运行的一部分。

第 3 步：运行 Run.bat

双击文件夹里的Run.bat即可。脚本会自动启用虚拟化相关功能、注册应用包并拉起 WSA。首次安装会弹出诊断信息同意窗口，点确定即可。

如果Run.bat窗口一闪而过且安装失败，用管理员 PowerShell 手动执行：

cd "{X:\path\to\WSA}" PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

安装完成后，开始菜单会出现 WSA 设置入口，能打开 Android 界面即成功。

首次启动后的日常使用

装好只是开始。WSA 是一个独立窗口里的 Android 环境，日常使用集中在四件事上，指南都放在 Documentation/Usage Guides/ 下：

• 侧载 APK：Play 商店装不到的应用（国内应用、Mod 版等）直接侧载。仓库提供了多种途径的文档：ADB 侧载、WSA-Sideloader 工具、WSAPacman 包管理器。
• 切换 GPU：多显卡机器上默认分配的显卡若导致无法启动或花屏，可按 ChangingGPU.md 手动指定集成显卡、独显或 Microsoft Basic Renderer。
• 移动安装位置：C 盘紧张时，可参照 MoveToExtDrive.md（含中文版 MoveToExtDrive_CN.md）把 WSA 数据迁到其他分区。
• localhost 回环：想让 Windows 上的服务被 Android 应用通过localhost访问，按 LocalHostLoopback.md 配置。

另外两个实用细节：

• 用wsa://应用包名可以直接从 Windows 拉起指定应用，例如wsa://com.android.settings打开 Android 设置。
• ADB 连接localhost:58526连不上时，先确认已开启 WSA 设置里的开发者模式，然后去"开发者"页看实际 IP，用adb connect IP:5555连接。

root、Play 商店、商店组合：按需挑选

WSABuilds 的构建把 root 与 Google 服务解耦，理解命名就能自己选包：

root 的作用和普通 Android 一致：Magisk 通过系统无关（systemless）方式在中间层修改系统行为，不改系统分区本身；Magisk 的 DenyList 可以隐藏 root 以通过部分应用的环境检测。KernelSU 的单独安装步骤见 KernelSU.md。装完 root 后，仓库的 MagiskOnWSA 目录就是整套适配方案的载体，其中 scripts/ 存放了构建用的提取与链接生成脚本，installer/ 是分架构的安装脚本。

两个使用限制需要知道：

• 不能通过 SafetyNet / Play Integrity：虚拟机没有 Google 签名，这类校验天然无法通过，依赖它们的应用（部分银行、游戏）会拒登。
• GApps 之间不能热切换：OpenGApps 和 MindTheGapps 不能互相替换，切换必须先完整卸载再重装。

如果现成构建不满足需求（比如想要特定 Magisk 版本、特定设备模型），可以在项目 Issues 页提交自定义构建请求，说明设备型号、root 方案、Magisk 变体、是否要 GApps 和 Amazon 商店即可，文档见 Custom Builds.md。

无数据丢失更新，以及 userdata.vhdx 备份

WSA 本体、Magisk、GApps 的更新方式是同一套流程，核心思路是"合并文件夹 + 重新注册"，数据全部保留在userdata.vhdx里。

更新步骤（依据 Updating.md）：

1. 在 WSA 设置里点"Turn off"，等加载图标消失，确认 WSA 完全关闭，且没有 WSA-Sideloader 等工具在运行。
2. 下载新构建包，解压后把其中的子文件夹里的全部文件解压到现有 WSA 文件夹，覆盖提示选"全部替换"。
3. 重新运行Run.bat。
4. 打开 WSA 设置 → About，核对版本号是否为目标版本。

备份与还原（依据 Backup and Restore.md）：

• 备份：复制%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx到安全位置，这个文件包含全部应用与数据。
• 还原：先卸载 WSA，把备份文件放回原目录，再运行Run.bat安装。期间弹出的对话框忽略即可，不要点击。

卸载（依据 Uninstallation.md）：关闭 WSA → 在"添加或删除程序"中卸载 Windows Subsystem for Android → 删除 WSA 安装文件夹 → 到%LOCALAPPDATA%\Packages\下删除残留的MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe文件夹。想留数据就先备份 vhdx。

WSA 打不开？按这个顺序自查

遇到问题时按 Troubleshooting.md 的思路走：先查常见错误列表，再判断是自己的环境问题还是构建问题。常见症状与对应文档：

自查顺序建议：

1. 确认虚拟化在 BIOS 和 Windows 可选功能里都已开启（脚本提示后需重启再重跑）。
2. 确认 WSA 文件夹名就是WSA、位于 NTFS 分区。
3. 显卡问题按 ChangingGPU.md 换一张卡试试。
4. 还不确定原因时，可先装一份官方渠道的 WSA 对比测试：官方版也起不来，基本可以锁定是系统/硬件环境问题。

更多问题细节（ADB 连接、logcat 获取位置、Magisk 模块安装等）见 FAQ.md 和 Having Issues.md。

【免费下载链接】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