Instructions for me

wsa-windows10pro.md

THIS RELEASE FIXES THE ARM TRANSLATION LAYER ISSUE. UPDATE TO THESE BUILDS IF YOU FACE THE FOLLOWING:

APPS NOT OPENING OR CRASHING OR GETTING STUCK ON THE SPLASHSCREEN OR ANY OTHER SIMILAR ISSUES OCCURRING ON AND AFTER THE 2ND OF JUNE 2025

Builds Last Updated:

- 02/06/2025 19:10:56 GMT (Reason: Initial Release)

---

READ BEFORE DOWNLOADING!!!!

DIFFERENCE BETWEEN LTS RELEASES AND LAST NON-LTS RELEASES

Switches to upstream MagiskOnWSALocal Repo:

• Magisk module and GApps Issues fixed

• Pixel Devices Props no longer applied (except KernelSU Builds) (May cause unexpected behavour)

• All Builds with Google Apps/GApps will now include Magisk by default in order for them to function

• KernelSU Builds will be built using the old non-upstream script, to avoid the Magisk+Gapps limitation

LTS Builds aim to keep Magisk, KernelSU and Gapps up to date via regular releases.

---

• For anyone updating from a previous WSA Build:

  • Please backup your Userdata VHDX using this guide, in the case that the builds in this release do not work as intended (crashes, bugs or not working), so that you can revert to the old version if needs be.

• Ensure that 7-zip/WinRAR is up-to-date, before extracting, to avoid extraction errors.

Read the guide in full before installing. Ensure you meet the full requirements for an installation on Windows 11.

If you're updating WSA, merge the folders and replace the files for all items when asked

If you have the official WSA installed or WSA installed that has not been downloaded from this repo, you must completely uninstall it to use these builds

---

Follow these steps to install on Windows 10.

1. Extract the .7z archive using 7-zip (recommended) and rename the extracted folder to WSA
2. Delete the .7z archive (It is recommended to keep the .7z archive until WSA has been installed and is working properly)
3. Move the newly extracted folder to a suitable location (Documents folder is a good choice), as you will need to keep the folder on your PC to use MagiskOnWSA
4. Open the WSA folder and double-click on Run.bat

!Notice:

1. As stated in theRequirements, You can only install WSA on a NTFS partition, not on an exFAT partition.
2. You can NOT delete the WSA installation folder.
   What Add-AppxPackage -Register .\AppxManifest.xml does is to register an appx package with some existing unpackaged files,
   so you need to keep them as long as you want to use WSA.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.
3. You need to register your WSA appx package before you can run WSA.
   For WSABuilds and MagiskOnWSALocal users, you need to run Run.bat in the extracted dir.
   If the script fails, you can take the following steps for diagnosis (admin privilege required):
4. Open a PowerShell window and change working directory to your WSA directory.
5. Run Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml in PowerShell.
   This should fail with an ActivityID, which is a UUID required for the next step.
6. Run Get-AppPackageLog -ActivityID <UUID> in PowerShell.
   This should print the log of the failed operation.
7. Check the log for the reason of failure and fix it.
8. If unable to fix, seek assistance via Issues or the WSA Community Discord