WSABuilds 构建状态参考：WSA 版本兼容性矩阵、指示图例与已知问题解析

WSABuilds 构建状态参考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 仓库中的官方状态文档 Information.md 展开完整梳理该页面承载的三项核心信息各 WSA 构建版本在 Windows 11 / Windows 10 下的稳定性矩阵、四种状态指示标记的含义以及会影响安装体验的已知问题清单并结合仓库内版本探测脚本与构建脚本源码说明这些状态数据是如何自动更新与维护的。读完本文你可以快速判断当前该选哪个 WSA 版本、哪些版本绝对不能下载并理解该仓库的构建状态数据从何而来。状态页面的定位与阅读方式Information.md 在仓库文档体系中的角色是下载前的体检报告。它与 Installation.md安装、Updating.md更新、Uninstallation.md卸载、Backup and Restore.md数据备份共同组成Documentation/WSABuilds/目录下的用户文档集而 README.md 首页的下载按钮正是引导用户到具体 Release 的版本。状态页面回答的问题只有一类这个版本号 这个 Windows 版本组合现在能不能用回答的载体是三张表按时间顺序排列的 WSA 版本状态矩阵Windows 11 一列、Windows 10 一列状态指示标记图例Indicator Keys更新跳过记录哪些版本没有产出对应构建、为什么。已知问题下载前必读原文档在状态矩阵之前用醒目位置列出Read Before Downloading清单这些是可能直接影响 WSA 使用体验的已知问题必须完整保留GApps 构建的兼容性问题文档标注GApps Issues为第一优先已知问题对应上游 MagiskOnWSALocal 项目的 issue #595。结合当前仓库 README.md 顶部的 CAUTION 提示可以看到该问题的延续影响2025 年 6 月之后的 Windows 11 构建上含 GAppsGoogle Play Store / Google 服务的构建开始出现崩溃README 给出的临时规避方案有三条采用针对含 GApps 构建的推荐修复方式对应 issue #593 中的评论方案切换/使用不含 GApps 的构建即压缩包文件名中包含NoGApps字样的版本使用较老的、已知工作正常的 2211 / 2210 版本构建旧版本下载入口见 OldBuilds.md。WSA 文件夹名过长导致无法启动原文档指出MagiskOnWSALocal 脚本自动生成的 WSA 解压文件夹名称可能过长导致 WSA 无法启动。处理方式非常具体——在解压之后、安装 WSA 之前把该文件夹重命名为WSA。这一条属于典型的路径长度限制类问题仓库中另有对应的修复指南 FixPathTooLong.md 可作延伸阅读。v2307 下 Magisk 模块安装后重启即消失针对 WSA v2307 版本文档记录了一个特定问题已安装的 Magisk 模块在安装后续重启后会消失对应 issue #154。如果你恰好在 v2307 系列版本上依赖 Magisk 模块例如 LSPosed、KernelSU 相关组件需要提前知晓这一行为并优先在 Having Issues.md 的修复指南中查找对应项。WSA 版本兼容性状态矩阵以下矩阵完整继承自 Information.md 的原始表格覆盖从 v2210 到 v2311 的所有已记录版本。⚠️ 与 ⛔ 标记在原文档中带有指向上游 issue 的链接MagiskOnWSALocal 与 WSAPatch 项目的追踪此处以上游 issue 追踪表述替代外部链接。WSA 版本Windows 11Windows 10v2210.40000.7.0✅✅v2211.40000.10.0✅✅v2211.40000.11.0✅✅v2301.40000.4.0✅✅v2301.40000.7.0✅✅v2302.40000.6.0✅✅v2302.40000.8.0✅✅v2302.40000.9.0✅✅v2303.40000.2.0✅✅v2303.40000.3.0✅✅v2303.40000.4.0✅✅v2303.40000.5.0✅✅v2304.40000.5.0⚠️上游 issue 追踪⛔上游 WSAPatch issue 追踪v2304.40000.6.0⚠️上游 issue 追踪⛔上游 WSAPatch issue 追踪v2304.40000.7.0✅⛔上游 WSAPatch issue 追踪v2304.40000.10.0✅⛔上游 WSAPatch issue 追踪v2305.40000.2.0✅⛔上游 WSAPatch issue 追踪v2305.40000.3.0✅✅v2305.40000.4.0✅✅v2305.40000.5.0✅✅v2305.40000.6.0✅✅v2306.40000.1.0✅✅v2306.40000.2.0✅✅v2306.40000.3.0✅✅v2306.40000.4.0✅✅v2307.40000.2.0✅✅v2307.40000.3.0✅✅v2307.40000.5.0✅✅v2307.40000.6.0✅✅v2308.40000.1.0✅✅v2308.40000.2.0更新跳过预留时间调整文档与构建脚本MagiskOnWSALocal之后恢复照常更新v2308.40000.3.0✅✅v2309.40000.2.0✅✅v2309.40000.4.0 v2310.40000.1.0 v2311.40000.3.0更新跳过作者公告为了给构建管线从自建 Linux 服务器迁移到 GitHub Actions 预留时间期间跳过若干版本更新这很可能是最后一次此类中断v2310.40000.2.0✅✅v2311.40000.4.0✅✅v2311.40000.5.0✅✅从矩阵可以读出两条清晰的信息脉络Windows 10 列在 v2305.40000.3.0 之前长期为 ⛔且全部指向上游 WSAPatch 项目的同一个 issue 追踪。这与仓库结构可以互相印证MagiskOnWSA/DLL/目录中随构建分发的 WsaPatch.dll 与 icu.dll以及 MagiskOnWSA/DLL/README.md其内容即指向 WSAPatch 项目说明 Windows 10 上的 WSA 运行依赖一个外挂补丁方案。从源码结构看正是该补丁在 v2304/v2305.2 时代的失效导致 Windows 10 列连续标红直到 v2305.40000.3.0 才恢复双平台可用矩阵并非每版必发。v2308.40000.2.0 与 v2309.40000.4.0v2311.40000.3.0 两段被显式标注为更新跳过原因分别是文档/脚本调整窗口和 CI 管线迁移。这类记录对判断某个版本号在 Releases 里找不到对应构建是正常的还是遗漏非常关键。状态指示标记图例Indicator Keys原文档定义了四种标记含义与行动建议如下标记状态含义说明✅Stable稳定一切按预期工作如果你认为该构建不稳定应提交 GitHub Issue 或在官方 Discord 社区反馈⚠️Unstable不稳定由于已知缺陷体验可能不流畅原文档提示点击 Emoji 查看详情即指向对应上游 issue⛔Not Working不可用构建无法工作切勿下载同样以上游 issue 链接提供详情➖No Information Yet暂无信息信息不足以确认状态建议到官方 Discord 社区确认该版本是否可用后再决定对使用者的操作含义很直接只下载 ✅ 或经过社区确认的 ➖ 版本⚠️ 版本用于排障和尝鲜⛔ 版本一律回避。这条规则同样适用于 OldBuilds.md 中归档的旧版本列表该文档按版本罗列了 v2210v2311 各 Windows 10 / Windows 11 构建的下载按钮与状态矩阵互为索引。状态数据如何产生版本探测与构建脚本源码剖析状态矩阵里的版本号不是手工登记的仓库中的自动化脚本给出了完整证据链这也解释了为什么矩阵与 Releases 标签能保持同步。零售版 WSA 版本探测WSARetailUpdateCheck.pyWSARetailUpdateCheck.py 是运行在 CI 中的版本监控脚本其工作流程可以精确还原读取基线版本脚本从仓库update分支拉取retail.appversion文件的当前值第 55 行作为已处理过的版本基线通过微软 FE3 分发服务的 SOAP 接口查询可用更新依次使用 GetCookie.xml 获取会话 Cookie再用 WUIDRequest.xml 携带分类 ID源码第 36 行的cat_id 858014f3-3934-4abe-8078-4aa193e74ca8对应 WSA 的更新目录请求fe3.delivery.mp.microsoft.com端点第 72-76 行、85-92 行解析并比对版本号从响应的ExtendedUpdateInfo/NewUpdates节点中收集文件清单第 95-117 行用正则MicrosoftCorporationII.WindowsSubsystemForAndroid_.*.msixbundle匹配 WSA 主包文件名再提取形如YYYY.NNNNN.B.R的版本号第 119-125 行触发构建当远端版本高于基线时第 127 行脚本写入新的retail.appversion并向 GitHub Actions 的环境文件追加SHOULD_BUILDyes、RELEASE_TYPEretail、LATEST_RETAIL_VER等变量第 139-144 行下游工作流据此决定是否产出新构建。同目录下的WSAInsiderUpdateCheck.py、MTGUpdateCheck.pyMindTheGapps 版本探测、MagiskStableUpdateCheck.py、KernelSUUpdateCheck.py采用相同模式分别监控各渠道/组件这解释了构建产物中 WSA 版本、GApps 版本与 Magisk/KernelSU 版本各自独立演进的现象。下载链接生成generateWSALinks.pygenerateWSALinks.py 是实际构建时使用的链接生成器与探测脚本共享同一套 SOAP 调用逻辑源码第 74-92 行并额外完成通过 FE3FileUrl.xml 向/secured端点换取带签名的临时下载 URL第 122-142 行并过滤长度异常的响应len(url) ! 99判断只保留版本号与目标版本完全一致的msixbundle包第 165-176 行输出为wsa-{release-type}.zip避免混入其他小版本支持四个发布渠道retailRetail、RPRelease Preview、WISInsider Slow、WIFInsider Fast见源码第 55-58 行的release_name_map用多线程并发换取各依赖组件UI.Xaml、VCLibs 等的下载链接写入下载清单供后续步骤使用第 179-191 行。README 状态表自动回填update-downloadvar.pyupdate-downloadvar.py 展示了状态展示侧的自动化它用 BeautifulSoup 解析 README.md定位表头为[Download Variant, Image, Image]的表格第 12-24 行再用 GitHub Actions 传入的TEXT_TO_REPLACE_WITH、ROW_NUM、COLUMN_NUM环境变量替换指定单元格内容第 32-41 行。这说明 README/状态类文档中的版本信息同样由 CI 回写维护——你在状态页面看到的版本号与 Release 标签名保持一致正是这一机制的结果。如何把状态矩阵用于实际的版本选择结合 README.md 与状态文档可提炼出以下选择策略默认选择状态矩阵中最新的 ✅ 版本当前文档记录到的最后稳定版本为 v2311.40000.5.0Windows 11 / Windows 10 双平台 ✅。README 同时说明自 2025 年 3 月 5 日微软终止 WSA 官方支持后项目对 ≥ 2311.40000.5.0 的版本进入 LTS长期支持模式后续新 Release 以更新内置的 Magisk、KernelSU 与 GApps 版本为主而不是跟进新的 WSA 系统版本——因此新 Release不等于新 WSA 版本号Windows 10 用户注意历史 ⛔ 区间v2305.40000.3.0 之前的版本在 Windows 10 上不可用WSAPatch 补丁失效期选择旧版本构建OldBuilds.md时应避开该区间遇到 GApps 崩溃时按 README 的三条规避路径处理推荐修复方案 / 换用NoGApps构建 / 回退到 2211、2210 老版本这些与状态文档开头的GApps Issues是同一问题的两个视角遇到安装/运行故障时按阶段分流安装前问题解压错误、0x80073CF0 等系列错误码、路径过长、联网设置拦截与安装后问题键盘失效、图标缺失、WSA 不启动、Google Play 异常分别对应 Documentation/Fix Guides/Pre-Install Issues 与 Documentation/Fix Guides/Post-Install Issues 下的分篇指南总入口是 Having Issues.md⛔ 版本不要下载⚠️ 版本仅在需要排障时考虑且先读对应上游 issue 说明的失效范围。适用前提与限制本矩阵描述的是 WSABuilds 仓库文档记录到 v2311.40000.5.0 为止的状态由于微软已终止 WSA 官方支持见 README.md 的 EoS 说明版本矩阵的增量更新节奏取决于社区 LTS 维护而非微软发布节奏状态标记是社区共识 作者确认的产物➖ 状态的版本必须经社区验证后再使用Windows 10 列的状态强依赖 WSAPatch 外挂补丁WsaPatch.dll该补丁的兼容性变化会直接翻转整个 Windows 10 列这是理解历史 ⛔ 区间的根本原因文档中引用的外部 issue 追踪GApps、文件夹名、模块消失、WSAPatch因平台链接限制未在此文给出直达入口检索对应上游项目MagiskOnWSALocal、WSAPatch的 issue 列表即可定位原文。【免费下载链接】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），仅供参考