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 **Magisk** 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
    - 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. 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.
1. Enjoy by installing LSPosed-zygisk with zygisk enabled or Riru and LSPosed-riru

## Video Demo

[demo](https://user-images.githubusercontent.com/5022927/139580565-35971031-7258-40bf-93e2-49a0750156f3.mp4)

## 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)`
			`1. In the left sidebar, click the Magisk 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)`
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`
			- 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.)
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.`
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. Enjoy by installing LSPosed-zygisk with zygisk enabled or Riru and LSPosed-riru`
Add prebuilt magisk 2021-10-26 11:30:03 +02:00
Add Video Close #37 2021-10-31 12:24:33 +01:00			`## Video Demo`

			`[demo](https://user-images.githubusercontent.com/5022927/139580565-35971031-7258-40bf-93e2-49a0750156f3.mp4)`

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`