尧图网页设计 
WSABuilds 完整指南在 Windows 10/11 上装好带 Magisk 与 Google Play 的 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/WSABuildsWSABuilds 为 Windows 10/11 提供预装 MindTheGappsGoogle Play 商店与服务和 Magisk 或 KernelSU两种 Root 方案的 WSA 定制包。WSA 即 Windows Subsystem for Android微软在 Windows 上运行 Android 应用的兼容层。适合需要在 Windows 上跑依赖 Google 服务的 App、或给 Android 环境打 Root 模块的开发者。判断你的场景WSABuilds 适合谁先说结论它不是给所有人准备的适合需要 Google Play 商店/服务GMS的 Windows 用户——官方 WSA 已移除 GMS且微软已于 2025 年 3 月 5 日结束对 WSA 的官方支持见 README.md 中的 EoS 说明。需要 RootMagisk/KernelSU或想往 Android 环境里装模块LSPosed、Shizuku 类工具的人。愿意维护一个WSA 安装目录必须保留的固定部署见下文验证一节的原因。不适合只需要跑微软商店认证 App 的普通用户官方 WSA 更简单WSABuilds 属于第三方改造包不在微软支持范围内。需要官方持续更新的场景微软已停更 WSAWSABuilds 对 ≥ v2311.40000.5.0 的版本进入 LTS长期支持维护靠发布新版构建包跟进 Magisk/KernelSU/GApps 更新但 WSA 底座本身不再升级。⚠️ 注意README 顶部的警告区提到2025 年 6 月之后含 GApps 的构建在部分 Windows 11 上出现崩溃官方给出了临时缓解方案或改用文件名带NoGApps的构建。选型时先确认自己要装的是哪一类包。WSA 构建流程数据流全景不管你是下载预构建包还是自己构建产物都来自同一条流水线源码在 MagiskOnWSA/scripts/三个关键点下载不走商店。generateWSALinks.py直接对微软 FE3First Event Service微软交付更新的基础设施发 SOAP 请求模板是 MagiskOnWSA/xml/ 下的GetCookie.xml、WUIDRequest.xml、FE3FileUrl.xml拿到.msixbundle和 VCLibs、UI.Xaml 依赖包的真实下载链接。补丁打在 initrd 里不是 system 分区。细节下一节展开。最终产物是未签名的 Appx 目录靠随包携带的Install.ps1用Add-AppxPackage -Register就地注册这就是为什么安装目录删不得。WSA 预构建包三步安装步骤大多数用户走这条路去发布页拿.7z解压注册。依据是 Documentation/WSABuilds/Installation.md。第 1 步准备——确认硬件门槛Windows 11 Build 22000.526或 Windows 10 22H219045.2311内存 8 GB 起官方建议 16 GB系统盘C:\NTFS 分区且留 10 GB 以上启用「虚拟机平台」和「Windows 虚拟机监控程序平台」两个 Windows 功能WinR 输入OptionalFeatures.exe并在 BIOS/UEFI 里打开虚拟化。如果之前装过官方 WSA先彻底卸载再装这个两者不能共存。第 2 步执行——解压.7z后把解压出的文件夹重命名为WSA长文件夹名会导致 WSA 无法启动Documentation/WSABuilds/Information.md 列为已知问题双击其中的Run.bat。第 3 步验证——安装完成后按提示操作WSA 图标应出现在开始菜单并能启动首次启动会弹诊断数据同意框。若Run.bat窗口一闪而过没装上用管理员 PowerShell 手动注册cd X:\path\to\WSA PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1 原理提示Install.ps1本质是执行Add-AppxPackage -Register .\AppxManifest.xml把无包化文件注册成 Appx 包。注册只引用磁盘上的目录所以目录删了 WSA 就没了。诊断失败时可按 Installation.md 里的方法用Get-AppPackageLog -ActivityID uuid查具体报错。Linux 下自构建设置方法想自己产出构建包比如固定某个 Magisk 版本、或走 Release Preview 渠道在 Linux/WSL 环境里构建git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds cd WSABuilds/MagiskOnWSA bash scripts/run.shrun.sh是 whiptail/dialog 驱动的交互菜单要求 bash不要用sh运行先跑install_deps.sh自动装aria2c、7z、unzip等依赖再让你依次选架构x64/arm64、发布渠道retail/RP/WIS/WIF、Root 方案magisk/kernelsu/none、Magisk 版本、是否装 GApps、是否移除 Amazon Appstore、压缩格式7z/zip。确认后会打印最终命令行并调起build.sh。跳过交互直接构建./scripts/build.sh --arch x64 --release-type retail \ --root-sol magisk --magisk-ver stable \ --install-gapps --remove-amazon产物落在MagiskOnWSA/output/已下载的组件缓存在MagiskOnWSA/download/重复构建不用重新下载 WSA 主体可用--skip-download-wsa显式跳过。initrd 补丁机制解析Magisk 如何注入 WSA这是整个项目最核心的动作不动 Android 的 system 分区而是把 Root 能力塞进启动早期的 initrd 镜像。build.sh中对应片段完整逻辑见 MagiskOnWSA/scripts/build.sh 第 495–562 行$WORK_DIR/magisk/magiskboot cpio $WORK_DIR/wsa/$ARCH/Tools/initrd.img \ mv /init /wsainit \ add 0750 /lspinit ../bin/$ARCH/lspinit \ ln /lspinit /init \ add 0750 /magiskinit $WORK_DIR/magisk/magiskinit \ mkdir 0750 overlay.d \ add 000 overlay.d/init.lsp.magisk.rc init.lsp.magisk.rc \ add 000 overlay.d/sbin/post-fs-data.sh post-fs-data.sh 原理提示magiskboot是 Magisk 自带的镜像工具。这里把原始/init改名保留换成一个lspinit存根作为新入口它负责把 Magisk 挂载进启动流程并新增overlay.d目录存放 rc 脚本、post-fs-data.sh和lsp_cust.img一个存放 Magisk 二进制的自定义镜像。GApps 走同一机制把 MindTheGapps 的gapps.img加进 initrd由gapps.rc在开机时挂载。两条容易忽略的约束组合限制写在build.sh里--install-gapps与--root-sol kernelsu同时出现会直接中止Unsupported combinationnone GApps 会强制改回 Magisk因为挂载 gapps.img 需要 Magisk。KernelSU 路线完全不同它不碰 initrd而是从 WSA 的Tools/kernel读出内核版本号getKernelVersion下载匹配内核版本的 KernelSU zip直接把bzImage/Image替换进Tools/kernel原文件备份为kernel_origin。GApps 的 API 版本随 WSA 主版本联动WSA 2211 用 API 32否则 API 33见build.sh第 354–422 行。WSA 常见报错与解决方法现象可能原因处理办法装完 GApps 构建后 WSA 或 Play 服务崩溃Win112025-06 后的已知问题README 顶部警告换用NoGApps命名的构建或按 README 给出的缓解方案操作WSA 完全无法启动解压目录名很长构建/下载产生的长文件夹名是已知问题解压后把目录改名为WSA再安装Information.md 已知问题区Run.bat弹出即消失未安装权限不足注册被静默拒绝管理员 PowerShell 执行PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1Installation.md 第 6 步注册报 0x80073D10 类错误 / WSA 不启动缺少「虚拟机平台」「Windows 虚拟机监控程序平台」或 BIOS 未开虚拟化OptionalFeatures.exe启用两项功能BIOS 开启 VT-x/AMD-VREADME 需求表图形异常或 WSA 不启动独显为 Intel HD 530 及更旧/部分 NvidiaGPU 与 WSA 渲染层不兼容按 ChangingGPU.md 切换到另一显卡或 Microsoft Basic Renderer更多条目可查 Documentation/Fix Guides/按安装前/安装后分类的错误码文档和 Documentation/WSABuilds/Having Issues.md。build.sh 构建参数速查表以下参数与默认值取自build.sh的usage()与default()可直接运行参数取值默认值说明--archx64,arm64x64WSA 目标架构--release-typeretail,RP,WIS,WIFretail发布渠道稳定 / 预览 / Insider 慢速 / Insider 快速--root-solmagisk,kernelsu,nonemagiskRoot 方案none表示无 Root--magisk-verstable,beta,canary,debug,releasestableMagisk 渠道release配合--magisk-custom装自定义 zip--install-gapps开关关集成 MindTheGapps与 kernelsu 互斥--remove-amazon开关关删除 Amazon Appstoremado*.apex--compress-format7z,zip,nonenone输出压缩格式--offline/--skip-download-wsa开关关离线构建 / 跳过 WSA 主体下载依赖已缓存WSABuilds 与官方 WSA、模拟器的对比方案Google 服务Root 能力获取方式维护模式典型代价官方 WSA无已移除 GMS无微软商店已 EoS2025-03 起功能缺失但最省事WSABuilds 预构建包MindTheGapps 可选内置Magisk / KernelSU 可选内置发布页.7z直接装LTS 版本持续跟进组件更新目录必须保留第三方包无微软支持MagiskOnWSA 自构建可选渠道/版本自选版本自选stable 到 debugLinux 下run.sh/build.sh同上但产物可完全定制需 Linux 环境与时间独立 Android 模拟器随镜像而定视镜像而定各发行版各自维护与 Windows 桌面集成度低文件/剪贴板互通弱WSABuilds 的差异化在于把下载官方 msixbundle → 打 initrd 补丁 → 重打包 → Windows 侧注册这条链路完全脚本化且预构建包让用户零构建成本。总结与文档入口一句话WSABuilds 是微软停更 WSA 之后Windows 上获得带 Google Play Root 的 Android 环境目前最完整的一条路代价是接受第三方包的维护方式。推荐资源均为仓库内相对路径入门Documentation/WSABuilds/Installation.md、Updating.md、Uninstallation.md备份与数据迁移Documentation/WSABuilds/Backup and Restore.md版本兼容矩阵Documentation/WSABuilds/Information.md、旧版本归档 OldBuilds.md构建脚本主逻辑MagiskOnWSA/scripts/build.sh、WSA 链接生成 generateWSALinks.py更新/卸载辅助工具WSAUpdater.py、WSAUninstaller.py【免费下载链接】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），仅供参考 WSABuilds 完整指南：在 Windows 10/11 上装好带 Magisk 与 Google Play 的 WSA
WSABuilds 完整指南在 Windows 10/11 上装好带 Magisk 与 Google Play 的 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/WSABuildsWSABuilds 为 Windows 10/11 提供预装 MindTheGappsGoogle Play 商店与服务和 Magisk 或 KernelSU两种 Root 方案的 WSA 定制包。WSA 即 Windows Subsystem for Android微软在 Windows 上运行 Android 应用的兼容层。适合需要在 Windows 上跑依赖 Google 服务的 App、或给 Android 环境打 Root 模块的开发者。判断你的场景WSABuilds 适合谁先说结论它不是给所有人准备的适合需要 Google Play 商店/服务GMS的 Windows 用户——官方 WSA 已移除 GMS且微软已于 2025 年 3 月 5 日结束对 WSA 的官方支持见 README.md 中的 EoS 说明。需要 RootMagisk/KernelSU或想往 Android 环境里装模块LSPosed、Shizuku 类工具的人。愿意维护一个WSA 安装目录必须保留的固定部署见下文验证一节的原因。不适合只需要跑微软商店认证 App 的普通用户官方 WSA 更简单WSABuilds 属于第三方改造包不在微软支持范围内。需要官方持续更新的场景微软已停更 WSAWSABuilds 对 ≥ v2311.40000.5.0 的版本进入 LTS长期支持维护靠发布新版构建包跟进 Magisk/KernelSU/GApps 更新但 WSA 底座本身不再升级。⚠️ 注意README 顶部的警告区提到2025 年 6 月之后含 GApps 的构建在部分 Windows 11 上出现崩溃官方给出了临时缓解方案或改用文件名带NoGApps的构建。选型时先确认自己要装的是哪一类包。WSA 构建流程数据流全景不管你是下载预构建包还是自己构建产物都来自同一条流水线源码在 MagiskOnWSA/scripts/三个关键点下载不走商店。generateWSALinks.py直接对微软 FE3First Event Service微软交付更新的基础设施发 SOAP 请求模板是 MagiskOnWSA/xml/ 下的GetCookie.xml、WUIDRequest.xml、FE3FileUrl.xml拿到.msixbundle和 VCLibs、UI.Xaml 依赖包的真实下载链接。补丁打在 initrd 里不是 system 分区。细节下一节展开。最终产物是未签名的 Appx 目录靠随包携带的Install.ps1用Add-AppxPackage -Register就地注册这就是为什么安装目录删不得。WSA 预构建包三步安装步骤大多数用户走这条路去发布页拿.7z解压注册。依据是 Documentation/WSABuilds/Installation.md。第 1 步准备——确认硬件门槛Windows 11 Build 22000.526或 Windows 10 22H219045.2311内存 8 GB 起官方建议 16 GB系统盘C:\NTFS 分区且留 10 GB 以上启用「虚拟机平台」和「Windows 虚拟机监控程序平台」两个 Windows 功能WinR 输入OptionalFeatures.exe并在 BIOS/UEFI 里打开虚拟化。如果之前装过官方 WSA先彻底卸载再装这个两者不能共存。第 2 步执行——解压.7z后把解压出的文件夹重命名为WSA长文件夹名会导致 WSA 无法启动Documentation/WSABuilds/Information.md 列为已知问题双击其中的Run.bat。第 3 步验证——安装完成后按提示操作WSA 图标应出现在开始菜单并能启动首次启动会弹诊断数据同意框。若Run.bat窗口一闪而过没装上用管理员 PowerShell 手动注册cd X:\path\to\WSA PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1 原理提示Install.ps1本质是执行Add-AppxPackage -Register .\AppxManifest.xml把无包化文件注册成 Appx 包。注册只引用磁盘上的目录所以目录删了 WSA 就没了。诊断失败时可按 Installation.md 里的方法用Get-AppPackageLog -ActivityID uuid查具体报错。Linux 下自构建设置方法想自己产出构建包比如固定某个 Magisk 版本、或走 Release Preview 渠道在 Linux/WSL 环境里构建git clone https://gitcode.com/GitHub_Trending/ws/WSABuilds cd WSABuilds/MagiskOnWSA bash scripts/run.shrun.sh是 whiptail/dialog 驱动的交互菜单要求 bash不要用sh运行先跑install_deps.sh自动装aria2c、7z、unzip等依赖再让你依次选架构x64/arm64、发布渠道retail/RP/WIS/WIF、Root 方案magisk/kernelsu/none、Magisk 版本、是否装 GApps、是否移除 Amazon Appstore、压缩格式7z/zip。确认后会打印最终命令行并调起build.sh。跳过交互直接构建./scripts/build.sh --arch x64 --release-type retail \ --root-sol magisk --magisk-ver stable \ --install-gapps --remove-amazon产物落在MagiskOnWSA/output/已下载的组件缓存在MagiskOnWSA/download/重复构建不用重新下载 WSA 主体可用--skip-download-wsa显式跳过。initrd 补丁机制解析Magisk 如何注入 WSA这是整个项目最核心的动作不动 Android 的 system 分区而是把 Root 能力塞进启动早期的 initrd 镜像。build.sh中对应片段完整逻辑见 MagiskOnWSA/scripts/build.sh 第 495–562 行$WORK_DIR/magisk/magiskboot cpio $WORK_DIR/wsa/$ARCH/Tools/initrd.img \ mv /init /wsainit \ add 0750 /lspinit ../bin/$ARCH/lspinit \ ln /lspinit /init \ add 0750 /magiskinit $WORK_DIR/magisk/magiskinit \ mkdir 0750 overlay.d \ add 000 overlay.d/init.lsp.magisk.rc init.lsp.magisk.rc \ add 000 overlay.d/sbin/post-fs-data.sh post-fs-data.sh 原理提示magiskboot是 Magisk 自带的镜像工具。这里把原始/init改名保留换成一个lspinit存根作为新入口它负责把 Magisk 挂载进启动流程并新增overlay.d目录存放 rc 脚本、post-fs-data.sh和lsp_cust.img一个存放 Magisk 二进制的自定义镜像。GApps 走同一机制把 MindTheGapps 的gapps.img加进 initrd由gapps.rc在开机时挂载。两条容易忽略的约束组合限制写在build.sh里--install-gapps与--root-sol kernelsu同时出现会直接中止Unsupported combinationnone GApps 会强制改回 Magisk因为挂载 gapps.img 需要 Magisk。KernelSU 路线完全不同它不碰 initrd而是从 WSA 的Tools/kernel读出内核版本号getKernelVersion下载匹配内核版本的 KernelSU zip直接把bzImage/Image替换进Tools/kernel原文件备份为kernel_origin。GApps 的 API 版本随 WSA 主版本联动WSA 2211 用 API 32否则 API 33见build.sh第 354–422 行。WSA 常见报错与解决方法现象可能原因处理办法装完 GApps 构建后 WSA 或 Play 服务崩溃Win112025-06 后的已知问题README 顶部警告换用NoGApps命名的构建或按 README 给出的缓解方案操作WSA 完全无法启动解压目录名很长构建/下载产生的长文件夹名是已知问题解压后把目录改名为WSA再安装Information.md 已知问题区Run.bat弹出即消失未安装权限不足注册被静默拒绝管理员 PowerShell 执行PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1Installation.md 第 6 步注册报 0x80073D10 类错误 / WSA 不启动缺少「虚拟机平台」「Windows 虚拟机监控程序平台」或 BIOS 未开虚拟化OptionalFeatures.exe启用两项功能BIOS 开启 VT-x/AMD-VREADME 需求表图形异常或 WSA 不启动独显为 Intel HD 530 及更旧/部分 NvidiaGPU 与 WSA 渲染层不兼容按 ChangingGPU.md 切换到另一显卡或 Microsoft Basic Renderer更多条目可查 Documentation/Fix Guides/按安装前/安装后分类的错误码文档和 Documentation/WSABuilds/Having Issues.md。build.sh 构建参数速查表以下参数与默认值取自build.sh的usage()与default()可直接运行参数取值默认值说明--archx64,arm64x64WSA 目标架构--release-typeretail,RP,WIS,WIFretail发布渠道稳定 / 预览 / Insider 慢速 / Insider 快速--root-solmagisk,kernelsu,nonemagiskRoot 方案none表示无 Root--magisk-verstable,beta,canary,debug,releasestableMagisk 渠道release配合--magisk-custom装自定义 zip--install-gapps开关关集成 MindTheGapps与 kernelsu 互斥--remove-amazon开关关删除 Amazon Appstoremado*.apex--compress-format7z,zip,nonenone输出压缩格式--offline/--skip-download-wsa开关关离线构建 / 跳过 WSA 主体下载依赖已缓存WSABuilds 与官方 WSA、模拟器的对比方案Google 服务Root 能力获取方式维护模式典型代价官方 WSA无已移除 GMS无微软商店已 EoS2025-03 起功能缺失但最省事WSABuilds 预构建包MindTheGapps 可选内置Magisk / KernelSU 可选内置发布页.7z直接装LTS 版本持续跟进组件更新目录必须保留第三方包无微软支持MagiskOnWSA 自构建可选渠道/版本自选版本自选stable 到 debugLinux 下run.sh/build.sh同上但产物可完全定制需 Linux 环境与时间独立 Android 模拟器随镜像而定视镜像而定各发行版各自维护与 Windows 桌面集成度低文件/剪贴板互通弱WSABuilds 的差异化在于把下载官方 msixbundle → 打 initrd 补丁 → 重打包 → Windows 侧注册这条链路完全脚本化且预构建包让用户零构建成本。总结与文档入口一句话WSABuilds 是微软停更 WSA 之后Windows 上获得带 Google Play Root 的 Android 环境目前最完整的一条路代价是接受第三方包的维护方式。推荐资源均为仓库内相对路径入门Documentation/WSABuilds/Installation.md、Updating.md、Uninstallation.md备份与数据迁移Documentation/WSABuilds/Backup and Restore.md版本兼容矩阵Documentation/WSABuilds/Information.md、旧版本归档 OldBuilds.md构建脚本主逻辑MagiskOnWSA/scripts/build.sh、WSA 链接生成 generateWSALinks.py更新/卸载辅助工具WSAUpdater.py、WSAUninstaller.py【免费下载链接】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），仅供参考