MagiskOnWSALocal

Magisk on WSA (with Google Apps)

⚠️ For fork developers: Please don’t build using GitHub Actions, as GitHub will count your forked GitHub Actions usage against this upstream repository, which may cause this upstream repository gets disabled by GitHub staff like MagiskOnWSA because of numerous forks building GitHub Actions, and counting the forks’ Action usage against this upstream repository.

Support for generating from these systems

• Linux (x86_64 or arm64)

  The python3 library requests is used.

  Python version ≥ 3.7.2.

  • • Ubuntu (You can use WSL2)

      Ready to use right out of the box.

    • Debian (You can use WSL2)

      Ready to use right out of the box.

    • openSUSE Tumbleweed (You can use WSL2)

      Ready to use right out of the box.

    run.sh will handle all dependencies automatically.

    No need to type any commands.

Features

• Integrate Magisk and GApps in a few clicks within minutes
• Keep each build up to date
• Support both ARM64 and x64
• Support MindTheGapps
• Remove Amazon Appstore
• Fix VPN dialog not showing (use our VpnDialogs app)
• Add device administration feature
• Unattended installation
• Automatically activates developers mode in Windows 11
• Update to the new version while preserving data with a one-click script
• Merged all language packs

Text Guide

FAQ

Credits

• StoreLib: API for downloading WSA
• Magisk: The most famous root solution on Android
• The Open GApps Project: One of the most famous Google Apps packages solution
• WSA-Kernel-SU and kernel-assisted-superuser: The kernel su for debugging Magisk Integration
• WSAGAScript: The first GApps integration script for WSA
• erofs-utils: Pre-build erofs-utils with erofsfuse enabled

The repository is provided as a utility.

Android is a trademark of Google LLC. Windows is a trademark of Microsoft Corporation.

Magisk on WSA (with Google Apps)

Pre-request

• Ubuntu (you can use WSL2)

Features

• Integrate Magisk and OpenGApps in a few clicks within minutes
• Keep each build up to date
• Support both ARM64 and x64
• Support all OpenGApps variants except for aroma (aroma does not support x86_64, please use super instead)
• Remove Amazon AppStore
• Fix VPN dialog not showing (use our VpnDialogs app)
• Add device management feature
• Unattended installation
• Automatically activates developers mode in Windows 11
• Update to the new version while preserving data with a one-click script
• Merged all language packs
• Support managing start menu icons (manually installing WSAHelper to use this feature)

Text Guide

FAQ

• Can I delete the installed folder?

• How can I update WSA to a new version?

  Delete the download folder
  Rerun the script, replace the content of your previous installation and rerun Install.ps1. Don’t worry, your data will be preserved.

• How can I get the logcat from WSA?

• How can I update Magisk to a new version?

  Do the same as updating WSA

• How to pass safetynet?

  Like all the other emulators, no way.

• Virtualization is not enabled?

  Install.ps1 helps you enable it if not enabled. After rebooting, rerun Install.ps1 to install WSA. If it’s still not working, you have to enable virtualization in BIOS. That’s a long story so ask Google for help.

• How to remount the system as read-write?

  No way in WSA since it’s mounted as read-only by Hyper-V. You can modify the system by making a Magisk module. Or directly modify the system.img. Ask Google for help.

• I cannot adb connect localhost:58526

  Make sure developer mode is enabled. If the issue persists, check the IP address of WSA on the setting page and try adb connect ip:5555.

• Magisk online module list is empty?

  Magisk actively removes the online module repository. You can install the module locally or by adb push module.zip /data/local/tmp and adb shell su -c magisk --install-module /data/local/tmp/module.zip.

• Can I use Magisk 23.0 stable or a lower version?

  No. Magisk has bugs preventing itself from running on WSA. Magisk 24+ has fixed them. So you must use Magisk 24 or higher version.

• How can I get rid of Magisk?

  Choose none as the root solution.

Credits

• StoreLib: API for downloading WSA
• Magisk: The most famous root solution on Android
• The Open GApps Project: One of the most famous Google Apps packages solution
• WSA-Kernel-SU and kernel-assisted-superuser: The kernel su for debugging Magisk Integration
• WSAGAScript: The first GApps integration script for WSA

WSA(Windows Subsystem for Android™️) GApps + Root Guide

Minimum Requirements

• Windows 11 64bit (x86_64)
• Control Panel -> From Programs and Features, Check all three Windows Hypervisor Platform, Virtual Machine Platform, Windows Subsystem for Linux is all enabled
• Virtualization enabled in BIOS
• WSL2, Linux Distribution for WSL, Ubuntu 18.04 is Recommended.
• Please search Google for WSL Installations.

Pre-notice

• GApps installation script part is referenced from WSAGAScript by ADeltaX.
• For modified kernel, I used and built LSPosed/WSA-Kernel-SU which license is GPLv2.
• While working on Sideload, It regenerates %AppData%\SideloadedWSA folder. It deletes files which exists in the directory, so if there is a file in the directory, please backup or move it to another place.
• After working on Sideload, If you delete %AppData%\SideloadedWSA folder Windows Subsystem for Android™️ will not work as intended.
• When running the ps1 file, Right click and Run in PowerShell is default.

0. Getting Ready for installation

1. Clone this Repository(Run "git clone https://github.com/aroxu/wsa-root-gapps-guide.git"), or Download it.
   

   If you downloaded this repository please change it’s name to wsa-root-gapps-guide.zip and extract it.

1. Getting Ready for WSA File

1. Enter https://store.rg-adguard.net, and paste https://www.microsoft.com/store/productId/9P3395VX91NR into link input line.
2. On Link input, enter https://www.microsoft.com/store/productId/9P3395VX91NR, select SLOW option, and press ✔.
3. Download the file which starts with MicrosoftCorporationII.WindowsSubsystemForAndroid and ends with .msixbundle.
4. Change the downloaded file name into wsa.msixbundle.

2. Modified WSA Sideload

1. Settings → Updates & Security → Enable Developer Mode.
2. Open wsa.msixbundle with your archive manager, or change the extension to .zip.
3. Copy or decompress the msix file which name is WsaPackage_<version>_Release-Nightly among the files inside the wsa.msixbundle file to the current folder.
4. Changed the copied msix file name to modified.zip and decompress it.
5. Remove files and folder which is AppxMetadata folder, AppxSignature.p7x, appxblockmap.xml, [content_types] in extracted contents.
6. Copy and execute 1. sideload.ps1 file in the modified folder which comes from clone source

3. Install GApps

From here you need WSL2. Any distribution is fine, But I recommend Ubuntu 18.04.
Items with WSL2 works comes with 🐧 emoji.

1. Enter OpenGApps and press x86_64, 11.0, pico in order, and click ⬇️ (Download) button to download GApps.
2. On Modified WSA Folder, Create folders named #IMAGES, #GAPPS. (Do not remove #.) At this point, you should create it not in modified, but in root of the modified directory.
3. Copy GApps into#GAPPS folder which you have donwloaded. At this point you should not extract it.
4. Press Win + R and enter explorer %AppData%\SideloadedWSA, from there copy product.img, system.img, system_ext.img, vendor.img files into #IMAGES folder which is in your Modified WSA Directory.
5. Open 2._install_gapps.sh as Notepad++ or VSCode, etc. and edit like this:
   

   Root=
    Change the upper one into Modified WSA direcotry which you are working on.
   
   Root=

6. 🐧 Open WSA2 Distribution which is installed, and use sudo -i to enter root.
7. 🐧 Enter following command:
   

   apt update -y  apt upgrade -y  apt-get update -y  apt-get upgrade -y  apt-get install -y unzip lzip wget

8. 🐧 Move to the Modified WSA directory which you are working on. For Example: If the working Modified WSA directory is C:\Users\user\Desktop\wsa-root-gapps-guide:
   

    /mnt/c/Users/user/Desktop/wsa-root-gapps-guide

9. 🐧 Enter following command:
   

   chmod a+x 2._install_gapps.sh  ./2._install_gapps.sh

10. Copy all contents in #IMAGES which is in Modified WSA Folder. Press Win + R, enter explorer %AppData%\SideloadedWSA, and paste into it.
11. Prepare adb. (You can download it from here: https://dl.google.com/android/repository/platform-tools_r31.0.3-windows.zip)
12. Start Windows Subsystem for Android™️, enable Developer Option, and execute Files right at the top.
13. Extract platform-tools, and open Windows Terminal at current direcotyr and type adb connect <WSA_IP_ADDRESS>, adb shell in order and enter the following command:
    

14. On Start Menu click Play store, and Log In. There may be error happening, at then relaunch the program and relogin.

4. Root

1. Run adb and enter the following command:
   

   su
    Enter the command which you want to run as root.

Frequently happening Errors

• Powershell script does not run / cannot be run. What should I do?
  

   Unrestricted
   For your security, do all the tasks you have to do and change it back when it's done.
   RemoteSigned