企业官网建设流程全解析

WSABuilds 如何上手：3 条路径装好带 Google Play 商店与 root 的 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 Subsystem for Android（WSA）安装包，内置 MindTheGapps（Google Play 商店）和 Magisk / KernelSU 两种 root 方案，面向 Windows 10 / 11 用户。官方 WSA 已于 2025 年 3 月 5 日结束支持，该仓库对 2311.40000.5.0 及以上的 WSA 版本转入 LTS 长期维护。官方版本没有 root 也没有 Play 商店，而这份安装包解压即用；Win10 / Win11 均有 x64 包，Win11 额外提供 arm64 包。本文覆盖装前自检、构建选择、三条安装路径、数据迁移与高频卡点排查。

先过机器自检：装之前把 6 项开关确认一遍 📋

WSA 本质是一台跑在 Hypervisor 上的虚拟机，任何一项硬条件不满足，后面都会以报错的形式找上门。对照下表逐项确认，全部打勾再下载：

自定义精简系统（ReviOS、Tiny 10/11 一类）跑 WSA 容易出问题，不在推荐范围内。

按架构和组件挑对 .7z 包：root、GApps 一次选清 🧩

到 Releases 页的 Assets 区，按"系统 + 架构"下载对应的.7z（Win10 / Win11 x64，Win11 另有 arm64），不要点 "Source code"。包名本身就携带了组件信息，对照下表决定选哪个：

LTS 版本 = 社区持续跟进 Magisk / KernelSU / GApps 更新；求稳优先 LTS，求新功能看非 LTS。

全新安装：从解压到 WSA 桌面出现的 5 个动作

1. 打开optionalfeatures.exe确认"虚拟机平台""Windows Hypervisor 平台"均已勾选，未勾选则勾选后重启。
2. 用 7-Zip 或 WinRAR 解压下载的.7z，把解压出的文件夹重命名为WSA（原名过长会引发启动失败）。
3. 把WSA文件夹整体移动到稳定位置（文档目录即可）；该文件夹是运行期硬依赖，装好后永远不能删除，只能整体移动。
4. 双击Run.bat，等待安装完成；WSA 会自动启动，首次会弹出诊断信息同意窗口，出现两个相同窗口点两次确定即可，属正常现象。
5. 打开 WSA 设置核对版本号，并在"开发者"页开启开发者模式，为后续adb和侧载工具留好入口。

装不上时按这个顺序补救：

• 管理员 PowerShell 进入文件夹目录，执行PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1（Run.bat弹窗一闪而过时基本都是权限问题）。
• 仍失败则在管理员 PowerShell 中执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml，记下报错里的 ActivityID（UUID），再执行Get-AppPackageLog -ActivityID <uuid>查看注册失败日志，按日志定位原因。

从官方旧版或旧构建迁移：先保数据再覆盖

1. 备份数据盘：复制%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx到安全位置，你的应用、账号、设置都在这个文件里。
2. 在"应用"中卸载当前的官方 WSA 或旧 WSABuilds——两者互斥，不能并存。
3. 在 WSA 设置中关闭 WSA（等加载动画消失），同时退出 WSA-Sideloader 等正在运行的工具。
4. 将新版.7z内层子文件夹的全部文件解压到原WSA文件夹，提示替换时选"对当前所有项目执行此操作"并点"是"。
5. 运行Run.bat，脚本会自动移除旧注册并保留用户数据。
6. 打开 WSA 设置的 About 页核对版本号；发现数据丢失再按备份恢复文档还原userdata.vhdx，流程见 Backup and Restore.md。

最简用法：NoGApps 构建 + ADB 装应用

1. 下载文件名带NoGApps的构建，GApps 有已知问题时它通常最省心。
2. 安装动作与全新安装完全一致：解压、重命名为WSA、双击Run.bat。
3. 在 WSA 设置的开发者页打开 Developer mode。
4. adb connect localhost:58526，之后adb install 你的.apk即可装包。
5. 之后想换 GApps 版或反之，先按卸载文档完全卸载当前构建，再装新包，直接覆盖切换必然失效。

卡住了：7 个高频问题的现象与解法 ⚠️

1. 现象：Run.bat弹窗一闪而过，应用列表里没有 WSA →可能原因：脚本没拿到管理员权限 →处理：管理员 PowerShell 里手动执行PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1。
2. 现象：安装时报 0x80073CF0 / 0x80073CF6 / 0x80073CFD / 0x80073D10 一类错误 →可能原因：分区非 NTFS、虚拟化功能缺失、下载文件损坏或路径过长 →处理：确认 C 盘是 NTFS，optionalfeatures.exe补齐两项功能，重下压缩包并把文件夹改名成WSA后再装。
3. 现象：装完 WSA 设置应用闪退、桌面没有任何 Android 应用图标 →可能原因：安装文件夹名过长（No Splashscreen问题的典型诱因）→处理：把文件夹改名为短名称（如WSA）后重新运行Run.bat。
4. 现象：能装但 WSA 无法启动或画面撕裂，多见于 Intel HD 530 及更早核显、部分 Nvidia 显卡 →可能原因：GPU 渲染不兼容 →处理：WSA 设置"图形与性能"页切换 GPU，或直接选 Microsoft Basic Renderer，步骤见 ChangingGPU.md。
5. 现象：Win11 上 GApps 构建随机闪退（2025 年 6 月后的已知问题）→可能原因：社区仍在修复 →处理：临时改用NoGApps构建，或退回已知可用的 2211 / 2210 旧版本。
6. 现象：adb connect localhost:58526被拒连 →可能原因：开发者模式未开启，或实际地址与默认不符 →处理：在 WSA 设置开发者页打开开关；仍连不上就抄该页显示的实际 IP 地址再连。
7. 现象：删除了安装文件夹后 WSA 彻底失效 →可能原因：它是以未打包文件注册的，文件夹必须常驻 →处理：需要腾位置就整体移动文件夹；已删除的只能重装，重装前记得先备份userdata.vhdx。

Play 商店登录账号后反复崩溃（12/13 代 Intel 平台高发）另见 Google Play Issues.md：在 Android 设置里给 Google Play Services 清"存储和缓存"即可。

装好之后的 3 个进阶方向 🚀

换 GPU。WSA 设置里先点 Turn off，再进"图形与性能"页，在"Android 应用使用的 GPU"下拉框里换独显、核显或 Microsoft Basic Renderer，改完重开即可。这是老核显和部分 Nvidia 用户最常用的一招。

root 模块与 APK 侧载。Magisk 的在线模块仓库已被官方移除，装模块走本地更稳：adb push module.zip /data/local/tmp后执行adb shell su -c magisk --install-module /data/local/tmp/module.zip；system 分区被 Hyper-V 挂载为只读，想改系统走 Magisk 模块或直接改system.img。装 APK 则用 WSA-Sideloader、WSAPacman、WSAFiles 等工具在 WSA 界面内点选安装，或用adb install，工具说明见 Sideloading.md。

数据迁移与外盘部署。大版本更新前先拷一次userdata.vhdx，换系统时原样放回即可。想把 WSA 挪到空间更大的盘，目标盘必须是 NTFS：整包解压安装到目标盘后，把%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe移过去，再用mklink /J建回目录链接，完整步骤见 MoveToExtDrive.md。

仓库内文档索引：细节去哪查

• 完整安装与注册失败诊断：Installation.md
• 不丢数据的版本升级流程：Updating.md
• userdata.vhdx 备份与恢复：Backup and Restore.md
• 干净卸载（含官方版本）：Uninstallation.md
• 高频问答：logcat 获取、SafetyNet、GApps 切换规则：FAQ.md
• 单个应用的兼容状态查询：App Compatibility.md
• 按错误码与症状分类的修复手册：Fix Guides/（Pre-Install / Post-Install 两档）
• GPU 切换、KernelSU、外盘迁移、侧载工具教程：Usage Guides/
• 旧版本下载清单：OldBuilds.md
• 构建脚本与排障文档源文件：MagiskOnWSA/

下一步：先用optionalfeatures.exe确认两项虚拟化功能已勾选，再按你的系统版本与组件需求从 Releases 页挑一个.7z，照"全新安装"一节把文件夹重命名为WSA并双击Run.bat，十分钟内就能看到 Play 商店和 root。

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