WSABuilds README

The project's README from github.com/MustardChef/WSABuilds. As one markdown file: README.md.

[!IMPORTANT]

IF YOU HAVE BEEN RECENTLY HAVING ISSUES WITH SOME APPS BREAKING OR NOT STARTING OR APPS GETTING SUCK AT LOADING SCREEN OR APPS STUCK ON SPLASHSCREEN ( STUCK ON THE APP ICON SCREEN) OR ANY OTHER SIMILAR CASES AFTER THE 1ST OF SEPTEMBER 2026.

UPDATE TO THE LATEST LTS RELEASE!


CLICK HERE FOR MORE INFORMATION

If some apps that worked before, still refuse to work after updating, try clearing the app data and cache or reinstalling the apps. If the issue still occurs, you may need to perform a clean install to fix some apps. Create a backup before proceeding.

LET ME KNOW VIA GITHUB ISSUES AND/OR THE WSA COMMUNITY DISCORD IF THESE RELEASES HAVE SOLVED YOUR ISSUE. THANK YOU.

[!CAUTION]

Hello. Before you proceed to install WSA, it is important to note that WSA has been having some issues for the past year, where GApps builds have begun crashing on all Windows 11 builds after June 2025.

Fixes and upgrades are being worked on to resolve all bugs and crashes (in the form of https://github.com/MustardChef/WSABuilds/issues/700).


If you are affecting by this issue, try these current workarounds in the meantime:

  • RECOMMENDED FIX FOR BUILDS CONTAINING GAPPS (Google Play Store and Services): https://github.com/MustardChef/WSABuilds/issues/593#issuecomment-3172749449

  • OR
  • Switch/Use the builds which do not contain GApps. These are the builds that contain NoGApps in their .7z archive names.

  • Really old builds of WSA (2211/2210) are known to be working.


Visit https://github.com/MustardChef/WSABuilds/issues/593 for updates and discussions regarding the issue.

[!TIP]

To view the bugfixes and improvements that are currently being worked on, and the current state of the WSABuilds project, refer to the corresponding project page


ko-fi

WSABuilds

MagiskOnWSA (For Windows™ 10 and 11)

Windows Subsystem For Android™ (WSA) with Google Play Services and Magisk and KernelSU





downloads-folder

Downloads

Operating System Download Page

win11x64downpre

win11arm64downpre

win11x64downstable

win11arm64downstable

win10x64down

win10x64down

windownold

Custom Builds:

windownmagikdelta


system-information

Requirements

Windows Build Number

Windows™ 11: Build 22000.526 or higher. Windows™ 10: 22H2 10.0.19045.2311 or higher.

May work on Windows™ 10: 20H1 10.0.19041.264 or higher.1

1. You may need to install KB5014032 then install KB5022834 to use WSA on these older Windows 10 builds

Custom/modfied Windows OS installations (such as ReviOS, Tiny 10/11 and Ghost Spectre etc.) may have issues with running WSA.

RAM

  • 4 to 6 GB (Not Recommended)
  • 8 GB (Minimum)
  • 16 GB (Recommended)

Processor

CPU Architecture: x86_64 or arm64
Your PC should meet the basic Windows™ 11 requirements i.e Core i3 8th Gen, Ryzen 3000, Snapdragon 8c, or above N/A

This is a bit of a hit or miss, but it is highly recommended that your processor is listed in the supported CPU lists for Windows 11 requirements

GPU

Any compatible Intel, AMD or Nvidia GPU.
GPU Performance may vary depending on its compatibility with Windows Subsystem For Android™

Users with Intel HD Graphics 530 and older


WSA may not start or graphical glitches will occur when Intel HD Graphics 530 and Older iGPUs are used. This is a known issue, but unfortunately there are no fixes that I currently know of, plus, these GPUs are too old and do not meet Windows 11 requirements and hence are not official supported. Follow this guide to switch to another iGPU/dGPU/eGPU that you may have or Microsoft Basic Renderer

Users with Nvidia GPUs


Nvidia GPUs are known to cause problems. If Windows Subsystem For Android™ does not start or there are graphical glitches when an Nvidia GPU is used, follow this guide to switch to another iGPU/dGPU/eGPU that you may have or Microsoft Basic Renderer

Storage

Solid-state drive (RECOMMENDED)
OR
Hard Disk Drive (HDD) (NOT RECOMMENDED)
Minimum Storage Requirements: You must have at least 10GB free on the system drive (C:\)

Partition

NTFS ONLY

Windows Subsystem For Android™ can only be installed on a NTFS partition, not on an exFAT partition

Windows Features Needed

Virtual Machine Platform Enabled
Windows Hypervisor Platform Enabled
These optional settings are for virtualization and provide components that are needed to run WSA. You can enable these settings by pressing the Windows Key + R on your keyboard and typing "OptionalFeatures.exe" into the box, pressing enter and selecting the features above followed by pressing apply

Virtualization

The Computer must support virtualization and be enabled in BIOS/UEFI and Optional Features.

Guide on how to enable


[!TIP]

WSA End Of Support (EoS) Information (Click Here)

"Microsoft is ending support for the Windows Subsystem for Android™️ (WSA). As a result, the Amazon Appstore on Windows and all applications and games dependent on WSA will no longer be supported beginning March 5, 2025."

(Source: GitHub and Microsoft Learn)

WSABuilds has entered LTS (Long Term Support) for WSA versions ≥ 2311.40000.5.0, where the Magisk version, KernelSU version and GApps version will be kept up to date via new releases.

This repo will not be archived and support will still be given to any users installing WSA Builds from this repo. Thank you all for using this repository and supporting my work, its been a pleasure serving this community.

Do make sure that you keep a look out for any updates to this repo to be notified of any futher changes to WSA and WSABuilds


Next LTS and Non-LTS Release Date: (Click Here)

WSABuilds LTS 8 Hotfix (v2407.40000.4.0)

Friday 4th September 2026 Available Now (via the both Stable and Pre-release buttons in Downloads)

WSABuilds LTS 7 Hotfix (v2407.40000.4.0)

Sunday 4th January 2026 Available Now (via the both Stable and Pre-release buttons in Downloads)

Non-LTS Build Update (v2407.40000.4.0_v2):

Monday 2nd June 2025 Available Now (via the Stable release buttons in Downloads)

WSABuilds LTS 7 (v2407.40000.4.0)

Monday 2nd June 2025 Available Now (via the Pre-release buttons in Downloads)

Non-LTS Build Update (v2407.40000.4.0):

Monday 9th December 2024 Available Now (via the Stable release buttons in Downloads)

WSABuilds LTS 6 (v2407.40000.4.0)

Monday 9th December 2024 Available Now (via the Pre-release buttons in Downloads)

Non-LTS Build Update (v2407.40000.0.0):

Thursday 5th December 2024 Available Now (via the Stable release buttons in Downloads)

WSABuilds LTS 5 (v2407.40000.0.0)

Thursday 5th December 2024 Available Now (via the Pre-release buttons in Downloads)

WSABuilds LTS 4 (v2407.40000.0.0):

Monday 15th July 2024 Available Now (via the Pre-release buttons in Downloads)

WSABuilds LTS 3 (v2311.40000.5.0):

Monday 03rd June 2024 Available Now (via the Pre-release buttons in Downloads)

WSABuilds LTS 2 (v2311.40000.5.0):

Friday 03rd May 2024 Available Now (via the Pre-release buttons in Downloads)

WSABuilds LTS 1 (v2311.40000.5.0):

Wednesday 03rd April 2024 Available Now (via the Pre-release buttons in Downloads)



  Installation


  Updating


  Uninstallation


  Backup and Restore Userdata


  FAQ


  App Compatibility


  Usage Guides


 

  Having Issues?


  Credits

WSABuilds (MustardChef/WSABuilds)

Searching Database…

18.8K ·GitHub
这是做什么的?为 Windows 10 和 11 电脑提供 Windows Subsystem for Android 的现成下载包,内置 Google Play 商店(MindTheGapps)和/或 Magisk 或 KernelSU root——这样你不用自己编译 WSA 就能运行安卓应用。
怎么装到我的电脑上?在项目的 Downloads 页面上选一个构建——Stable 或 Pre-release——并选择 GApps 或 NoGApps,如果需要 root 再选 Magisk 或 KernelSU。下载 .7z 压缩包,解压后运行安装程序即可。
我的电脑带得动吗——有什么配置要求?需要 Windows 11(build 22000.526 及以上)或 Windows 10 22H2(10.0.19045.2311 及以上)——较旧的 Windows 10 20H1 及以上版本在装两个 KB 更新后也可能可用。内存至少 8 GB(建议 16 GB),CPU 需为 x86_64 或 arm64,NTFS 系统盘上要有大约 10 GB 可用空间,BIOS/UEFI 中需开启虚拟化,另外还要启用“虚拟机平台”和“Windows 虚拟机监控程序平台”这两个 Windows 功能。
目前最大的坑是什么?自 2025 年 6 月起,GApps 构建在所有 Windows 11 版本上都会崩溃——解决办法是更新到最新的 LTS 版本、改用 NoGApps 构建,或者退回旧的 2211/2210 构建。深度修改过的 Windows 系统比如 ReviOS、Tiny 10/11 或 Ghost Spectre 运行 WSA 也可能出问题。
显卡方面有什么坑吗?支持情况参差不齐:Intel HD Graphics 530 及更老的核显可能导致 WSA 无法启动或出现画面故障,目前没有已知修复方法;Nvidia 显卡也已知会引发问题。针对 Nvidia 有专门的指南,可以切换到其他 GPU 或使用 Microsoft Basic Renderer。
微软在 2025 年 3 月就停止支持 WSA 了,这个项目也死了吗?没有。WSABuilds 已进入针对 WSA 2311.40000.5.0 及更新版本的长期支持(Long Term Support),会通过新发布持续更新内置的 Magisk、KernelSU 和 GApps 版本,维护者也表示这个仓库不会被归档。
能在同一个构建里同时拥有 Play 商店和 root 吗?可以——构建有多种组合:通过 MindTheGapps 提供的 Google Play 加上 Magisk 或 KernelSU root、仅 GApps、仅 root,或者两者都没有。下载时选好组合即可。
2026 年 9 月之后应用开始出错或卡在加载画面,怎么解决?更新到最新的 LTS 版本。如果应用还是无法使用,清除它们的数据和缓存或者重装;实在不行就做一次全新安装——记得先备份。
在 ARM 架构的 Windows 电脑上能用吗?可以——支持的 CPU 列为 x86_64 或 arm64,而且这个仓库的 CI 包含专门的 ARM64 构建流程,所以 ARM64 的 Windows 设备也有对应的构建。
Size
195.5 MB
Stars
18.8K
Age
3y
Commits · 90 Days