企业官网建设流程全解析

WSABuilds 安装指南：Windows 10/11 快速上手带 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 提供预打包的 WSA（Windows Subsystem for Android）安装镜像，把 Google Play（MindTheGapps）和 Magisk/KernelSU 直接打进系统，让 Windows 10/11 的 PC 直接运行带 root 的 Android 应用。先说结论：这套镜像适合所有想在 Windows 上跑 Android 应用且需要 root 的人，全文按「门槛→清理→安装→验证→排障→维护」六步走，翻车高发点一共 4 处：目录名没改对、两个系统功能没开、旧版没卸干净、Play 不亮。带着这张地图往下读，15 分钟内能装完。

🖥️ 准入门槛：虚拟化是硬门槛，其余都是裕量项

先说结论：硬件上只有一项是硬门槛——CPU 虚拟化且在 BIOS/UEFI 里打开，其余配置都属于裕量问题。

硬门槛（缺一不能装）：

• CPU 支持虚拟化（Intel VT-x / AMD-V），且已在 BIOS/UEFI 中开启
• 目标分区必须是 NTFS，exFAT 分区直接不行
• Windows 11 build 22000.526 及以上，或 Windows 10 22H2（10.0.19045.2311）及以上
• 系统功能 Virtual Machine Platform 已启用（开关命令见下一节）

裕量项（不达标也能装，体验打折）：

• 内存：8GB 是最低线，常开多个应用建议 16GB，4~6GB 不推荐
• 磁盘：C 盘至少 10GB 空闲，SSD 明显优于 HDD
• 架构：x86_64 或 arm64 均可，但 Win10 下 CPU 最好在 Win11 支持列表里
• 显卡：Intel/AMD/Nvidia 都能用，但 Intel HD 530 及更早核显、部分 Nvidia 显卡可能起不来或花屏

⚠️ BIOS 里没开虚拟化就装，注册大概率失败且报含糊错误；不先确认它，后面所有排障都是白费时间。

🧹 冲突清理：开三个功能开关，卸干净旧版

先说结论：注册失败的头号原因是系统功能没开，二号原因是旧版 WSA 或旧版 MagiskOnWSA 没卸干净——两件事在装之前做完。

1. 以管理员身份打开 PowerShell，执行：

   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform

   如果提示需要重启，重启后再继续。

2. 装过官方 WSA 或旧版 MagiskOnWSA 的，先完整卸载：开始菜单搜索Windows Subsystem for Android Settings，进入卸载；卸载完检查%LOCALAPPDATA%\Packages\下是否残留MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe目录，有就删掉（删不掉说明 WSA 还在运行，先关掉）。

3. 需要查阅完整文档时，把仓库克隆到本地：

   git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds

⚠️ 要留数据的话，卸载前必须先备份 userdata.vhdx（完整路径见「长期维护」一节）；不备份就卸，旧数据直接消失。

📦 主线操作：拿到 → 就位 → 执行，三拍装完

先说结论：安装本质是「下载 .7z → 重命名文件夹 → 注册 appx」三件事，Run.bat 是主方案，手动跑 Install.ps1 是兜底。

第一拍：拿到——从发布页下 .7z，资产名就是变体名

在发布页的 Assets 区，按操作系统（Windows 10 / Windows 11）和架构（x64 / arm64）选对应构建下载。各变体差异：

⚠️ 只下 .7z 安装包，别选 "Source code (zip)"——那是源码，里面没有可注册的安装内容，选了等于白下。

⚠️ GApps 构建在 2025 年 6 月之后的部分 Win11 系统上有崩溃问题；你的构建若反复闪退，先换 NoGApps 构建或 2211/2210 老构建过渡。

此步最容易错在哪：选错系统/架构——Win10 机器下了 Windows 11 的包，注册必失败。

第二拍：就位——文件夹必须叫 WSA，放固定位置，永不许删

1. 用 7-Zip 或 WinRAR 解压 .7z。
2. 把解压出来的文件夹重命名为WSA（就这三个字母）。
3. 删掉 .7z 压缩包，把 WSA 文件夹移到一个固定位置（如C:\Users\你的用户名\Documents\WSA），之后常驻此机。

⚠️ 注册用的是这个文件夹里未打包的 appx 文件（AppxManifest.xml），文件夹一删 WSA 立刻起不来；目录名带长串版本号或特殊字符也会导致无法启动，不改名就装等于给自己挖坑。

此步最容易错在哪：解压后图省事直接装——脚本自动生成的长文件夹名（如WSA_2407.40000.4.0_...-RemovedAmazon）是启动失败的常见原因。

第三拍：执行——Run.bat 主方案，Install.ps1 兜底

1. 进入 WSA 文件夹，双击Run.bat，按提示允许管理员权限。之前装过旧版 MagiskOnWSA 的话，脚本会自动卸载旧版并保留用户数据。

2. 若弹窗一闪而过、WSA 没装上，用管理员终端（Win+X → 终端(管理员)）手动注册兜底：

   cd "{X:\path\to\WSA}" # 把 X:\path\to\WSA 换成你实际放 WSA 文件夹的完整路径 PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

3. 兜底仍失败时，在 WSA 目录执行下面两条，用第一条报错里的 ActivityID 查失败日志：

   Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID <ActivityID>

   <ActivityID>是上一步报错输出中的 UUID。手动执行仍然失败，说明这台机器本身不支持 WSA，停止反复重试。

此步最容易错在哪：cd进了错的目录——必须 cd 到直接包含AppxManifest.xml的那层 WSA 文件夹。

🚦 跑通验证：启动信号、版本号与第一个应用

先说结论：能打开设置应用、About 页版本号与所装构建一致，就算装通了。

启动信号（首次启动）：会弹诊断信息同意窗口，有时出现两个一模一样的，都点 OK 即可；随后 PowerShell 窗口显示 "Press any key to quit"，在窗口上按任意键将其关闭。

验证点：

• 开始菜单搜索Windows Subsystem for Android，设置应用能正常打开
• 打开 About 页签，版本号应与你下载的构建一致（当前 LTS 版本为 v2407.40000.4.0）

第一个真实任务（最小可用示例）：

• 路线一（最省）：在 Google Play 里搜索任意应用安装并运行

• 路线二（ADB 侧载，需先在设置里开启开发人员模式）：

  adb connect 127.0.0.1:58526

• 游戏/图形应用异常时，在设置的「图形和性能」页签切换 Android 应用使用的 GPU；先关闭 WSA 再改，参考 GPU 切换指南

🛠️ 排障矩阵：五类高频故障一张表查完

先说结论：绝大多数装不动的情况都落在下表 5 类里，排查顺序固定为「先查硬件与系统功能，再查目录与脚本」。

表内命令统一放在这里：

# 查注册失败日志（<ActivityID> 替换为注册报错中的 UUID） Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml Get-AppPackageLog -ActivityID <ActivityID>

# ADB 备用连接（IP 为 WSA 设置 Developer 页签显示的地址） adb connect <WSA-IP>:5555

🔁 长期维护：更新、备份、换机，全围绕一个文件

先说结论：所有应用与数据都存在userdata.vhdx这一个虚拟磁盘里，备份、换机、恢复只需要盯住它。

路径（备份/恢复都指向这里）：

%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx

更新（覆盖安装，不丢数据）：

1. 设置里点 Turn off，等加载动画消失；确认 WSA-System-Control、WSA-Sideloader、WSAPacman 等第三方工具没在运行
2. 解压新版 .7z，把其子目录内的全部文件覆盖到原 WSA 文件夹，替换提示选 "Do this for all current items" + "Yes"
3. 重跑 Run.bat，About 页核对版本号
4. 详细步骤见 更新流程

备份：把 userdata.vhdx 复制到安全位置（移动硬盘/网盘均可）。

恢复/换机（按序执行）：

1. 完整卸载 WSA，见 卸载说明
2. 在 WSA 文件夹的Install.ps1中删掉Start-Process "wsa://…"相关行（行内容随构建变体不同，Android Settings 对应Start-Process "wsa://com.android.settings"，Magisk 对应Start-Process "wsa://com.topjohnwu.magisk"）
3. 运行脚本安装，期间弹出的对话框一律忽略
4. 把备份的 userdata.vhdx 放回%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\（目录不存在就先建）
5. 启动 WSA，数据恢复完成。完整流程见 备份与恢复

📌 收尾速查：五件事记牢就够

• 查门槛：Win11 22000.526+ / Win10 22H2+，BIOS 虚拟化已开，WSL + VMP + HypervisorPlatform 三个功能已启用，旧版已卸干净
• 装：.7z 解压 → 文件夹改名为WSA→ 双击 Run.bat → 失败则管理员终端手动跑Install.ps1
• 验：设置应用能打开，About 页版本号与构建一致，装第一个应用跑通
• 更：Turn off → 覆盖文件 → 重跑 Run.bat → 核对版本
• 保：备份与恢复只认userdata.vhdx这一个文件

仓库内文档直达：

• 安装说明
• 更新流程
• 卸载说明
• 备份与恢复
• FAQ
• 排障总览
• ADB 侧载指南
• Magisk 模块使用

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