WSABuilds Windows安卓子系统完整安装指南:从解包到首次启动
【免费下载链接】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 安卓子系统(WSA)二进制文件,内置 Google Play 商店(MindTheGapps)以及 Magisk 或 KernelSU rooting 方案,面向开发者和需要在 Windows 上运行安卓应用的普通用户。装完之后,你的电脑里会多出一个能跑应用、能用 adb 调试的安卓环境。
WSA 跑起来是什么效果
部署完成后,开始菜单会出现 "Windows Subsystem for Android" 图标,双击即可进入安卓桌面。带 Play Store 的构建可以在里面直接搜索、安装应用;装了 root 方案的构建还能执行 root 操作。开启开发者模式后,在 Windows 侧运行 adb 命令就能连进这个环境,例如adb shell top -m 10查看资源占用前 10 的进程,方便你随时监控状态。
WSABuilds 安装前检查清单
开工前把下面几项逐条勾掉,任何一条不达标都可能导致装不上或启动异常。
先选构建线:
| 构建线 | 当前版本 | 发布节奏 | 面向人群 |
|---|---|---|---|
| LTS(长期支持) | v2407.40000.4.0_LTS_7 | 每月一次 | 企业办公、日常使用 |
| 非LTS | v2407.40000.4.0_v2 | 每月多次 | 功能尝鲜、开发测试 |
两条构建线都支持 x86_64 与 arm64 架构,按你的 CPU 选对应的包。
- Windows 11 Build 22000.526 及以上,或 Windows 10 22H2(10.0.19045.2311 及以上);ReviOS、Tiny 10/11 这类魔改系统可能不兼容,建议用原版 Windows
- 内存 8GB 起步,16GB 以上更稳
- SSD 硬盘,至少 10GB 可用空间
- CPU 为 x86_64 或 arm64 架构,BIOS/UEFI 里已开虚拟化(Intel VT-x 或 AMD SVM)
- "虚拟机平台"与"Windows Hypervisor 平台"两个系统功能已启用
最后一项用两条命令开启。以管理员身份打开 PowerShell,粘贴执行,然后重启电脑:
dism /online /enable-feature /featurename:VirtualMachinePlatform /all dism /online /enable-feature /featurename:HypervisorPlatform /allWSA 完整安装流程
整个安装就是一条执行线:取包 → 解压 → 改名 → 落位 → 跑脚本。
先克隆完整代码库拿到安装包:
git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds接着按顺序做四件事:
- 用 7-Zip 解压 .7z 压缩包,保证文件完整性
- 把解压出来的文件夹重命名为
WSA,名字里不能有空格或特殊字符 - 移到一个非系统盘的根目录,比如
D:\WSA,放太深的目录容易报路径过长 - 双击文件夹里的
Run.bat,脚本会自动申请管理员权限,UAC 弹窗点"是"
如果窗口一闪而过、安装没跑完,走手动分支:打开管理员权限的 Windows Terminal,先执行cd "D:\WSA"进入安装目录(换成你的实际路径),再执行下面这条命令完成注册:
PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1脚本跑完后会停在一个 PowerShell 窗口,点一下窗口按任意键即可关闭。
WSA 首次启动验证
装没装好,看三个信号:
- 开始菜单图标:能搜到并打开 "Windows Subsystem for Android"
- 首启弹窗:第一次启动会弹诊断信息同意窗口,偶尔出现两个一样的窗口,都点确定即可;初始化约需几分钟,别急着判定失败
- adb 连通:执行下面的命令,返回 connected 即通道打通
adb connect localhost:58526前两项正常但 adb 连不上时,先确认已开启开发者模式(设置 > 系统 > 开发者选项),再重试。
按角色定制
| 角色 | 目标 | 关键配置 |
|---|---|---|
| 开发者 | 应用调试、多版本测试、性能分析 | 选非LTS 构建拿最新 API;开开发者模式,adb 接入调试(见首次启动验证);用adb shell top -m 10观察进程 |
| 普通用户 | 社交应用、媒体播放、移动办公 | 选 LTS 构建求稳;构建已带 Play Store,直接装应用;启用 GPU 硬件加速 |
| 企业 | 标准化部署、数据隔离、批量管理 | 走定制构建(参考 Custom Builds 文档);多实例隔离:把 WSA 文件夹复制到D:\WSA_Account2,再用Add-AppxPackage -Register "D:\WSA_Account2\AppxManifest.xml"注册新实例;定期备份userdata.vhdx |
资源方面,进 WSA 设置 > 系统调整:CPU 核心数建议 4 核以上,内存分配 8GB,虚拟硬盘设 64GB。显卡是 Intel HD Graphics 530 或更老的集显、或者用 Nvidia 卡出现花屏,参考 ChangingGPU.md 换到独显或 Microsoft Basic Renderer。
踩坑速查:WSA 常见问题
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 安装时报"路径过长" | WSA 文件夹放在嵌套较深的目录,或文件夹名太长 | 放到盘符根目录如D:\WSA,名称不超过 8 个字符,避免嵌套文件夹 |
| 应用闪退或打不开 | 应用不兼容 x86_64 架构,或低于 WSA 版本的最低系统要求 | 核对应用架构与 WSA 版本;设置 > 应用里选中该应用清除数据 |
| Google Play 商店连不上网 | Windows 网络代理设置,或防火墙、Hyper-V 网卡干扰 | 检查代理设置;WSA 设置 > 系统 > 重置中重置网络;仍不行按 FixInternet 文档 逐步排查 |
| WSA 打不开、图标失效 | 移动或删除了安装文件夹 | WSA 以未打包方式注册,⚠️ 安装文件夹不能挪位置;移动后需重跑Install.ps1重新注册,或把文件夹移回原路径 |
项目文档覆盖了更新、卸载、数据备份与恢复等后续操作,装好之后建议翻一遍 使用指南,遇到问题先查 WSABuilds 文档目录 再动手。
【免费下载链接】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),仅供参考