Mirrors/WSABuilds
2
0
Fork 0
mirror of https://github.com/MustardChef/WSABuilds.git synced 2024-12-27 03:41:48 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
MustardChef 2024-12-09 23:10:18 +00:00 committed by GitHub
parent 6ec991e72b
commit 2ecafb6e3f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 72 additions and 68 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

140
README.md
View File

@ -1,47 +1,51 @@
> [!IMPORTANT] > [!IMPORTANT]
> ### IF YOU HAVE BEEN RECENTLY HAVING ISSUES WITH SOME APPS BREAKING OR NOT STARTING OR APPS GETTING SUCK AT LOADING SCREEN OR APPS STUCK ON SPLASHSCREEN ( STUCK ON THE APP ICON SCREEN) OR ANY OTHER SIMILAR CASES. > ### IF YOU HAVE BEEN RECENTLY HAVING ISSUES WITH SOME APPS BREAKING OR NOT STARTING OR APPS GETTING SUCK AT LOADING SCREEN OR APPS STUCK ON SPLASHSCREEN ( STUCK ON THE APP ICON SCREEN) OR ANY OTHER SIMILAR CASES.
> ### UPDATE TO THE LATEST LTS AND NON-LTS RELEASES: > ### UPDATE TO THE LATEST LTS AND NON-LTS RELEASES:
> >
> - ### LTS Releases: > - ### LTS Releases:
> - ``Magisk is bundled by default on builds with Google Apps (GApps)):`` > - ``Magisk is bundled by default on builds with Google Apps (GApps)):``
> - [Windows 11 x64](https://github.com/MustardChef/WSABuilds/releases/tag/Windows_11_2407.40000.0.0_LTS_5) > - [Windows 11 x64](https://github.com/MustardChef/WSABuilds/releases/tag/Windows_11_2407.40000.4.0_LTS_6)
> - [Windows 10 x64](https://github.com/MustardChef/WSABuilds/releases/tag/Windows_10_2407.40000.0.0_LTS_5) > - [Windows 10 x64](https://github.com/MustardChef/WSABuilds/releases/tag/Windows_10_2407.40000.4.0_LTS_6)
> >
> - ### Non-LTS Releases: > - ### Non-LTS Releases:
> - ``(If you don't want Magisk being bundled by default) (Release contains no Magisk builds)`` > - ``(If you don't want Magisk being bundled by default) (Release contains no Magisk builds)``
> - [Windows 11 x64](https://github.com/MustardChef/WSABuilds/releases/tag/Windows_11_2407.40000.0.0) > - [Windows 11 x64](https://github.com/MustardChef/WSABuilds/releases/tag/Windows_11_2407.40000.4.0)
> - [Windows 10 x64](https://github.com/MustardChef/WSABuilds/releases/tag/Windows_10_2407.40000.0.0) > - [Windows 10 x64](https://github.com/MustardChef/WSABuilds/releases/tag/Windows_10_2407.40000.4.0)
> >
> #### LET ME KNOW VIA GITHUB ISSUES, THE WSA COMMUNITY DISCORD OR THE r/WSA SUBREDDIT IF THESE RELEASES HAVE SOLVED YOUR ISSUE. THANK YOU. > #### LET ME KNOW VIA GITHUB ISSUES, THE WSA COMMUNITY DISCORD OR THE r/WSA SUBREDDIT IF THESE RELEASES HAVE SOLVED YOUR ISSUE. THANK YOU.
> [!TIP] > [!TIP]
&gt; <details> > <details>
&gt; <summary><h2>WSA End Of Support Information</h2></summary> > <summary><h2>WSA End Of Support Information</h2></summary>
&gt; >
&gt; ## "Microsoft is ending support for the Windows Subsystem for Android™️ (WSA). As a result, the Amazon Appstore on Windows and all applications and games dependent on WSA will no longer be supported beginning March 5, 2025." > ## "Microsoft is ending support for the Windows Subsystem for Android™️ (WSA). As a result, the Amazon Appstore on Windows and all applications and games dependent on WSA will no longer be supported beginning March 5, 2025."
&gt; ###### (Source: [GitHub](https://github.com/microsoft/WSA/discussions/536) and [Microsoft Learn](https://learn.microsoft.com/en-us/windows/android/wsa/)) > ###### (Source: [GitHub](https://github.com/microsoft/WSA/discussions/536) and [Microsoft Learn](https://learn.microsoft.com/en-us/windows/android/wsa/))
&gt; --- > ---
&gt; ### WSABuilds has entered LTS (Long Term Support) for WSA version 2311.40000.5.0, where the Magisk version, KernelSU version and GApps version will be kept up to date via new releases. > ### WSABuilds has entered LTS (Long Term Support) for WSA version 2311.40000.5.0, where the Magisk version, KernelSU version and GApps version will be kept up to date via new releases.
&gt; ### This repo will not be archived and support will still be given to any users installing WSA Builds from this repo. Thank you all for using this repository and supporting my work, its been a pleasure serving this community. > ### This repo will not be archived and support will still be given to any users installing WSA Builds from this repo. Thank you all for using this repository and supporting my work, its been a pleasure serving this community.
&gt; >
&gt; --- > ---
&gt; </details> > </details>
&gt; >
&gt; >
&gt; ## Next LTS and Non-LTS Release Date: > ## Next LTS and Non-LTS Release Date:
&gt; ### Non-LTS Build Update (v2407.40000.0.0): > ### Non-LTS Build Update (v2407.40000.4.0):
&gt; ~~``Thursday 5th December 2024``~~ **Available Now (via the Stable release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))** > ~~``Monday 9th December 2024``~~ **Available Now (via the Stable release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))**
&gt; ### WSABuilds LTS 5 (v2407.40000.0.0) > ### WSABuilds LTS 6 (v2407.40000.4.0)
&gt; ~~``Thursday 5th December 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))** > ~~``Monday 9th December 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))**
&gt; ### WSABuilds LTS 4 (v2407.40000.0.0): > ### Non-LTS Build Update (v2407.40000.0.0):
&gt; ~~``Monday 15th July 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))** > ~~``Thursday 5th December 2024``~~ **Available Now (via the Stable release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))**
&gt; ### WSABuilds LTS 3 (v2311.40000.5.0): > ### WSABuilds LTS 5 (v2407.40000.0.0)
&gt; ~~``Monday 03rd June 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))** > ~~``Thursday 5th December 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))**
&gt; ### WSABuilds LTS 2 (v2311.40000.5.0): > ### WSABuilds LTS 4 (v2407.40000.0.0):
&gt; ~~``Friday 03rd May 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))** > ~~``Monday 15th July 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))**
&gt; ### WSABuilds LTS 1 (v2311.40000.5.0): > ### WSABuilds LTS 3 (v2311.40000.5.0):
&gt; ~~``Wednesday 03rd April 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))** > ~~``Monday 03rd June 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))**
> ### WSABuilds LTS 2 (v2311.40000.5.0):
> ~~``Friday 03rd May 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))**
> ### WSABuilds LTS 1 (v2311.40000.5.0):
> ~~``Wednesday 03rd April 2024``~~ **Available Now (via the Pre-release buttons in [Downloads](https://github.com/MustardChef/WSABuilds#downloads))**
@ -488,13 +492,13 @@
<details> <details>
<summary><a href="https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Installation.md"><img height="60" src="https://img.icons8.com/color/96/null/software-installer.png" style="float: left;" width="60"/><h1><a href="https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Installation.md">   Installation</a></h1></a></summary> <summary><a href="https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Installation.md"><img height="60" src="https://img.icons8.com/color/96/null/software-installer.png" style="float: left;" width="60"/><h1><a href="https://github.com/MustardChef/WSABuilds/blob/master/Documentation/WSABuilds/Installation.md">   Installation</a></h1></a></summary>
&gt; [!NOTE] > [!NOTE]
&gt; >
&gt; If you have the official Windows Subsystem For Android™ installed, you must [completely uninstall](#uninstallation) it to use MagiskOnWSA. > If you have the official Windows Subsystem For Android™ installed, you must [completely uninstall](#uninstallation) it to use MagiskOnWSA.
&gt; [!IMPORTANT] > [!IMPORTANT]
&gt; >
&gt; In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup Userdata.vhdx, located at ``%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx`` before uninstallation and restore it after installation. A guide for this process is located further down in this README. > In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup Userdata.vhdx, located at ``%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx`` before uninstallation and restore it after installation. A guide for this process is located further down in this README.
--- ---
@ -511,8 +515,8 @@
4. Delete the .7z archive 4. Delete the .7z archive
5. 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 5. 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
&gt; [!NOTE] > [!NOTE]
&gt; If you're updating WSA, merge the folders and replace the files for all items when asked > If you're updating WSA, merge the folders and replace the files for all items when asked
6. Open the Windows Subsystem For Android™ folder: Search for and double-click `Run.bat` 6. 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 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.
@ -572,8 +576,8 @@
### How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA) ### How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA)
&gt; [!IMPORTANT] > [!IMPORTANT]
&gt; Make sure that WSA has been turned off from the settings and that tools such has WSA-System-Control, WSA-Sideloader, WSAPacman etc are not running. > Make sure that WSA has been turned off from the settings and that tools such has WSA-System-Control, WSA-Sideloader, WSAPacman etc are not running.
1. [Download the latest build](https://github.com/MustardChef/WSABuilds#downloads) (that you want to update to) 1. [Download the latest build](https://github.com/MustardChef/WSABuilds#downloads) (that you want to update to)
@ -618,9 +622,9 @@
   
&gt; [!NOTE] > [!NOTE]
&gt; >
&gt; If you want to preseve your data, make a backup of the `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx` file. After uninstalling, copy the VHDX file back to the `%LOCALAPPDATA%\Package\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache` folder. For a more comprehensive and detailed guide, take a look at the **Backup and Restore section** in this README markdown > If you want to preseve your data, make a backup of the `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx` file. After uninstalling, copy the VHDX file back to the `%LOCALAPPDATA%\Package\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache` folder. For a more comprehensive and detailed guide, take a look at the **Backup and Restore section** in this README markdown
### To remove WSA installed through WSABuild: ### To remove WSA installed through WSABuild:
@ -662,8 +666,8 @@ In order to make a backup of your WSA data you must copy the ``Userdata.vhdx`` (
Before attempting to restore your backup, you must remove WSA if installed. Then before you run the ``Run.bat`` script (to reinstall WSA after removing it), you need to remove these lines from ``Install.ps1``, located in the your extracted WSA folder: Before attempting to restore your backup, you must remove WSA if installed. Then before you run the ``Run.bat`` script (to reinstall WSA after removing it), you need to remove these lines from ``Install.ps1``, located in the your extracted WSA folder:
   
&gt; [!TIP] > [!TIP]
&gt; The Lines (as shown below) that you need to remove in ``Install.ps1`` may vary depending on the type of WSA Build that you are trying to install. > The Lines (as shown below) that you need to remove in ``Install.ps1`` may vary depending on the type of WSA Build that you are trying to install.
#### Android Settings: #### Android Settings:
@ -697,8 +701,8 @@ When the Powershell window states "Press any key to quit", at that time multiple
![image](https://github.com/MustardChef/WSABuilds/assets/68516357/53ba5738-a504-4c31-a414-40258180ee09) ![image](https://github.com/MustardChef/WSABuilds/assets/68516357/53ba5738-a504-4c31-a414-40258180ee09)
&gt; [!IMPORTANT] > [!IMPORTANT]
&gt; ****Ignore these and do not click on anything or close these popups**** > ****Ignore these and do not click on anything or close these popups****
Go to ``%localappdata%\Packages`` and (if these folders/directory do not exist, create them) in ``MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\`` paste the userdata.vhdx Go to ``%localappdata%\Packages`` and (if these folders/directory do not exist, create them) in ``MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\`` paste the userdata.vhdx
@ -728,7 +732,7 @@ Now close the popups and run WSA and your userdata should hopefully be restored
``` ```
or or
- Location in Windows ---&gt;<br/> `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat` - Location in Windows ---><br/> `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat`
**Can I delete the installed folder?** **Can I delete the installed folder?**
@ -756,7 +760,7 @@ Now close the popups and run WSA and your userdata should hopefully be restored
**I cannot adb connect localhost:58526** **I cannot adb connect localhost:58526**
- Make sure developer mode is enabled. If the issue persists, check the IP address of Windows Subsystem For Android™ on the Settings ---&gt; Developer page and try - Make sure developer mode is enabled. If the issue persists, check the IP address of Windows Subsystem For Android™ on the Settings ---> Developer page and try
``` ```
adb connect ip:5555 adb connect ip:5555
@ -1174,10 +1178,10 @@ wsa://com.apple.android.music
| TikTok (Global) | 25.0.3 | 12, 11 | ✅ | TikTok (Global) | 25.0.3 | 12, 11 | ✅
| TikTok (TV Version) | 1.6.0 | 11 | ❌ | App crashes | TikTok (TV Version) | 1.6.0 | 11 | ❌ | App crashes
| TikTok Lite | 21.7.1 | 11 | ❌ | App crashes | TikTok Lite | 21.7.1 | 11 | ❌ | App crashes
| Tivimate | 4.4.0 | 11 | ✅ | Compatibility Options -&gt; Force App to be non-resizeable ; Disable smooth resize ; Keyboard Compatibility ; ForceFullScreen [F11] Note: Version 4.5. And above force crashes, the latest working version remains 4.4.0 | Tivimate | 4.4.0 | 11 | ✅ | Compatibility Options -> Force App to be non-resizeable ; Disable smooth resize ; Keyboard Compatibility ; ForceFullScreen [F11] Note: Version 4.5. And above force crashes, the latest working version remains 4.4.0
| TP-Link Tapo | 2.4.25 | 11 | ✅ | TP-Link Tapo | 2.4.25 | 11 | ✅
| Trello | 2021.14.1.16332-production | 11 | ⚠️ | Login needs web browser installed in WSA, using Windows' default browser will not work | Trello | 2021.14.1.16332-production | 11 | ⚠️ | Login needs web browser installed in WSA, using Windows' default browser will not work
| Trust: Crypto &amp; Bitcoin Wallet | 6.57.1 | 12 | ✅ || For login, you have to go to Android settings =&gt; System =&gt; Date &amp; Time and toggle the "Set Time Automatically" option. you can access it by this command .\adb.exe shell "am start -n com.android.settings/.Settings" | Trust: Crypto &amp; Bitcoin Wallet | 6.57.1 | 12 | ✅ || For login, you have to go to Android settings => System => Date &amp; Time and toggle the "Set Time Automatically" option. you can access it by this command .\adb.exe shell "am start -n com.android.settings/.Settings"
| Tune In Pro | 28.7 (267721) | 11 | ✅ | Tune In Pro | 28.7 (267721) | 11 | ✅
| Twitter | 9.16.1-release.00 | 11 | ✅ | Optionally requires GMS | Twitter | 9.16.1-release.00 | 11 | ✅ | Optionally requires GMS
| Twitter Lite | 3.1.1 | 12 | ✅ || | Twitter Lite | 3.1.1 | 12 | ✅ ||
@ -1515,8 +1519,8 @@ wsa://com.apple.android.music
<h4> If you can't find the build that you are looking for, I will be happy to fufill any custom build requests. <h4> <h4> If you can't find the build that you are looking for, I will be happy to fufill any custom build requests. <h4>
<h4> Open an issue in the [Issues page](https://github.com/MustardChef/WSABuilds/issues) with the information below. <h4> <h4> Open an issue in the [Issues page](https://github.com/MustardChef/WSABuilds/issues) with the information below. <h4>
&gt; [!IMPORTANT] > [!IMPORTANT]
&gt; - State the [Device Model](https://github.com/WSABuilds/MagiskOnWSALocal#--custom-model) (Default: Pixel 5)? <br/> - Root Solution (Magisk, KernelSU or none)? <br/> - If you want a WSA build with Magisk, what [variant of magisk](https://github.com/WSABuilds/MagiskOnWSALocal#--magisk-ver) would you like? <br/> - Would you like GApps (Google Play Store and Play Services (GMS))? <br/> - Would you like to keep the Amazon Appstore? > - State the [Device Model](https://github.com/WSABuilds/MagiskOnWSALocal#--custom-model) (Default: Pixel 5)? <br/> - Root Solution (Magisk, KernelSU or none)? <br/> - If you want a WSA build with Magisk, what [variant of magisk](https://github.com/WSABuilds/MagiskOnWSALocal#--magisk-ver) would you like? <br/> - Would you like GApps (Google Play Store and Play Services (GMS))? <br/> - Would you like to keep the Amazon Appstore?
</h4></h4></h4></h4></h3></h3> </h4></h4></h4></h4></h3></h3>
</details> </details>
@ -1645,9 +1649,9 @@ wsa://com.apple.android.music
<br/> <br/>
&gt; [!IMPORTANT] > [!IMPORTANT]
&gt; ***The repository is provided as a utility.*** > ***The repository is provided as a utility.***
&gt;***Android is a trademark of Google LLC. Windows™ and Windows Subsystem for Android™ are trademarks of Microsoft LLC.*** >***Android is a trademark of Google LLC. Windows™ and Windows Subsystem for Android™ are trademarks of Microsoft LLC.***
</details> </details>
</center> </center>