2407.40000.0.0

Changelog

Update WSA Version From 2311.40000.5.0 to 2407.40000.0.0

Installation

Note :
If you have the official Windows Subsystem For Android™ installed, you must completely uninstall it to use MagiskOnWSA.

In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup %LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx before uninstallation and restore it after installation. For a more comprehensive and detailed guide, take a look at the Backup and Restore section

1. Go to the Releases page
2. In the latest release, go to the Assets section and download the Windows Subsystem For Android™ version of your choosing (do not download "Source code")

Note :
If you want to build your custom build, please open an Issue，and then download the Artifact from Github Actions. Please visit Custom Build for more information.

3. Check integrity of downloaded file

   • Press Win + X on your keyboard and select Windows™ Terminal (Admin) or Powershell (Admin) depending on the version of Windows™ you are running
   • Input the command below and press enter, replacing {X:\path\to\your\downloaded\archive\package} including the {} with the path of the downloaded archive package

   cd "{X:\path\to\your\downloaded\archive\package}"

   • Input the command below and press enter, replacing WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X with the name of the archive package

   certutil -hashfile "WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X" SHA256

   • Compare the SHA256 output with ones at Releases page or in the sha256-checksum.txt (if you download artifact from the Custom Build task).

   Note :
   If package don't have the same SHA-256 Hash, please download then check again. DO NOT INSTALL!!!

4. Extract the zip file

5. Delete the zip file

6. Move the newly extracted folder to a suitable location and rename it (Recommended), as you will need to keep the folder on your PC to use WSAOnWin10

Note :
If you're updating WSA, merge the folders and replace the files for all items when asked. Please visit Updating instructions for more information.

7. Open the Windows Subsystem For Android™ folder: Search for and double-click Run.bat

   • If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data.

   • If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:

     • Press Win+X and select Windows™ Terminal (Admin)

     • Input the command below and press enter, replacing {X:\path\to\your\extracted\folder} including the {} with the path of the extracted folder

       cd "{X:\path\to\your\extracted\folder}"

     • Input the command below and press enter

       PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1

     • The script will run and Windows Subsystem For Android™ will be installed

     • If this workaround does not work, your PC is not supported for WSA

8. Once the installation process completes, Windows Subsystem For Android™ will launch (if this is a first-time install, a window asking for consent to diagnositic information will be shown instead. Sometimes two identical windows will show, this is fine and nothing bad happens if you click OK in both windows)

9. Click on the PowerShell window, then press any key on the keyboard, the PowerShell window should close

10. Close File Explorer

11. Enjoy

Notice (Applicable for both Windows 10 and 11):

1. You can NOT delete the Windows Subsystem For Android™ 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 Windows Subsystem For Android™.
   Check https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage?view=windowsserver2022-ps for more details.

2. You need to register your Windows Subsystem For Android™ appx package before you can run Windows Subsystem For Android™.
   For WSAOnWin10 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):

   1. Open a PowerShell window and change working directory to your Windows Subsystem For Android™ directory.

   2. Run the command below in PowerShell. This should fail with an ActivityID, which is a UUID required for the next step.

      Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml

   3. Run the command below in PowerShell. This should print the log of the failed operation.

      Get-AppPackageLog -ActivityID <UUID>

   4. Check the log for the reason of failure and fix it.

Updating

How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)

1. Download the build that you want to update to
2. Make sure Windows Subsystem For Android is not running (Click on "Turn off" in the WSA Settings and wait for the spinning loader to disappear)
3. Using 7-Zip, WinRAR or any other tool of choice, open the .zip file
4. Within the .zip archive open the subfolder (Example: WSA_2XXX.XXXXX.X.X_XXXX_Release-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X)
5. Select all the files that are within this subfolder and extract them to the current folder where the file for Windows Subsystem For Android are (the folder you extracted, and installed WSA from)
6. When prompted to replace folders, select "Do this for all current items" and click on "Yes"
7. When prompted to replace files, click on "Replace the files in the destination"
8. Run the Run.bat file
9. Launch Windows Subsystem For Android Settings app and go to the About tab using the sidebar
10. Check if the WSA version matches the latest version/ the version number that you want to update to

Information

	Filename	Root	GApps
	WSA_2407.40000.0.0_arm64_Release-MindTheGapps-13.0.zip	✖	MindTheGapps
SHA256:	281f62f4e79d701159bad825e47ee9986d62c6460a25ebb6442c70b50d7cf261
	WSA_2407.40000.0.0_arm64_Release-with-kernelsu-v1.0.1-MindTheGapps-13.0.zip	KernelSU	MindTheGapps
SHA256:	e5d5b429f4e6a3aa9ed4be95fa636967384d6bfa5dacdd0eff34efd40ed9417d
	WSA_2407.40000.0.0_arm64_Release-with-kernelsu-v1.0.1.zip	KernelSU	✖
SHA256:	17dae72143383a33e3a819e726218f048f090285fac1ace9896bad867de6e4cd
	WSA_2407.40000.0.0_arm64_Release-with-magisk-27.0-MindTheGapps-13.0.zip	Magisk	MindTheGapps
SHA256:	16b6ada9bd37074cb8c08365e87f723f155a009878e49280d3259330deedb0da
	WSA_2407.40000.0.0_arm64_Release-with-magisk-27.0.zip	Magisk	✖
SHA256:	0a6c12faa57097b8a84e834a7b867e2d7a0acb9f00348060012d730c15e34f39
	WSA_2407.40000.0.0_arm64_Release.zip	✖	✖
SHA256:	52cc8e518e671dcdead6b15a6816a5b64e9775c4129c53881e62a6a566ad7b57
	WSA_2407.40000.0.0_x64_Release-MindTheGapps-13.0.zip	✖	MindTheGapps
SHA256:	95c7dad7308b53143c076e383d38a88b49926cad53ed2c43b1e1440b29c90504
	WSA_2407.40000.0.0_x64_Release-with-kernelsu-v1.0.1-MindTheGapps-13.0.zip	KernelSU	MindTheGapps
SHA256:	74297863966dc15cafb4fdc3b9e2fb1fc34b94168da6c77f03feff628a987609
	WSA_2407.40000.0.0_x64_Release-with-kernelsu-v1.0.1.zip	KernelSU	✖
SHA256:	1bd8c5784362e8988015065ab165e2f6d96dacffa7ccb366d1f9f49efc71a508
	WSA_2407.40000.0.0_x64_Release-with-magisk-27.0-MindTheGapps-13.0.zip	Magisk	MindTheGapps
SHA256:	8fc6847a067062df124eb4f6fc8ebd3320dbcb3d0cc86eb5d3fac0db560b5d72
	WSA_2407.40000.0.0_x64_Release-with-magisk-27.0.zip	Magisk	✖
SHA256:	20bf2e661da90d4a794b1e43650b59ce7799c7e437b0fa2208b4f393609ade62
	WSA_2407.40000.0.0_x64_Release.zip	✖	✖
SHA256:	6d3cf796e97b226ed713fefd3f6a2b40555c281d84cc37e2a7cf2da22a5e1471