阿超 > WSABuilds

WSABuilds

2025-11-27

android

成功的关键在于相信自己能够成功。——斯坦福

WSABuilds：把 Android「带到」Windows 10/11（自带 Play 商店与 Root 能力）的那把“瑞士军刀”

仓库：MustardChef/WSABuilds
许可证：AGPL-3.0
关键词：WSA、Windows 10/11、Google Play（MindTheGapps）、Magisk、KernelSU、WSAPatch

想要在 Windows 上丝滑体验 Android 应用？想要开箱即用 Google Play？想要 Root 能力（Magisk/KernelSU）做更深度的系统级探索？WSABuilds 正是面向这些真实痛点打磨的“预构建发行”。它通过已经打包好的 WSA（Windows Subsystem for Android）组件，帮助你在 Windows 10 与 Windows 11 机器上快速落地功能齐全的 Android 运行环境。

这篇“上手+进阶”式文章，带你从项目定位、环境要求、安装更新、备份迁移到常见问题排查，一步步把 WSABuilds 真正跑起来。

1. WSABuilds 到底做了什么？

根据仓库描述与附带文档，WSABuilds 的目标非常明确：

  • 在 Windows 10/11 上运行 WSA（Windows Subsystem for Android）
  • 提供包含 Google Play（MindTheGapps）的一体化构建
  • 集成 Root 能力：Magisk 或 KernelSU（二选一或按需）
  • 借助社区成熟方案（如 MagiskOnWSA / WSA-Script / WSAPatch 等）降低“高门槛”工作量

简而言之：你不再需要自己一步步改镜像、打补丁、装 GApps、集成 Root——WSABuilds 已经把关键事情做到了“可复制”的程度。

提醒：文档中提到“Magisk on WSA 将在 2025-03-05 后不再可用”（参考微软 WSA 相关公告）。请以项目与微软生态的最新说明为准，及时调整你的方案与版本选择。

2. 环境与依赖——先检查好你的 Windows

文档对“最低可用”与“推荐”配置给出了清晰边界：

  • 操作系统版本
    • Windows 11：Build 22000.526 或以上
    • Windows 10：22H2（10.0.19042.2604）或以上（使用 WSA 需安装 KB5014032）
  • 内存
    • 8 GB（最低）/ 16 GB（推荐）
  • 存储
    • 建议 SSD
    • C 盘至少 10GB 可用空间
    • 仅支持 NTFS 分区（不可安装在 exFAT 等）
  • 处理器与虚拟化
    • 满足 Windows 11 的基本 CPU 要求（如 i3 8th Gen/ Ryzen 3000 / Snapdragon 8c 或以上）；Windows 10 上“命中”则需以文档要求为准
    • 必须开启虚拟化（BIOS/UEFI + Windows 可选功能）
  • Windows 功能（至少）
    • Virtual Machine Platform（必需）
    • （可选）Windows Hypervisor Platform / WSL / Hyper-V

如果你是 Windows 10 用户，可能需要借助 WSAPatch 提供的指南/文件，使 WSA 在 Win10 上更好运行。

3. 安装：最省事的那条路

整体流程（基于仓库文档里的步骤）：

  1. 前往 Releases（或项目文档指定下载源）下载对应版本的预构建包
  2. 校验文件完整性（文档提供 Checksum 指南）
  3. 解压到一个你想永久保留的位置（很重要，WSA 的注册方式决定“安装目录”必须常驻）
  4. 双击运行 Run.bat 完成注册与安装
  5. 首次安装会弹出诊断信息授权；之后 WSA 设置应用会自动启动

遇到 UAC 权限对话框不出现，或窗口一闪而过的情况，按文档的“Plan B”来：

1
2
3
4
5
6
7
8
# 1) 以管理员权限打开 Windows Terminal（PowerShell）
# Win + X 打开系统菜单，选择 “Windows Terminal（管理员）”

# 2) 切换到解压目录（替换花括号内为真实路径）
cd "{X:\path\to\your\extracted\folder}"

# 3) 绕过脚本执行策略并安装
PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

不要删除安装目录！
WSA 在 Windows 中是通过注册已有文件的方式（AppxPackage Register），你删除目录就相当于“把地基挖空了”。

4. 更新：不丢数据地“以旧换新”

当有新版本 WSA/Magisk 可用时，文档建议：

  1. 关闭 WSA（设置里“Turn off”并等待）
  2. 下载新构建，解压到“原有安装目录”，允许“覆盖同名文件/文件夹”
  3. 再次运行 Run.bat（或按需执行 Install.ps1）
  4. 打开 WSA 设置 → About，确认版本号已更新

这样做会保留应用与数据（User Data 分区不受影响）。

5. 卸载与迁移：做个干净利落的人

  • 卸载 WSA（官方/自定义）：

    1. 确认 WSA 未运行
    2. 在“应用和功能”里卸载 “Windows Subsystem for Android 设置”
    3. 删除安装目录
    4. 删除 %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe

  • 备份 / 迁移数据（强烈建议！）：
    核心文件是 userdata.vhdx

    1
    %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx

    迁移步骤大意为：卸载 → 清理 → 重新注册安装 → 在首次启动前把备份恢复回相同路径 → 再启动 WSA

6. 急救箱：这些命令值得收藏

  • 注册 Appx 包并查看失败日志（排障必备）

    1
    2
    # 在安装目录中管理员 PowerShell 执行，通常失败会返回 ActivityID（UUID）
    Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

带上上一步返回的 UUID 查看详细失败原因

Get-AppPackageLog -ActivityID 

1
2
3
4
5
6
7
8
9
10
- ADB 日志与连接
```bash
# 方式一：直接拉起 logcat（前提是已启用开发者模式）
adb logcat

# 方式二：从 WSA 本地存储读取日志文件
# %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat

# 连接 WSA（如果 localhost:58526 不通，查看 WSA Settings → Developer 的 IP）
adb connect ip:5555

  • 手动安装 Magisk 模块（因为线上仓库已下线）

    1
    2
    adb push module.zip /data/local/tmp
    adb shell su -c magisk --install-module /data/local/tmp/module.zip

7. 常见问题速览（基于文档要点汇总）

  • Q：能通过 SafetyNet / Play Integrity 吗？
    A：不行。WSA 属于虚拟化环境，没有 Google 的官方签名，机制层面无法“原生通过”。

  • Q：能把 system 分区重新挂载为读写吗？
    A：不行。WSA 的系统分区由 Hyper-V 只读挂载。可通过 Magisk 模块或直接修改系统镜像来实现定制。

  • Q：连不上 localhost:58526？
    A：启用开发者模式，查看 WSA Settings → Developer 的 IP 地址，用 adb connect ip:5555 尝试直连。

  • Q：虚拟化没开？
    A：脚本可引导开启 Windows 可选功能；若仍失败，请在 BIOS/UEFI 开启 CPU 虚拟化选项，之后重启并重装。

  • Q：为什么不能删安装目录？
    A：WSA 在 Windows 中是“注册现有文件”的模式（不是 MSI/EXE 把文件“装”进系统），删除目录会导致“挂载点”失效。

8. 语言与 Root 选择：GApps、Magisk、KernelSU

  • GApps：项目采用 MindTheGapps 以接入 Google Play 生态（Play 商店、GMS 服务）
  • Root：Magisk 与 KernelSU 二者都可以作为 Root 方案（按需选择）
  • 通用改造：
    • 可移除 Amazon Appstore
    • 修复 VPN 对话框（通过专门的 VpnDialogs app）
    • 提供设备管理能力
    • 合并语言包、无人值守安装、保留数据一键升级

这些“工程化细节”让 WSA 的使用体验更接近“能长期作为主力环境”。

9. 给 Windows 10 用户的补充：WSAPatch 的位置

仓库里清晰引用了 WSAPatch 的发布页。该项目提供了在 Windows 10 上运行 WSA 的参考与工具（例如补丁/指导），对于“非原生支持”的情形非常关键。
如果你在 Win10 环境遇到阻断，优先对照 WSAPatch 的官方指引逐项对齐。

10. 小结：WSABuilds = 更低姿态、更少繁琐

如果你想在 Windows 上体验完整的 Android 世界（Google Play + Root），而且不愿意花大量时间做低层定制与踩坑，那么 WSABuilds 为你铺好了路。
它并不是“遥不可及的黑箱”，你可以：

  • 按文档一步步安装与更新
  • 以“注册机制”理解 WSA 的安装方式
  • 用 Get-AppPackageLog / adb logcat 定位问题
  • 利用“Root + GApps + RAG 文档（如有）”把它变成你的开发/测试/使用主场

最后，再次提醒“版本寿命与生态变化”：
文档中有“Magisk on WSA 于 2025-03-05 后不再可用”的提示链接（来自微软文档）。请持续关注仓库与微软官方对 WSA 的最新通告，及时调整构建/升级策略。

附：常用命令清单（收藏版）

1
2
3
4
5
6
7
8
9
10
11
# 进入解压目录（管理员）
cd "{X:\path\to\your\extracted\folder}"

# 安装脚本（绕过策略）
PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

# 注册 Appx（失败后打印 ActivityID）
Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

# 根据 ActivityID 查看详细日志
Get-AppPackageLog -ActivityID <UUID>
1
2
3
4
5
6
7
# ADB 日志与连接
adb logcat
adb connect ip:5555

# 安装 Magisk 模块（本地）
adb push module.zip /data/local/tmp
adb shell su -c magisk --install-module /data/local/tmp/module.zip
1
2
3
4
5
# WSA Logcat 文件位置
%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat

# 备份数据核心文件
%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx

愿你用最短的时间，把 Android 世界“安家”进你的 Windows。🚀