WSABuilds 完整指南：在 Windows 上 10 分钟装出带 Google Play 的 Android 子系统

WSABuilds 完整指南在 Windows 上 10 分钟装出带 Google Play 的 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先说一个现实微软已于 2025 年 3 月结束对 Windows Subsystem for AndroidWSA的支持商店里的官方版本既没有 Google 服务框架也没有 root。这意味着想在一台 Windows 10/11 电脑上长期、完整地跑 Android 应用官方路子已经走不通了。WSABuilds就是社区给出的替代方案它提供预打包的 WSA 二进制出厂即内置 Google Play 商店MindTheGapps以及 Magisk 或 KernelSU 两种 root 方案而且项目在 WSA 版本 ≥ 2311.40000.5.0 之后进入 LTS 阶段Magisk、KernelSU 和 GApps 都会通过新发布持续更新。 动手前先确认 3 件事装之前花两分钟自检比装完排错省下一小时。检查项要求怎么查系统版本Windows 11 Build 22000.526 及以上Windows 10 22H210.0.19045.2311及以上按 WinR 输入winver内存与磁盘8GB 内存起步推荐 16GBC 盘至少 10GB 空闲设置 → 系统CPU 架构x86_64x64或 arm64设置 → 系统 → 关于 → 系统类型另外三个硬性条件任何一条不满足都会直接卡住安装虚拟化必须在 BIOS/UEFI 中开启并且 Windows 里启用了虚拟机平台Virtual Machine Platform和Windows 托管程序平台Hypervisor Platform两个可选功能WSA 只能装在 NTFS 分区exFAT 或 FAT32 一律不行高度定制的精简版系统ReviOS、Tiny10/11 等删掉了部分组件很可能装不上官方文档也明确提示了这一点 老 Win10 用户注意20H110.0.19041.264可能能跑但需要先手动安装 KB5014032 再装 KB5022834 两个更新。能升级到 22H2 就尽量升。 下载正确的 .7z 文件名字里藏着 4 个信息去 Releases 页面下载时每个压缩包的文件名都遵循同一套命名逻辑拆给你看文件名片段含义怎么选Windows_11/Windows_10目标系统按你的系统选别混版本号2407.40000.4.0WSA 底层版本跟随项目最新稳定发布即可文件名末尾带_arm64ARM64 架构专用x64 电脑不要选这个包含NoGApps不含 Google 服务的版本见下方提示下载时记住两点只下.7z 压缩包Releases 里的 Source code 按钮是源码不是安装包当前主流版本是 LTS 7 Hotfixv2407.40000.4.0其中 GApps 版默认捆绑了 Magisk想要不带 Magisk 的构建就选非 LTS 版本关于 GApps 的已知问题自 2025 年 6 月起带 GApps 的构建在 Windows 11 上存在崩溃问题项目在持续修复中。如果你暂时不想踩坑有三个稳妥选择下载文件名带NoGApps的版本、选用较老的 2211/2210 版本可从 Documentation/WSABuilds/OldBuilds.md 找到对应构建或关注项目 Issue 里的最新进展。️ 安装6 步走完卡住有退路用 7-Zip 等工具解压 .7z 压缩包把解压出来的文件夹重命名为WSA这个动作很重要见下方提示删除 .7z 压缩包本身把WSA文件夹移动到一个稳妥的位置比如文档目录。路径别太深、别用特殊字符打开WSA文件夹双击Run.bat脚本跑完后WSA 会自动启动。首次安装会弹出诊断信息同意窗口有时会出现两个一模一样的窗口两个都点是即可这是正常现象回到 PowerShell 窗口按任意键关闭它再关掉文件资源管理器在开始菜单搜索Windows Subsystem for Android能打开设置界面就说明装好了 解压后的文件夹名很长如WSA_2407.40000.4.0_...项目已知长文件夹名会导致 WSA 无法启动所以第 1 步的重命名不是建议是必须。如果双击Run.bat后窗口一闪而过、WSA 没装上通常是权限问题手动以管理员身份执行cd X:\path\to\WSA # 切换到你的 WSA 文件夹把路径换成实际位置 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1 # 以管理员权限运行安装脚本完成注册如果这条命令也失败多半是这台电脑本身不支持 WSA比如虚拟化没开。回第 1 节逐项核对。两条不能违反的规则 ① 如果你之前装过微软商店的官方版 WSA必须先彻底卸载才能装 WSABuilds两者不能共存 ② 装完之后WSA文件夹永远不能删。它用的是未打包文件 Appx 包注册机制Add-AppxPackage -Register删了文件夹整个子系统就废了。✅ 首次运行后验证与 ADB 连通装完不等于白装用这三步确认环境完整打开 WSA 设置应用左侧能展开各选项卡、不闪退在设置里打开开发者Developer选项在 Windows 上运行 ADB 连接adb connect 127.0.0.1:5555 # 通过本机回环地址连接 WSA如果连不上去设置的Developer页查看 WSA 显示的实际 IP改成adb connect 那个IP:5555重试。开发者模式没开是连不上的这是最高频的卡点。 排错两个高频错误码 一个启动问题错误 0x80073CF6包注册失败这是最常见的安装错误报Deployment failed with HRESULT: 0x80073CF6, Package could not be registered。按顺序排查确认安装所在分区是NTFS重新下载压缩包——文件在传输中损坏比想象中常见如果装过旧版 WSA彻底卸载后删除以下位置中所有带WindowsSubsystemForAndroid字样的文件夹C:\ProgramData\Microsoft\Windows\AppRepositoryC:\ProgramData\Microsoft\Windows\WindowsApps%localappdata%\Packages重启电脑再跑一次Run.bat如果还是失败取日志定位真正原因管理员 PowerShell在 WSA 目录内执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml # 手动注册包预期失败用于获取 ActivityID Get-AppPackageLog -ActivityID 上一步输出的UUID # 打印这次失败操作的详细日志对照日志里的子错误码子错误码原因处理0x800706D9防火墙端点映射器不可用确认 Windows 防火墙已开启、服务在运行排除第三方防火墙拦截0x80073B06应用启动图无法识别重新下载构建自构建用户删除旧产物并重新构建路径过长/找不到文件文件夹路径问题缩短路径、去掉特殊字符完整流程见 Documentation/Fix Guides/Pre-Install Issues/Fix Error 0x80073CF6.md。错误 0x80073D10架构装反了原因非常单纯x64 系统装了 arm64 包或反之。解决方法回关于页面确认系统类型重新下载对应架构的 .7z覆盖旧文件后重装。详见 Fix Error 0x80073D10.md。WSA 打不开 / 花屏先看显卡Intel HD 530 及更早的核显WSA 可能无法启动或持续花屏这是已知且暂无根治方案的问题NVIDIA 独显已知会引发兼容问题两者都指向同一个操作在 WSA 设置中把渲染 GPU 切换成另一块可用显卡或Microsoft Basic Renderer具体步骤见 Documentation/Usage Guides/General Usage Guides/ChangingGPU.md 排错时别只盯着 WSABuilds。可以先用微软商店的官方 WSA 测一下同一台机器能不能跑官方版也起不来说明问题出在 Windows 环境而非本项目的构建走 Documentation/Fix Guides/Troubleshooting.md 里的通用排查流程。 数据只有一个文件userdata.vhdxWSA 里所有应用、账号、设置全部装在一个虚拟磁盘文件里%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx卸载、重装、换版本之前先复制这个文件到安全位置。恢复时把备份拷回原路径即可操作细节在 Documentation/WSABuilds/Backup and Restore.md。 更新或大动作前养成先关 WSA 再拷文件的习惯设置里点Turn off等加载动画消失再复制拷半路的 vhdx 是恢复不了的。 无数据丢失的更新流程WSA 设置中点Turn off确认关闭同时确保 WSA-Sideloader、WSAPacman 之类第三方工具没在运行下载新版本的 .7z用解压工具打开后进入内部的WSA_2xxx...子文件夹全选里面的文件解压到你现有 WSA 安装目录弹窗时选对全部当前项目执行此操作和替换目标中的文件双击Run.bat打开 WSA 设置 →关于About页核对版本号是否已更新如果是从旧版 MagiskOnWSA 更新脚本会自动卸载旧版并保留用户数据不用手动处理。完整说明见 Documentation/WSABuilds/Updating.md。 进阶玩法root 模块、侧载与搬家装 Magisk 模块Magisk 官方在线模块仓库已被下架管理器里列表是空的属正常现象。用本地安装方式adb push module.zip /data/local/tmp # 把模块包推到 WSA 的临时目录 adb shell su -c magisk --install-module /data/local/tmp/module.zip # 以 root 权限安装该模块侧载 APK不依赖商店装应用Documentation/Usage Guides/Sideloading Guides/Sideloading.md 里提供了 ADB、WSA-Sideloader、WSAPacman 三种方式新手建议先用 ADB 直装熟悉流程。C 盘不够用整体搬到别的盘目标分区必须是 NTFS、预留约 20GB核心操作是把%LOCALAPPDATA%\Packages下的 WSA 数据目录拷走后建一个目录联接mklink /J %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe E:\WSAData # 用目录联接把原位置指向新位置E:\WSAData 换成实际路径完整步骤在 Documentation/Usage Guides/General Usage Guides/MoveToExtDrive.md。KernelSU不想用 Magisk 的话Documentation/Usage Guides/General Usage Guides/KernelSU.md 覆盖了从 No Gapps 到 GApps、含/不含 Amazon Appstore 的全部组合场景。❓ 高频问题 Q/AQ安装完能删掉 WSA 文件夹省空间吗不能。包注册依赖这些文件一直在删除等于卸载。想释放 C 盘请走搬家到外置盘流程见上一节。QMagisk 怎么升级没有单独入口。等包含新版 Magisk 的 WSABuilds 发布然后按无数据丢失的更新流程整体更新。KernelSU 同理。Q能过 SafetyNet / Play Integrity 吗默认不能。WSA 本质是虚拟机缺少 Google 签名认证社区有一些未经验证的折腾方案但对日常使用没有实际意义。QOpenGApps 和 MindTheGapps 能来回切换吗不能。切换后 GApps 会失效必须先按 Documentation/WSABuilds/Uninstallation.md 彻底卸载再重装目标版本。Q怎么看应用日志logcat两种adb logcat直接输出或读取本地文件%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat。Q应用兼容列表在哪查项目维护了一张很长的实测表覆盖 App 和游戏两大类见 Documentation/WSABuilds/App Compatibility.md。装之前先搜一下你的目标应用能少走不少弯路。 收尾清单操作前✅ 虚拟化已在 BIOS/UEFI 和 Windows 可选功能中开启✅ 安装分区是 NTFSC 盘空闲 ≥10GB✅ 已卸载官方版 WSA如装过或已备份userdata.vhdx操作后✅ WSA 设置能正常打开、版本号正确✅ ADB 能连上开发者模式已开✅ 备份过userdata.vhdx再谈任何卸载/换版本WSA 的官方支持虽然落幕但 WSABuilds 的 LTS 承诺意味着这条路还会长走一段。按上面的步骤来第一次不顺利也别急90% 的卡点集中在架构选错、NTFS 没满足、旧版残留没清干净这三处。遇到这里没覆盖的问题先看仓库自带的文档目录 Documentation/——从安装、更新到每个具体错误码都有对应页面——再到项目的社区渠道提问。祝你顺利把第一个 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考