WSABuilds 完整指南：在 Windows 10/11 上装好带 Magisk 与 Google Play 的 WSA

WSABuilds 完整指南：在 Windows 10/11 上装好带 Magisk 与 Google Play 的 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

WSABuilds 为 Windows 10/11 提供预装 MindTheGapps（Google Play 商店与服务）和 Magisk 或 KernelSU（两种 Root 方案）的 WSA 定制包。WSA 即 Windows Subsystem for Android，微软在 Windows 上运行 Android 应用的兼容层。适合需要在 Windows 上跑依赖 Google 服务的 App、或给 Android 环境打 Root 模块的开发者。

判断你的场景：WSABuilds 适合谁

先说结论，它不是给所有人准备的：

📌适合：

• 需要 Google Play 商店/服务（GMS）的 Windows 用户——官方 WSA 已移除 GMS，且微软已于 2025 年 3 月 5 日结束对 WSA 的官方支持（见 README.md 中的 EoS 说明）。
• 需要 Root（Magisk/KernelSU）或想往 Android 环境里装模块（LSPosed、Shizuku 类工具）的人。
• 愿意维护一个"WSA 安装目录必须保留"的固定部署（见下文验证一节的原因）。

不适合：

• 只需要跑微软商店认证 App 的普通用户：官方 WSA 更简单，WSABuilds 属于第三方改造包，不在微软支持范围内。
• 需要官方持续更新的场景：微软已停更 WSA，WSABuilds 对 ≥ v2311.40000.5.0 的版本进入 LTS（长期支持）维护，靠发布新版构建包跟进 Magisk/KernelSU/GApps 更新，但 WSA 底座本身不再升级。

⚠️ 注意：README 顶部的警告区提到，2025 年 6 月之后含 GApps 的构建在部分 Windows 11 上出现崩溃，官方给出了临时缓解方案或改用文件名带NoGApps的构建。选型时先确认自己要装的是哪一类包。

WSA 构建流程：数据流全景

不管你是下载预构建包还是自己构建，产物都来自同一条流水线（源码在 MagiskOnWSA/scripts/）：

三个关键点：

1. 下载不走商店。generateWSALinks.py直接对微软 FE3（First Event Service，微软交付更新的基础设施）发 SOAP 请求，模板是 MagiskOnWSA/xml/ 下的GetCookie.xml、WUIDRequest.xml、FE3FileUrl.xml，拿到.msixbundle和 VCLibs、UI.Xaml 依赖包的真实下载链接。
2. 补丁打在 initrd 里，不是 system 分区。细节下一节展开。
3. 最终产物是未签名的 Appx 目录，靠随包携带的Install.ps1用Add-AppxPackage -Register就地注册，这就是为什么安装目录删不得。

WSA 预构建包三步安装步骤

大多数用户走这条路：去发布页拿.7z，解压，注册。依据是 Documentation/WSABuilds/Installation.md。

第 1 步：准备——确认硬件门槛：

• Windows 11 Build 22000.526+，或 Windows 10 22H2（19045.2311+）；
• 内存 8 GB 起（官方建议 16 GB），系统盘（C:\）NTFS 分区且留 10 GB 以上；
• 启用「虚拟机平台」和「Windows 虚拟机监控程序平台」两个 Windows 功能（Win+R 输入OptionalFeatures.exe），并在 BIOS/UEFI 里打开虚拟化。

如果之前装过官方 WSA，先彻底卸载再装这个，两者不能共存。

第 2 步：执行——解压.7z后，把解压出的文件夹重命名为WSA（长文件夹名会导致 WSA 无法启动，Documentation/WSABuilds/Information.md 列为已知问题），双击其中的Run.bat。

第 3 步：验证——安装完成后按提示操作，WSA 图标应出现在开始菜单并能启动；首次启动会弹诊断数据同意框。若Run.bat窗口一闪而过没装上，用管理员 PowerShell 手动注册：

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

💡 原理提示：Install.ps1本质是执行Add-AppxPackage -Register .\AppxManifest.xml，把"无包化文件"注册成 Appx 包。注册只引用磁盘上的目录，所以目录删了 WSA 就没了。诊断失败时可按 Installation.md 里的方法用Get-AppPackageLog -ActivityID <uuid>查具体报错。

Linux 下自构建设置方法

想自己产出构建包（比如固定某个 Magisk 版本、或走 Release Preview 渠道），在 Linux/WSL 环境里构建：

git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds cd WSABuilds/MagiskOnWSA bash scripts/run.sh

run.sh是 whiptail/dialog 驱动的交互菜单（要求 bash，不要用sh运行）：先跑install_deps.sh自动装aria2c、7z、unzip等依赖，再让你依次选架构（x64/arm64）、发布渠道（retail/RP/WIS/WIF）、Root 方案（magisk/kernelsu/none）、Magisk 版本、是否装 GApps、是否移除 Amazon Appstore、压缩格式（7z/zip）。确认后会打印最终命令行并调起build.sh。

跳过交互直接构建：

./scripts/build.sh --arch x64 --release-type retail \ --root-sol magisk --magisk-ver stable \ --install-gapps --remove-amazon

产物落在MagiskOnWSA/output/，已下载的组件缓存在MagiskOnWSA/download/，重复构建不用重新下载 WSA 主体（可用--skip-download-wsa显式跳过）。

initrd 补丁机制解析：Magisk 如何注入 WSA

这是整个项目最核心的动作：不动 Android 的 system 分区，而是把 Root 能力塞进启动早期的 initrd 镜像。build.sh中对应片段（完整逻辑见 MagiskOnWSA/scripts/build.sh 第 495–562 行）：

"$WORK_DIR/magisk/magiskboot" cpio "$WORK_DIR/wsa/$ARCH/Tools/initrd.img" \ "mv /init /wsainit" \ "add 0750 /lspinit ../bin/$ARCH/lspinit" \ "ln /lspinit /init" \ "add 0750 /magiskinit $WORK_DIR/magisk/magiskinit" \ "mkdir 0750 overlay.d" \ "add 000 overlay.d/init.lsp.magisk.rc init.lsp.magisk.rc" \ "add 000 overlay.d/sbin/post-fs-data.sh post-fs-data.sh"

💡 原理提示：magiskboot是 Magisk 自带的镜像工具。这里把原始/init改名保留，换成一个lspinit存根作为新入口（它负责把 Magisk 挂载进启动流程），并新增overlay.d目录存放 rc 脚本、post-fs-data.sh和lsp_cust.img（一个存放 Magisk 二进制的自定义镜像）。GApps 走同一机制：把 MindTheGapps 的gapps.img加进 initrd，由gapps.rc在开机时挂载。

两条容易忽略的约束：

• 组合限制写在build.sh里：--install-gapps与--root-sol kernelsu同时出现会直接中止（Unsupported combination）；none+ GApps 会强制改回 Magisk，因为挂载 gapps.img 需要 Magisk。
• KernelSU 路线完全不同：它不碰 initrd，而是从 WSA 的Tools/kernel读出内核版本号（getKernelVersion），下载匹配内核版本的 KernelSU zip，直接把bzImage/Image替换进Tools/kernel（原文件备份为kernel_origin）。
• GApps 的 API 版本随 WSA 主版本联动：WSA < 2211 用 API 32，否则 API 33（见build.sh第 354–422 行）。

WSA 常见报错与解决方法

更多条目可查 Documentation/Fix Guides/（按安装前/安装后分类的错误码文档）和 Documentation/WSABuilds/Having Issues.md。

build.sh 构建参数速查表

以下参数与默认值取自build.sh的usage()与default()，可直接运行：

WSABuilds 与官方 WSA、模拟器的对比

WSABuilds 的差异化在于：把"下载官方 msixbundle → 打 initrd 补丁 → 重打包 → Windows 侧注册"这条链路完全脚本化，且预构建包让用户零构建成本。

总结与文档入口

一句话：WSABuilds 是微软停更 WSA 之后，Windows 上获得"带 Google Play + Root 的 Android 环境"目前最完整的一条路，代价是接受第三方包的维护方式。

推荐资源（均为仓库内相对路径）：

• 入门：Documentation/WSABuilds/Installation.md、Updating.md、Uninstallation.md
• 备份与数据迁移：Documentation/WSABuilds/Backup and Restore.md
• 版本兼容矩阵：Documentation/WSABuilds/Information.md、旧版本归档 OldBuilds.md
• 构建脚本主逻辑：MagiskOnWSA/scripts/build.sh、WSA 链接生成 generateWSALinks.py
• 更新/卸载辅助工具：WSAUpdater.py、WSAUninstaller.py

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