WSABuilds/README.md

# Magisk on WSA

## Features
- Integrate Magisk and OpenGApps in a few clicks within minutes
- No Linux environment required for integration
- Keep each build up to date
- Support both ARM64 and x64
- Support all OpenGApps variants
- Fix external storage access of DocumentUI
- Unatended installation
- Automatically activates developers mode in Windows 11
- Update to new version while preserving data with one-click script
- Merged all language packs

## Usage

1. Star (if you like) and fork this repo
1. Go to the **Action** tab in your forked repo
    ![Action Tab](https://docs.github.com/assets/images/help/repository/actions-tab.png)
1. In the left sidebar, click the **Build WSA** workflow.
    ![Workflow](https://docs.github.com/assets/images/actions-select-workflow.png)
1. Above the list of workflow runs, select **Run workflow**
    ![Run Workflow](https://docs.github.com/assets/images/actions-workflow-dispatch.png)
1. Input the download link of Magisk and select the [OpenGApps variant](https://github.com/opengapps/opengapps/wiki#variants) (none is no OpenGApps) you like, select the root solution (none means no root) and click **Run workflow**
    ![Run Workflow](https://docs.github.com/assets/images/actions-manually-run-workflow.png)
1. Wait for the action to complete and download the artifact
    ![Download](https://docs.github.com/assets/images/help/repository/artifact-drop-down-updated.png)
1. Unzip the artifact
    - The size shown in the webpage is uncompressed size and the zip you download will be compressed. So the size of the zip will be much less than the size shown in the webpage.
1. Right-click `Install.ps1` and select `Run with PowerShell`
    - If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous while **preserving all userdata** and install the new one, so don't worry about your data.
    - If you have an official WSA installation, you should uninstall it first. (In case you want to preserve your data, you can backup `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx` before uninstallation and restore it after installation.)
1. Magisk/Play store will be launched. Enjoy by installing LSPosed-zygisk with zygisk enabled or Riru and LSPosed-riru

## Credits
- [Magisk](https://github.com/topjohnwu/Magisk): The most famous root solution on Android
- [The Open GApps Project](https://opengapps.org): One of the most famous Google Apps packages solution
- [WSA-Kernel-SU](https://github.com/LSPosed/WSA-Kernel-SU) and [kernel-assisted-superuser](https://git.zx2c4.com/kernel-assisted-superuser/): The kernel `su` for debugging Magisk Integration
- [WSAGAScript](https://github.com/ADeltaX/WSAGAScript): The first GApps integration script for WSA
Fix typo 2021-10-26 12:19:47 +02:00			`# Magisk on WSA`

Update README.md 2021-10-27 15:06:38 +02:00			`## Features`
fix typo (#14) 2021-10-27 16:07:29 +02:00			`- Integrate Magisk and OpenGApps in a few clicks within minutes`
			`- No Linux environment required for integration`
			`- Keep each build up to date`
Update README.md 2021-10-27 15:06:38 +02:00			`- Support both ARM64 and x64`
Update README.md 2021-10-30 14:48:34 +02:00			`- Support all OpenGApps variants`
			`- Fix external storage access of DocumentUI`
Adds latest adb files. Installer now opens WSASettings and Installs Magisk.apk with minimal input from user. (#89) * Supplies the same Magisk APK version with WSA Provides the required Magisk APK along with the rest of the files. * Copy to magisk.apk iff root sol is magisk * Update README.md * Adds latest adb and installs Magisk.apk at the end. * typo error * typo error * fix folder error in adb call from install script * Optimized ADB unzip * Cleanup temp files during adb extraction * Automated adb connection and Magisk Install * Changed Magisk launch command * fix missing ./ in adb call * Cleanup adb.zip * AUtomated install script. No user interaction install. * Fixed ./adb missing ./ * Edited Readme to remove unnecesary user steps. * Prepare script for AppxPackage randomly not starting wsaclient. * Install script now activates Windows 11 developers mode automatically. * stupid space in the middle of a command fixed Co-authored-by: LoveSy <shana@zju.edu.cn> 2021-11-19 13:58:08 +01:00			`- Unatended installation`
			`- Automatically activates developers mode in Windows 11`
Update script and readme 2021-12-11 18:56:48 +01:00			`- Update to new version while preserving data with one-click script`
Merge all language packs Close #61 2021-12-11 21:27:26 +01:00			`- Merged all language packs`
Update README.md 2021-10-27 15:06:38 +02:00
Fix typo 2021-10-26 12:19:47 +02:00			`## Usage`
Initial commit 2021-10-26 11:16:38 +02:00
Update README.md Fix #16 2021-10-30 09:26:06 +02:00			`1. Star (if you like) and fork this repo`
			`1. Go to the Action tab in your forked repo`
			`![Action Tab](https://docs.github.com/assets/images/help/repository/actions-tab.png)`
Fix GSI packages arch 2021-12-11 22:50:28 +01:00			`1. In the left sidebar, click the Build WSA workflow.`
Update README.md Fix #16 2021-10-30 09:26:06 +02:00			`![Workflow](https://docs.github.com/assets/images/actions-select-workflow.png)`
			`1. Above the list of workflow runs, select Run workflow`
			`![Run Workflow](https://docs.github.com/assets/images/actions-workflow-dispatch.png)`
Supplies the same Magisk APK version with WSA (#88) Co-authored-by: LoveSy <shana@zju.edu.cn> 2021-11-15 10:40:13 +01:00			`1. Input the download link of Magisk and select the [OpenGApps variant](https://github.com/opengapps/opengapps/wiki#variants) (none is no OpenGApps) you like, select the root solution (none means no root) and click Run workflow`
Update README.md Fix #16 2021-10-30 09:26:06 +02:00			`![Run Workflow](https://docs.github.com/assets/images/actions-manually-run-workflow.png)`
Minor Changes (#50) 2021-11-02 02:26:01 +01:00			`1. Wait for the action to complete and download the artifact`
Update README.md Fix #16 2021-10-30 09:26:06 +02:00			`![Download](https://docs.github.com/assets/images/help/repository/artifact-drop-down-updated.png)`
Update script and readme 2021-12-11 18:56:48 +01:00			`1. Unzip the artifact`
Fix GSI packages arch 2021-12-11 22:50:28 +01:00			`- The size shown in the webpage is uncompressed size and the zip you download will be compressed. So the size of the zip will be much less than the size shown in the webpage.`
Minor Changes (#50) 2021-11-02 02:26:01 +01:00			1. Right-click `Install.ps1` and select `Run with PowerShell`
Update script and readme 2021-12-11 18:56:48 +01:00			`- If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous while preserving all userdata and install the new one, so don't worry about your data.`
Fix GSI packages arch 2021-12-11 22:50:28 +01:00			- If you have an official WSA installation, you should uninstall it first. (In case you want to preserve your data, you can backup `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx` before uninstallation and restore it after installation.)
			`1. Magisk/Play store will be launched. Enjoy by installing LSPosed-zygisk with zygisk enabled or Riru and LSPosed-riru`
Add Video Close #37 2021-10-31 12:24:33 +01:00
Credits 2021-10-27 15:11:39 +02:00			`## Credits`
			`- [Magisk](https://github.com/topjohnwu/Magisk): The most famous root solution on Android`
			`- [The Open GApps Project](https://opengapps.org): One of the most famous Google Apps packages solution`
			- [WSA-Kernel-SU](https://github.com/LSPosed/WSA-Kernel-SU) and [kernel-assisted-superuser](https://git.zx2c4.com/kernel-assisted-superuser/): The kernel `su` for debugging Magisk Integration
			`- [WSAGAScript](https://github.com/ADeltaX/WSAGAScript): The first GApps integration script for WSA`