From 035888fd57aac30006133a77ceae7471f8c21de5 Mon Sep 17 00:00:00 2001 From: MCDeltaT <68516357+MustardChef@users.noreply.github.com> Date: Wed, 18 Oct 2023 19:39:25 +0100 Subject: [PATCH] Update README.md --- .vscode/settings.json | 5 + .../Post-Install Issues/FixInternet.md | 2 +- ...ries.md => Remove Non Existent Entries.md} | 0 Documentation/WSABuilds/Backup and Restore.md | 14 +- Documentation/WSABuilds/Having Issues.md | 3 + Documentation/WSABuilds/Usage Guide.md | 12 +- README.md | 218 +++++++++++------- 7 files changed, 165 insertions(+), 89 deletions(-) create mode 100644 .vscode/settings.json rename Documentation/Usage Guides/General Usage Guides/{Remove Non-Existant Entries.md => Remove Non Existent Entries.md} (100%) diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..afb4b64 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,5 @@ +{ + "cSpell.words": [ + "Sideload" + ] +} \ No newline at end of file diff --git a/Documentation/Fix Guides/Post-Install Issues/FixInternet.md b/Documentation/Fix Guides/Post-Install Issues/FixInternet.md index 1f4d2f6..4be90aa 100644 --- a/Documentation/Fix Guides/Post-Install Issues/FixInternet.md +++ b/Documentation/Fix Guides/Post-Install Issues/FixInternet.md @@ -117,7 +117,7 @@ Sometimes Windows Firewall and other Firewall tools and software may be the caus

Antivirus Users

It is a known issue that some antivirus firewall such as those built-in to ESET, Bitdefender, AVG and many others, can prevent the internet for Windows Susbsystem for Android (WSA) from working. -It is highly recommended to disable the firewall provided by these Antivirus/Antimalware tools and fallback to Windows Firewall, to see if the internet starts working. +It is highly recommended to disable the firewall provided by these Antivirus/Antimalware tools and fallback to Windows Firewall (default), to see if the internet starts working. Source: From my own experience and reports from others in the Discord community linked at the end. If disabling a certain antivirus/antimalware's built-in firewall works, please join the Discord server (invite at the end of this guide) and inform us. diff --git a/Documentation/Usage Guides/General Usage Guides/Remove Non-Existant Entries.md b/Documentation/Usage Guides/General Usage Guides/Remove Non Existent Entries.md similarity index 100% rename from Documentation/Usage Guides/General Usage Guides/Remove Non-Existant Entries.md rename to Documentation/Usage Guides/General Usage Guides/Remove Non Existent Entries.md diff --git a/Documentation/WSABuilds/Backup and Restore.md b/Documentation/WSABuilds/Backup and Restore.md index 61a2916..4ddcf68 100644 --- a/Documentation/WSABuilds/Backup and Restore.md +++ b/Documentation/WSABuilds/Backup and Restore.md @@ -45,6 +45,16 @@ Amazon Appstore: ```pwsh Start-Process "wsa://com.amazon.venezia" ``` -After running the script, do not run WSA at all, and go to ``%localappdata%\Packages`` and (if the folders do not exist, create them) in ``MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\`` paste the userdata.vhdx -Now run WSA and your userdata should hopefully be restored \ No newline at end of file +After removing the lines above, run the script. + +When the Powershell window states "Press any key to quit", at that time multiple dialogue boxes will open: + +<-- --> + +> [!IMPORTANT] +> ****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 + +Now close the popups and run WSA and your userdata should hopefully be restored \ No newline at end of file diff --git a/Documentation/WSABuilds/Having Issues.md b/Documentation/WSABuilds/Having Issues.md index 4ece194..252e370 100644 --- a/Documentation/WSABuilds/Having Issues.md +++ b/Documentation/WSABuilds/Having Issues.md @@ -43,3 +43,6 @@ [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fixes%20Guides/Pre-install%20Issues/InstallPs1FailedToUpdate.md) +[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fixes%20Guides/Pre-install%20Issues/Appx%20Module%20Cannot%20Be%20Loaded.md) + +[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fixes%20Guides/Pre-install%20Issues/Specified%20Logon%20Error.md) diff --git a/Documentation/WSABuilds/Usage Guide.md b/Documentation/WSABuilds/Usage Guide.md index eba101b..529c5fa 100644 --- a/Documentation/WSABuilds/Usage Guide.md +++ b/Documentation/WSABuilds/Usage Guide.md @@ -13,13 +13,17 @@ ### Moving WSA to another drive or partition: [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/MoveToExtDrive.md) -### Installing KernelSU +### Installing KernelSU: [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/KernelSU.md) -### Installing BusyBox +### Installing BusyBox: [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/BusyBox.md) -### Localhost Loopback Guide +### Localhost Loopback Guide: -[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/LocalHostLoopback.md) +[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/LocalHostLoopback.md) + +### Remove Non-Existent App Entries: + +[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/Remove%20Non%20Existent%20App%20Entries.md) \ No newline at end of file diff --git a/README.md b/README.md index d780231..769c260 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,29 @@ -# WSABuilds     -[](https://github.com/MustardChef/WSABuilds#downloads)   [](https://forum.xda-developers.com/t/wsabuilds-latest-windows-subsystem-for-android-wsa-builds-for-windows-10-and-11-with-magisk-and-google-play-store.4545087/) -### MagiskOnWSA (For Windows™ 10 and 11) [](https://discord.gg/2thee7zzHZ) -#### Windows Subsystem For Android™ (WSA) with Google Play Services and (or) Magisk + +
+ + +

WSABuilds

+ ko-fi +

MagiskOnWSA (For Windows™ 10 and 11)

+

Windows Subsystem For Android™ (WSA) with Google Play Services and Magisk and KernelSU
+ +
+
- -[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/N4N0K08AC) -
- -  +
## Downloads
-

  WSABuilds Project Status

 +

  WSABuilds Project Status

 +

⚠️❗IMPORTANT: Read Before Downloading❗⚠️

+ +
+ ## Builds Status and Stability #### Known Issues that may affect your WSA experiences: @@ -24,12 +31,12 @@ - ***Folder Issue : Long folder name for the WSA Folder (auto generated by the MagiskOnWSALocal script) may cause WSA to not start. Rename the folder to ``WSA`` after extracting and before installing WSA.*** - ***Installed Magisk Modules disappear after install and subsequent reboot (WSA v2307):*** https://github.com/MustardChef/WSABuilds/issues/154 -
+<
- - + + @@ -95,26 +102,28 @@ - - + + - - + + - + + - + + - + @@ -135,8 +144,8 @@ - - + + @@ -151,54 +160,66 @@ - + - - + - - + - - + + - - - + + - - - + + - - - - - + + + + + - - + + - - - + + + + + + + + + + + + + + + + + + +
WSA Version:
v2304.40000.5.0⚠️⛔⚠️⛔
v2304.40000.6.0⚠️⛔⚠️⛔
v2304.40000.7.0 ✅⛔⛔
v2304.40000.10.0 ✅⛔⛔
v2305.40000.2.0 ✅⛔⛔
v2305.40000.3.0v2305.40000.6.0 ✅ ✅
v2306.40000.1.0 ✅ ✅✅ ✅
v2306.40000.4.0 ✅ ✅
v2307.40000.2.0 ✅ ✅
v2307.40000.3.0 ✅ ✅
v2307.40000.5.0 ✅ ✅
v2307.40000.6.0 ✅ ✅
v2308.40000.1.0 ✅ ✅
v2308.40000.2.0Update Skipped to allow time for adjusting the Docs and the build script (MagiskOnWSALocal).
Sorry for any Inconvenence. Updates will resume as normal after this.
v2308.40000.2.0Update Skipped to allow time for adjusting the Docs and the build script (MagiskOnWSALocal).
Sorry for any Inconvenence. Updates will resume as normal after this.
v2308.40000.3.0 ✅ ✅
v2309.40000.2.0➖➖
✅✅
v2309.40000.4.0"Updates have been skipped, in order to allow time to switch to GitHub Actions from my Linux Server, which I have been using since the start of the GitHub repo. Rest assure that this will likely be the last disruption. Once again I appologise and would also like to thank you for using this repo."

MustardChef
v2309.40000.5.0
v2309.40000.7.0
v2308.40000.4.0
v2309.40000.8.0
@@ -329,7 +350,7 @@

-

windownold

+

windownold

@@ -421,7 +442,7 @@  
-

  Installation

 +

  Installation

   @@ -494,7 +515,7 @@
-

  Updating

 +

  Updating

 ### How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA) @@ -540,7 +561,7 @@  
-

  Uninstallation

 +

  Uninstallation

   @@ -577,7 +598,7 @@  
-

  Backup and Restore Userdata

 +

  Backup and Restore Userdata

 ## Backing Up Your Userdata @@ -641,7 +662,7 @@ Now close the popups and run WSA and your userdata should hopefully be restored  
-

  FAQ

 +

  FAQ

   **Help me, I am having problems with the MagiskOnWSA Builds** @@ -722,7 +743,7 @@ Now close the popups and run WSA and your userdata should hopefully be restored  
-

  Usage Guides

 +

  Usage Guides

   @@ -735,23 +756,27 @@ Now close the popups and run WSA and your userdata should hopefully be restored ### Moving WSA to another drive or partition: [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/MoveToExtDrive.md) -### Installing KernelSU +### Installing KernelSU: [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/KernelSU.md) -### Installing BusyBox +### Installing BusyBox: [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/BusyBox.md) -### Localhost Loopback Guide +### Localhost Loopback Guide: -[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/LocalHostLoopback.md) +[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/LocalHostLoopback.md) + +### Remove Non-Existent App Entries: + +[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Usage%20Guides/General%20Usage%20Guides/Remove%20Non%20Existent%20App%20Entries.md)
 
-

  Having Issues?

 +

  Having Issues?

 ### Common Issues: [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fixes%20Guides/Pre-install%20Issues/FixInstallps1.md) @@ -795,13 +820,18 @@ Now close the popups and run WSA and your userdata should hopefully be restored [](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fixes%20Guides/Pre-install%20Issues/InstallPs1FailedToUpdate.md) +[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fixes%20Guides/Pre-install%20Issues/Appx%20Module%20Cannot%20Be%20Loaded.md) + +[](https://github.com/MustardChef/WSABuilds/blob/master/Documentation/Fixes%20Guides/Pre-install%20Issues/Specified%20Logon%20Error.md) + +
 
-

  Custom Builds Requests

 +

  Custom Builds Requests

  ❓Want to request a prebuilt custom build❓

@@ -810,13 +840,14 @@ Now close the popups and run WSA and your userdata should hopefully be restored > [!IMPORTANT] > - State the [Device Model](https://github.com/WSABuilds/MagiskOnWSALocal#--custom-model) (Default: Pixel 5)?
- Root Solution (Magisk, KernelSU or none)?
- If you want a WSA build with Magisk, what [variant of magisk](https://github.com/WSABuilds/MagiskOnWSALocal#--magisk-ver) would you like?
- Would you like GApps (Google Play Store and Play Services (GMS))?
- Would you like to keep the Amazon Appstore? -

+
 
-

  Credits

 +

  Credits

 +
@@ -847,72 +878,95 @@ Now close the popups and run WSA and your userdata should hopefully be restored - + - + - + - + - + - - + + - +
Cinit Patches for WSA to enable WSA (Windows Subsystem for Android) to run on Windows 10, used in the WSA builds for Windows 10. Unlicenced License✅
Windows 10 LogoMicrosoft (original), AkshayAnand Microsoft (Original Author), AkshayAnand (Image) WIndows 10 Logo used in this repo. Follows Microsoft's Brand/Trademark Guidelines. Public Domain ✅
Windows 11 LogoMicrosoft (original), OAOVMicrosoft (Original Author), OAOV (Image) WIndows 11 Logo used in this repo. Follows Microsoft's Brand/Trademark Guidelines. Public Domain ✅
WIndows 10 Logo with wordmarkWIndows 10 Logo with "Windows" wordmark Microsoft WIndows 10 Logo used in this repo. Follows Microsoft's Brand/Trademark Guidelines.
 CC-BY-SA 4.0
 ✅
WIndows 11 Logo with workmarkWIndows 11 Logo with "Windows" wordmark Microsoft WIndows 11 Logo used in this repo. Follows Microsoft's Brand/Trademark Guidelines. Public Domain ✅
Icon8Icons8 and authors,Icons8Icons8 Some icons used in this repo were obtained from Icons8. To view the specific icons used, check the raw Markdown and HTML files, Icons8 License✅
--- -### Other Resources used as reference +### Other Projects used as reference or referenced + +- [WSA-Sideloader](https://github.com/infinitepower18/WSA-Sideloader/) - Easily sideload Android apps on Windows Subsystem for Android + +- [WSAPacman](https://github.com/alesimula/wsa_pacman) - A GUI package manager and package installer for Windows Subsystem for Android (WSA) + +- [APK-Installer](https://github.com/Paving-Base/APK-Installer) - An Android Application Installer for Windows - [StoreLib](https://github.com/StoreDev/StoreLib): API for downloading WSA + - [Magisk](https://github.com/topjohnwu/Magisk): The Magic Mask for Android -- [The Open Google Apps Project](https://opengapps.org): Script the automatic generation of up-to-date Google Apps packages + - [KernelSU](https://github.com/tiann/KernelSU): A Kernel based root solution for Android + - [WSAGAScript](https://github.com/ADeltaX/WSAGAScript): The first GApps integration script for WSA + - [MagiskOnWSA](https://github.com/LSPosed/MagiskOnWSA): `Deprecated` Integrate Magisk root and Google Apps into WSA ---- - -### Is this GitHub Repo affiliated with Microsoft™ or Google™? - -- Microsoft and the Dev team at MSFT are the developers of Windows Subsystem For Android. We do not claim to develop, or have a part in developing this emulator. We also have no real influence on the direction of development of WSA nor do we claim to have. - -- What the WSABuild repo does is that it provides prebuilt WSA builds with Root and GMS built using the MagiskOnWSALocal project (and WSAPatch for the Windows 10 patch.) That is that we simply modify the emulator to add extra functionality to it. - -- All this is, is an unofficial project not related in any way to Microsoft and the team working on Windows Subsystem For Android. - +
--- -***The repository is provided as a utility.*** +### Is this GitHub Repo affiliated with Microsoft™? -***Android is a trademark of Google LLC. Windows™ is a trademark of Microsoft LLC.*** +

NO!

+ +###### - Microsoft and the Dev team at MSFT are the developers of Windows Subsystem For Android. We do not claim to develop, or have a part in developing this emulator. We also have no real influence on the direction of development of WSA and nor do we claim to. + +###### - What the WSABuild repo does is that it provides prebuilt WSA builds with Root and GMS built using the MagiskOnWSALocal project (and WSAPatch for the Windows 10 patch.) That is that we simply modify the emulator to add extra functionality to it. + +###### - All this is, is an unofficial project not related in any way to Microsoft and the team working on Windows Subsystem For Android. + +--- + +### Is this GitHub Repo affiliated with Google™ or Android™? + +

NO!

+ +###### This is an unofficial project not related in any way to Google and the team working on Android. + +--- + +
+ +> [!IMPORTANT] +> ***The repository is provided as a utility.*** +>***Android is a trademark of Google LLC. Windows™ and Windows Subsystem for Android™ are trademarks of Microsoft LLC.*** +>***This project is not affiliated with Google LLC or Microsoft LLC.***