WSABuilds 安装与使用指南:十分钟给 Windows 装上安卓子系统,Google 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
WSABuilds 是 Windows Subsystem for Android(WSA)的增强版开源构建,预集成 Google Play 商店(MindTheGapps)和 Magisk/KernelSU root 方案,让你在 Windows 10/11 上直接运行安卓应用。它适合想在电脑上跑手游、使用安卓专属应用的用户,也适合需要用 ADB 调试的轻度开发者。
WSABuilds 安装前的系统检查
先花两分钟确认机器能跑,比装完再排错省事。
- 系统版本:Windows 11(推荐)或 Windows 10 2004 及以上。
- 内存至少 8GB,磁盘至少 20GB 空闲,WSA 所在分区必须是 NTFS。
- 虚拟化必须开启:在任务管理器"性能"选项卡看"虚拟化:已启用",没有就进 BIOS/UEFI 打开。
用管理员 PowerShell 启用两个功能(执行后可能需要重启):
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform一个前提:如果你装过官方 WSA,必须先彻底卸载它,两者不能共存。已有数据想保留的话,卸载前先备份下一节提到的 userdata.vhdx。
十分钟跑起来:下载、重命名、双击 Run.bat
从 Releases 页面下载最新版 .7z 归档,解压后把文件夹重命名为WSA,然后放到一个你愿意长期保留的位置(文档文件夹即可)。这一步是硬性要求:文件夹名过长会导致 WSA 起不来。之后删掉 .7z,双击WSA文件夹里的Run.bat,按提示授权管理员权限。
装完会自动启动 WSA,首次运行出现的诊断信息同意窗口点确认即可(偶尔弹两个相同窗口都点掉,无害)。脚本窗口提示按键退出后,按任意键关闭。如果弹窗一闪而过、WSA 没装上,用管理员 Windows 终端手动执行:
cd "X:\path\to\your\WSA" PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1装完不要删 WSA 文件夹,注册机制依赖这些本地文件,删了系统就没了。
按你的目的来
只想装应用
带 Google Play 的构建打开商店直接装就行,账号登录和真机一样。商店里没有的应用可以走 ADB 侧载,方法见下文 ADB 一节;仓库里的 ADB-Sideloading 指南 有更详细的步骤和推荐应用清单。
要 root 权限
下载时选带 Magisk 或 KernelSU 的构建版本,装完 WSA 里就有 Magisk Manager(或 KernelSU 管理器)应用,打开它按提示完成初始设置,重启 WSA 后 root 即生效。注意:Magisk 的在线模块列表是空的(官方仓库已下线),装模块用本地 zip:先adb push module.zip /data/local/tmp,再adb shell su -c magisk --install-module /data/local/tmp/module.zip。
用 ADB 做调试
打开 WSA 设置应用,在"高级设置"里开启开发者模式,记下显示的 IP 和端口。在 Windows 终端执行adb connect 127.0.0.1:58526,再adb devices确认连上。连不上就用开发者页面上显示的端口试一下,比如adb connect <IP>:5555。之后adb install、adb logcat、adb shell都照常可用,常用组合参考 FAQ。
出问题了先查这三点
WSA 装完起不来。最可能的原因:虚拟化没开、文件夹没重命名为WSA、路径过长或含特殊字符。依次检查 BIOS/UEFI、文件夹名和所在路径;都没问题再看事件查看器里的详细报错。
Run.bat 注册失败。用管理员 PowerShell 进入 WSA 目录执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml,命令会失败并给出一个 ActivityID(UUID),紧接着执行Get-AppPackageLog -ActivityID <UUID>就能看到具体失败原因。
应用连不上 Windows 的 localhost。2308 及之后的 WSA 已内置 localhost 回环,直接访问即可;旧版本按 LocalHostLoopback 指南 用管理员 PowerShell 配置回环规则。
长期用得稳:更新、备份与资源分配
更新不丢数据:先关闭 WSA(设置应用里点"关闭"),把新版本 .7z 里的子文件夹文件解压到现有 WSA 文件夹,全部替换,再跑一次Run.bat。装好的应用和数据都还在,打开设置的"关于"页可确认版本号。
所有应用、设置、数据都在userdata.vhdx里,路径为%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx。重装或换机前把它拷走;恢复时先卸载 WSA,删除新版Install.ps1里自动拉起应用的Start-Process "wsa://..."几行(不同构建要删的行不同),把备份的 vhdx 放回 LocalCache 目录,再启动 WSA。
资源上给 WSA 留 4GB 以上内存和 2 个以上 CPU 核心比较舒服;用 SSD 装 WSA 文件夹,应用加载会明显更快。
写在最后
把系统检查、文件夹重命名成WSA、备份 userdata.vhdx 这三件事做好,WSABuilds 基本不会给你添麻烦。遇到具体报错别硬试,仓库自带文档比搜索更快定位问题:FAQ、Troubleshooting、ADB-Sideloading 侧载指南。
【免费下载链接】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),仅供参考