WSA 怎么装：带 Google Play 和 Magisk Root 的 Windows Android 子系统完整上手指南-港品优选

WSA 怎么装：带 Google Play 和 Magisk Root 的 Windows 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

WSABuilds 是一个为 Windows 10/11 提供 Windows Subsystem for Android（WSA）预构建安装包的项目，内置 Google Play Store（MindTheGapps）和 Magisk / KernelSU 两种 Root 方案，让你不用自己拼镜像，一条命令装出"有商店、能 Root"的 Android 环境。

先说说你为什么会装 WSA

想象一个具体场景：你手头有个只有 Android 版的 App，Windows 上跑不了；官方渠道下载的 WSA 又恰好不支持你机器，或者你只是想给 WSA 刷个 Root 装 LSPosed。

这时候你一般会卡在三个地方：

微软已经停止对 WSA 的支持，官方商店里找不到干净的安装包了；
官方 WSA 里没有 Google Mobile Services，大量 App 一打开就弹"需要 Google 账户"；
想 Root 的人需要自己解包 MSIX、往 system 分区里塞 Magisk，手工流程又长又容易翻车。

WSABuilds 做的事情很直白：把"下载 WSA 镜像 → 解包 → 注入 GApps 和 Magisk → 重新打包签名"这套脏活全部脚本化，产出开箱即用的 .7z 构建包，同时也把脚本完整开源，让想自己控制构建参数的人能本地重编。

项目名片：它是什么、给谁用

一句话定位：WSA 的"预装增强版"分发仓库 + 可本地运行的自动化构建工具链。

项目	说明
定位	提供内置 Google Play 与 Magisk/KernelSU 的 WSA 预构建包，并开放完整构建脚本
适用人群	需要 Android App 的 Windows 用户、要 Root/LSPosed 的折腾党、Android 兼容层测试人员
上手难度	装预构建包：低（解压 + 双击）；本地构建：中（需要 Linux/WSL2 + Python 环境）
主要产物	Windows 10/11 x64、Windows 11 arm64 的 WSA 构建包（.7z）
许可	AGPL v3
文档	仓库自带完整的安装/更新/卸载/排障文档，入口在 Documentation/WSABuilds/

传统做法 vs WSABuilds 做法

传统做法：自己从微软渠道找 WSA 的 .msix，用 7-Zip 解包，找到system相关目录，手动下载 Magisk APK 和 GApps 包，逐个文件复制进 Android 文件系统，修好权限和 SELinux 标签，再用makepri重新生成资源包、重新注册。任何一个环节的版本对不上（GApps 和 WSA 的 Android 版本不匹配），结果就是 Google Play 直接闪退。

WSABuilds 做法：这些步骤全部沉淀成了脚本。你要么直接下载它打包好的成品；要么运行 MagiskOnWSA/scripts/ 下的构建入口，交互式地选架构、选渠道、选 Root 方案，剩下的下载、解包、注入、打包全由脚本完成。版本匹配问题由项目方在发版时统一验证，你只挑一个经过测试的组合用。

架构全景：组件和数据怎么流动

整个仓库可以拆成四个部分，各自职责清晰：

MagiskOnWSA/scripts/：构建与注入逻辑（解包、提取、属性修正、链接生成）；
MagiskOnWSA/installer/：终端用户侧的Run.bat/Install.ps1，负责在 Windows 上注册 Appx 包；
MagiskOnWSA/Update Check/：检查 WSA、Magisk、GApps、KernelSU 各渠道最新版本的脚本，是发版前核对版本的工具；
MagiskOnWSA/libhoudini/：内置的 ARM 兼容层（Houdini），让 x64 版 WSA 也能跑 ARM 的 App。

核心能力拆解

能力一：预构建包，双击就能装

价值：把最复杂的部分前置给了维护者，终端用户拿到的就是一个待注册的 WSA 目录。

怎么实现：发布页提供 Windows 11 x64/arm64、Windows 10 x64 的构建包，下载解压后目录里直接有Run.bat，脚本内部调用 MagiskOnWSA/installer/Install.ps1 完成 Appx 注册。

你需要注意：解压出来的目录不能删。Add-AppxPackage -Register注册的是"未打包文件"，目录一删 WSA 就起不来。

能力二：Magisk 与 KernelSU 双 Root 方案

价值：同一个构建流程里可选两种主流 Root，Root 环境的差异（Magisk 走系统注入，KernelSU 走内核层）由脚本处理。

怎么实现：构建时通过--root-sol magisk|kernelsu指定；Magisk 的启动相关脚本见 MagiskOnWSA/scripts/post-fs-data.sh，SELinux 规则见 MagiskOnWSA/scripts/sepolicy.rule。

你需要注意：LTS 版构建默认捆绑 Magisk，如果你不需要 Root，选 Non-LTS 构建或自行卸载模块。

能力三：内置 Google Play（MindTheGapps）

价值：解决官方 WSA 最大的痛点——没 GMS，App 生态直接缺一半。

怎么实现：构建流程拉取 MindTheGapps 的服务包，用 MagiskOnWSA/scripts/fixGappsProp.py 修正属性文件后再注入系统分区。

你需要注意：项目 README 顶部明确提示——2025 年 6 月之后的 Windows 11 系统上，GApps 构建出现过崩溃问题，官方给出的临时方案是使用文件名带NoGApps的构建。选包前先看一眼发布说明。

能力四：本地构建脚本，参数全可控

价值：不想用成品？在 WSL2 里跑一遍就能产出自己的构建。

怎么实现：入口是 MagiskOnWSA/scripts/run.sh，一个基于 whiptail/dialog 的交互界面，依次问你架构（x64/arm64）、WSA 渠道（稳定/Release Preview/Beta/Dev）、是否 Root、Magisk 渠道（stable/beta/canary）、是否装 GApps、是否移除 Amazon Appstore、输出压缩格式（7z/zip），最后拼成build.sh的命令行并执行。

你需要注意：脚本要求 x86_64 或 aarch64 主机，依赖通过install_deps.sh自动安装，产物落在仓库的output/目录。

能力五：更新检查脚本，发版有依据

价值：WSA、Magisk、GApps 是三个独立更新源，版本错配是这类项目最常见的翻车原因。

怎么实现：MagiskOnWSA/Update Check/ 下按渠道拆了独立脚本，如WSARetailUpdateCheck.py、MagiskStableUpdateCheck.py、KernelSUUpdateCheck.py、MTGUpdateCheck.py（GApps），各自轮询对应官方源的最新版本号。

你需要注意：这些是维护者发版前用的核对工具，普通用户不需要跑，但想确认"我装的这版是不是最新的"时，翻一下对应脚本能看懂项目是怎么追踪上游的。

从零跑通：两条最短路径

路径 A：装预构建包（5 分钟，推荐）

从项目 Releases 页下载对应系统的 .7z（注意选 Stable 还是 Pre-release）；
解压，把解压出的文件夹重命名为WSA，放到你愿意长期保留的位置；
双击目录里的Run.bat；
如果窗口一闪而过没装上，用管理员 PowerShell 手动执行：

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

详细步骤见 Documentation/WSABuilds/Installation.md。

路径 B：本地构建（需要 WSL2）

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

按交互提示选完参数后脚本会自动调用build.sh完成构建，产物在../output/。

进阶与典型场景

场景一：给 WSA 装 LSPosed 类框架的开发者。选 Magisk 构建 → 装好后进 WSA 设置把 ADB 打开 → 用 Magisk 装框架模块。项目文档 Documentation/WSABuilds/Usage Guide.md 和 Documentation/Usage Guides/ 里有 ADB、WSAFiles、WSAPacman 等配套工具的使用说明。

场景二：把 WSA 当 Android 兼容层测试设备。QA/开发者可以用它快速复现 Android 侧行为，配合MagiskOnWSA/scripts/magisk_debug.sh收集 logcat、模块状态和 SELinux 违例，比真机更容易批量准备环境。

场景三：外置盘用户。WSA 默认数据盘在 C 盘且只能 NTFS，空间不够的人可以按 Documentation/Usage Guides/General Usage Guides/MoveToExtDrive.md 把userdata.vhdx迁到外置盘；GPU 有问题（Intel HD 530 及更老、部分 NVIDIA 卡）的按 Documentation/Usage Guides/General Usage Guides/ChangingGPU.md 切换渲染设备。

遇到问题时查这里

排障文档整体在 Documentation/Fix Guides/，高频问题速查：

现象	根因	处理
运行`Run.bat`报 0x80073CFB	旧的 WSA 包注册残留，重装被阻止	管理员 PowerShell 执行`Get-AppxPackage -Name "MicrosoftCorporationII.WindowsSubsystemForAndroid" -AllUsers \\| Remove-AppxPackage -AllUsers`后重装，见 Fix Error 0x80073CFB.md
安装报 0x80073CF0 / 3CF6 / 3CF9 等一串错误	未启用`Virtual Machine Platform`、`Windows Hypervisor Platform`，或虚拟化没开	用`OptionalFeatures.exe`打开对应功能并重启，各错误码对应文档在 Pre-Install Issues/
WSA 里键盘完全没反应	Windows 的"Touch Keyboard and Handwriting Panel"服务被禁用	`services.msc`中将该服务设为自动并重启，见 Keyboard Is Not Working.md
Google Play 打不开 / 闪退	GApps 版本与 Windows 11 新构建冲突	换`NoGApps`构建，或按 README 顶部的 workaround 处理
应用图标缺失、白屏	Appx 包未正确注册	参考 Post-Install Issues/ 下对应条目逐条排查

横向对比：官方 WSA 和手动折腾方案

维度	官方 WSA	自己手动集成	WSABuilds
Google Play 服务	无	有（自己保证版本匹配）	有（MindTheGapps，发版时验证）
Root 能力	无	有（自己调权限/SELinux）	Magisk / KernelSU 双方案
上手成本	低（但功能受限）	高，多步手工操作	低（预构建）/ 中（本地构建）
维护状态	微软已宣布停止支持	完全靠自己追上游	进入 LTS，Magisk/KernelSU/GApps 持续跟进更新
出问题后	官方文档不再更新	无从查起	自带分错误码的排障文档树

安全与边界：几条要心里有数的事

隔离是有的，但不是绝对边界。WSA 跑在 Hyper-V 虚拟机里，与宿主机有虚拟层隔离；但它本质上是个 Android 系统，装了 Root 后一切"系统级"操作都不再有约束，别在里面跑来路不明的 APK。
组件来源可追溯。WSA 镜像来自微软官方渠道，Magisk 来自其官方发布，GApps 来自 MindTheGapps；构建脚本全开源（AGPL v3），你可以审计每一个注入动作。
仓库是分发+工具链，不是黑盒。所有改动逻辑都在 MagiskOnWSA/scripts/ 里，装之前翻一眼构建脚本，比任何声明都可靠。
数据在你手里。用户数据都在userdata.vhdx一个文件里，升级前先备份这个文件（路径见 Installation.md），就能无痛重刷。

写在最后

只想用 Android App 的普通用户：直接下预构建包走Run.bat，遇到崩溃先看 README 顶部的 GApps 提示，选NoGApps构建绕开。
要 Root/LSPosed 的折腾党：用带 Magisk 的 LTS 构建，装完先别急着装模块，跑一遍 ADB 确认环境正常再逐步加。
想在本地构建的人：WSL2 +run.sh就够了，重点理解build.sh的参数矩阵，改天你自己也能出定制构建。

微软停更 WSA 之后，这类社区维护的项目反而成了 Windows 上 Android 体验的主要供给方。WSABuilds 把发版节奏、文档和排障流程都搭成了可持续运转的体系，对"想长期用 WSA 的人"来说，这比任何单次的功能堆叠都更有价值。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析