企业官网建设流程全解析

WSABuilds安装教程：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 是官方 WSA 停更后仍在发版的社区 WSA 替代方案，用来在 Windows 运行 Android 子系统。它提供预编译安装包，内置 Google Play 服务（MindTheGapps），并可选 Magisk 或 KernelSU 两种 Root 方案。从装前检查到首次启动约需 15 分钟，一般不用重启系统。

🎯 官方停更后，WSABuilds 接手了什么

官方 WSA（Windows Subsystem for Android，微软在 Windows 上的安卓子系统）于 2025 年 3 月停止支持，商店版本就此冻结。WSABuilds 在社区继续打包发版，对 2311.40000.5.0 之后的 WSA 版本提供长期维护，Magisk、KernelSU 与 GApps 会随新构建更新。项目沿用 MagiskOnWSA 的打包方式，把 Root 与 Google 服务直接做进安装包，你不用自己拼环境。

装前检查：两分钟确认电脑合格

装之前先花两分钟确认电脑合格，不合格的配置装了也跑不起来。对照下面这份清单：

• 系统版本：Win11 需 build 22000.526 以上；Win10 需 22H2（10.0.19045.2311 以上）
• 内存：8GB 起步，16GB 更稳
• 磁盘：C 盘至少 10GB 空闲，且必须是 NTFS 分区
• Windows 功能：启用"虚拟机平台"与"Windows 虚拟机监控程序平台"（Win+R 输入OptionalFeatures.exe可打开该设置）
• 虚拟化：BIOS/UEFI 中已开启

先看系统版本号：

[System.Environment]::OSVersion.Version

显卡有两个已知坑。Intel HD 530 及更早的核显可能无法启动或出现画面错乱；Nvidia 显卡偶发启动失败或渲染问题。遇到这两类情况，参考 切换显卡指南 换用其他显卡或 Microsoft Basic Renderer。

📦 WSABuilds 安装教程：7 步完成

从下载包到 WSA 首次启动，按下面 7 步走。如果你装过官方 WSA，必须先完整卸载（见 卸载文档），否则包注册会冲突。

1. 从发行版页面下载与系统、架构匹配的 .7z。文件名里包含版本号、Root 方案、是否带 GApps 与亚马逊商店，别拿"Source code"。
2. 解压后把文件夹改名为WSA。长文件夹名或路径过深都会导致启动失败。
3. 把文件夹放到固定位置（文档目录即可）。安装是对这批散装文件做包注册，之后删掉文件夹就等于卸载。
4. 双击文件夹里的Run.bat。脚本会补齐缺失的 Windows 功能、注册包并拉起 WSA。
5. 如果弹窗一闪而过或安装失败，打开管理员终端手动执行：

cd "C:\Users\你的用户名\WSA" PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

6. 首次启动会弹出诊断数据同意窗口；出现两个一样的窗口时，都点同意即可。
7. 回到 PowerShell 窗口按任意键退出，WSA 窗口此时已可正常使用。

🔌 装完怎么验证：版本、设置与 ADB

装好不等于没问题，这一节用三条命令验证包注册、设置入口和 ADB 调试。

第一步，查已注册的包和版本：

Get-AppxPackage *WindowsSubsystemForAndroid* | Select-Object Name, Version

第二步，用wsa://com.android.settings直接打开安卓设置，在"关于"页核对版本号是否与下载的版本一致。

第三步，打开 WSA 设置里的开发者模式，再用 ADB 连接：

adb connect 127.0.0.1:58526 adb devices

连不上时，到设置 → 开发者页核对实际 IP，改用adb connect IP:5555。日志用adb logcat抓取；也可以直接看本地文件%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat。

🧩 Root 方案怎么选，模块怎么装

下载时挑好版本，装完就能用，加模块也只需要两条命令。WSABuilds 的包在打包阶段就分好了：带 Magisk、带 KernelSU、或两者都不带。带 GApps 的版本默认捆绑 Magisk，非 LTS 版本默认不带。

Magisk 的在线模块仓库已被上游移除，列表是空的，模块走本地推送：

adb push module.zip /data/local/tmp adb shell su -c "magisk --install-module /data/local/tmp/module.zip"

KernelSU 的管理器与模块用法见 KernelSU 指南。另外两点要有预期：SafetyNet / Play Integrity 没有稳定通过的办法，虚拟环境缺少 Google 签名；GApps 与 OpenGApps 不能互换，切换前需要完整卸载重装。

⚙️ Google 服务、侧载与兼容性

日常最常用的三件事：确认 Google 服务可用、往系统里装 APK、判断应用能不能跑。

• GApps 版本自带 Play 商店与 Play 服务，登录 Play 商店能正常加载即说明服务可用。
• 注意：2025 年 6 月起，Win11 上 GApps 版本存在崩溃问题（仓库 README 有警示）。遇到时改用 NoGApps 构建，或换 2211/2210 老版本。
• 32 位 ARM 应用走内置 libhoudini 兼容层，目录在 MagiskOnWSA/libhoudini/。
• 侧载 APK 用 ADB 安装即可，专用侧载工具列表见 侧载指南。
• 用 URI 快捷启动应用：wsa://应用包名，在 Win+R 里直接输入即可。
• 装应用前先查 应用兼容性表，里面标注了测试过的状态和注意事项。

🔄 更新 WSABuilds 与备份数据

更新和换机时最怕丢数据。WSA 的应用与设置都存在 userdata.vhdx 里，更新本身不会动它，但备份要自己做。

更新流程（详见 Updating 文档）：

1. 在 WSA 设置里关闭 WSA，等加载指示消失；关掉一切侧载工具。
2. 下载新 .7z，把包内子文件夹的全部文件解压到旧文件夹，覆盖时选择"对当前所有项目执行"。
3. 重新运行Run.bat。
4. 打开设置 → 关于，核对版本号。

需要完整备份时，在 WSA 关闭状态下把这份文件拷到另一块盘：%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx。恢复流程写在 备份与恢复指南。

🚑 常见故障场景速查

出问题先对号入座，再打开对应文档，比盲目重装省事。所有条目都在 Having Issues 汇总。

包注册失败时，终端会返回一个 ActivityID，用Get-AppPackageLog -ActivityID <uuid>可以看到失败日志，按日志定位原因。

🚀 下一步行动

• 跑一遍装前检查，确认两个 Windows 功能与虚拟化都已开启
• 按系统架构下载对应 .7z，解压后把文件夹改名为 WSA 并固定存放位置
• 用Get-AppxPackage和adb devices各验证一次安装结果
• 把 userdata.vhdx 备份到第二块盘，之后每次大更新前照做
• 需要定制版本（设备型号、Root 方案、是否带 GApps）时，按 自定义构建说明 列清信息再提需求

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