Update Docs

YT-Advanced · Jun 11, 2023 · 5e80f00 · 5e80f00
1 parent 60fa04e
commit 5e80f00
Show file tree

Hide file tree

Showing 14 changed files with 122 additions and 101 deletions.
diff --git a/Fixes/Fix Error 0x80073CF6.md b/Fixes/Fix Error 0x80073CF6.md
@@ -25,8 +25,6 @@ In E:\WSA\Install.ps1:102 Character:1
 
 **3. If you have installed WSA prior, make sure that it has been uninstalled and delete all folders containing "WindowsSubsystemForAndroid" from the following directories/paths and the subdirectories within:** 
 
-<br>
-
    - *C:\ProgramData\Microsoft\Windows\AppRepository*
 
    - *C:\ProgramData\Microsoft\Windows\WindowsApps*
@@ -37,8 +35,6 @@ In E:\WSA\Install.ps1:102 Character:1
 
 **4. Restart your Computer**
 
-<br>
-
 If the issue has been fixed, then there is no need to follow through the rest of the guide.
 However, if you have the same issue, it is vital that you obtain the logs and try to decipher what is causing the error
 
@@ -57,7 +53,6 @@ To obtain the logs (admin privilege required):
       ```
       
 </br>
-</br>
 
 
 ---
@@ -85,7 +80,6 @@ To obtain the logs (admin privilege required):
 
 **3. Restart your PC**
 
-<br>
 <br>
 
 ---
@@ -111,4 +105,4 @@ AppxManifest.xml (24,27): Error 0x80073B06: Unable to install or update package
 
 ---
 
-**Hope these fixes work for you!**
+**Hope these fixes work for you!**
diff --git a/Fixes/FixInstallps1.md b/Fixes/FixInstallps1.md
@@ -1,13 +1,10 @@
-# WSABuilds
    <summary><h2>Issue:<h2><h3> &nbsp; Install.ps1 is not recognized/missing<h3></summary>
 
 <img src="https://media.discordapp.net/attachments/1044322950725259274/1068243571544690719/9Qf3veK.png" />
 <img src="https://user-images.githubusercontent.com/68516357/215262023-89e0e0fa-3dd7-4d6d-b93a-224169f61971.png" />
 
 <summary><h2>Solution<h2></summary>
 
-&nbsp;
-
 If the popup windows disappear without asking administrative permission and Windows Subsystem For Android™ is not installed successfully, you should manually run Install.ps1 as administrator:
 
 &nbsp;  

diff --git a/Fixes/FixPathTooLong.md b/Fixes/FixPathTooLong.md
@@ -1,6 +1,3 @@
-# WSAGuides
-
----
 ## Issue: </br> Error stating that "Path is too long" when extracting files from .zip archive, needed to install Windows Subystem for Android (WSA)
 ### Preface:
 ##### This issue is caused if the folder name is too long. This is the typically the case as MagiskOnWSALocal script tends to generate a long string for the .zip file and the folder within the archive.

diff --git a/Fixes/FixVirtError.md b/Fixes/FixVirtError.md
@@ -1,5 +1,3 @@
-# WSAGuides
-
 ## Issues:
 <img src="https://user-images.githubusercontent.com/68629435/213985345-a6fc6e97-63f3-4741-8965-8d62a0d6b824.png"/>
 

diff --git a/Fixes/Google Play Issues.md b/Fixes/Google Play Issues.md
@@ -0,0 +1,10 @@
+## Issue: Could not sign-in. There was a problem connecting to play.google.com
+
+### Preface: 
+##### This issue will prevent you from signing into Play Store and effectively prevent the function of MindTheGapps/OpenGapps. This issue may usually occur after updating. Known cases have occured after updating from a non Google Apps WSA build to a Google Apps build 
+
+![image](/~https://github.com/MustardChef/WSABuilds/assets/68516357/6491854b-9ad2-4e64-94ea-45e7b444cafe)
+
+---
+
+## Solution: If you are using VPN, please disconnect it because VPN may make WSA fail to connect to VirtWifi.
diff --git a/Fixes/InstallPs1FailedToUpdate.md b/Fixes/InstallPs1FailedToUpdate.md
@@ -0,0 +1,13 @@
+## Issues: Install.ps1 Failed To Update
+
+&nbsp;
+
+<img src="/~https://github.com/MustardChef/WSABuilds/assets/68516357/7dff07f2-fde7-40b8-946c-d63ea18b2f99"/>
+
+## Solution: 
+
+1. Run Powershell with this command:
+```powershell
+PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1
+```
+&nbsp;
diff --git a/Fixes/InternetSecuritySettingsBlock.md b/Fixes/InternetSecuritySettingsBlock.md
@@ -0,0 +1,17 @@
+## Issue: </br> Error stating that "Your Internet security settings prevented one or more files from opening" when trying to run `Install.ps1` or `Run.bat` to install Windows Subystem for Android (WSA)
+
+### Preface:
+##### This issue is caused if the folder name is too long. This is the typically the case as MagiskOnWSALocal script tends to generate a long string for the .zip file and the folder within the archive.
+
+<img src="/~https://github.com/MustardChef/WSABuilds/assets/68516357/b17308cb-6b99-419d-ba79-3119bdbacd9d" style="width: 400px;"/>  
+
+---
+## Solution
+
+The solution is simple, all you have to do is:
+
+**1. Rename the .zip folder to a shorter name, which can be anything to your choosing </br> (For example: WSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon ----> WSAArchive2XXX)**
+
+**2. Rename the extracted folder to a shorter name, which can be anything to your choosing </br> (For example: WSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon ----> WSAExtracted2XXX)**
+
+---
diff --git a/Fixes/MissingIcons.md b/Fixes/MissingIcons.md
@@ -1,13 +1,8 @@
 ## Issue: Icons have disappeared or have turned white after updating WSA or after restarting your computer
 
-</br>
-
 ### Preface:
 ##### This looks like a bug in the WSA itself and the icons can be restored by the following steps.
 
-</br>
-</br>
-
 ## Solution
 
 **1.** Backup `userdata.vhdx` from `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx`

diff --git a/Fixes/TargetMachineActivelyRefusedConnection.md b/Fixes/TargetMachineActivelyRefusedConnection.md
@@ -0,0 +1,26 @@
+## Issue: </br> Error: No connection could be made because the target machine actively refused it (10061)
+### Preface:
+##### This issue occurs when you are either using a sideloading application such as [WSA-Sideloader](/~https://github.com/infinitepower18/WSA-Sideloader) or [WSAPacman](/~https://github.com/alesimula/wsa_pacman), or when you try to connect to a device using ``adb.exe`` via [Android SDK Platform Tools](https://developer.android.com/tools/releases/platform-tools). This issue arises due to an issue with the inability of Hyper V to reserve port 58526 causing the issue, as seen below.
+
+![image](https://user-images.githubusercontent.com/68516357/230793765-6c72a7d7-796f-4cb9-8a45-3d40b4f1d38f.png)
+
+```
+cannot connect to ||127.0.0.1:58526:|| No connection could be made because the target machine actively refused it. (10061)
+```
+---
+
+## Solution
+
+This is a [bug](/~https://github.com/microsoft/WSA/issues/136) with the subsystem itself, restarting the PC will usually fix it.
+
+If you still get this error, try these steps:
+
+1. Make sure WSA is turned off and disable WSA autostart in Task Manager ---> Startup Apps before proceeding
+
+2. Disable Hyper-V using the command ``dism.exe /Online /Disable-Feature:Microsoft-Hyper-V`` and reboot your PC
+
+3. Reserve port 58526 so Hyper-V doesn't reserve it back using the command `netsh int ipv4 add excludedportrange protocol=tcp startport=58526 numberofports=1`
+
+4. Re-enable Hyper-V using the command `dism.exe /Online /Enable-Feature:Microsoft-Hyper-V /All` and reboot your PC
+
+Your issue should be fixed now!
diff --git a/Guides/BusyBox.md b/Guides/BusyBox.md
@@ -0,0 +1,24 @@
+## Guide: How to install BusyBox
+
+### Preface:
+##### Since Magisk has BusyBox built-in already, this proceedure is very simple
+
+## Process
+
+### Step 1: 
+Using an Android browser downloaded though the Play Store/sideloaded into WSA, download the following [Magisk Module](/~https://github.com/Magisk-Modules-Alt-Repo/BuiltIn-BusyBox) to install and symlink BusyBox with its applets to the Magisk built-in busybox binary. No need to do it manually or to get a Custom Build.
+
+### Step 2: 
+Through Magisk Manager, install the Magisk module .zip file
+
+### Step 3 (Optional):
+You can then test if BusyBox is working by either using a Root Checker:
+![image](https://user-images.githubusercontent.com/68516357/219951996-cd72359c-cfa7-4b99-8965-8249b0c917e1.png)
+
+or by using ADB Shell and:
+
+`` adb shell ``
+``su``
+``busybox | head -1``
+
+![image](https://user-images.githubusercontent.com/68516357/219952139-7037c81a-a3d6-4e34-9cb7-84601f5cd990.png)
diff --git a/Guides/GetWIPLatestBuild.md b/Guides/GetWIPLatestBuild.md
diff --git a/Guides/LocalHostLoopback.md b/Guides/LocalHostLoopback.md
@@ -0,0 +1,17 @@
+## Guide: LocalHost Loopback
+#### Preface: You want to connect WSA to the localhost (Windows 11 hosting machine) or to a development server I run on Windows 11 or any such scenario where you would want to connect to the Windows 11 localhost, but are unable to 
+
+## Process:
+
+**1.** Run PowerShell as administrator
+
+**2.** Execute 
+```powershell
+Set-NetFirewallHyperVVMSetting -VMCreatorId '{9E288F02-CE00-4D9E-BE2B-14CE463B0298}' -LoopbackEnabled True
+``` 
+
+3.Execute 
+```powershell
+New-NetFirewallHyperVRule -DisplayName LoopbackAllow -VMCreatorId '{9E288F02-CE00-4D9E-BE2B-14CE463B0298}' -Direction Inbound -Action Allow -LocalPorts [PORT]
+```
+(replacing [PORT] with the port you're trying to expose)
diff --git a/Guides/WSA-Sideloader.md b/Guides/WSA-Sideloader.md
@@ -2,10 +2,6 @@
 #### With WSA Sideloader, you can install any APK file onto WSA. 
 #### This guide will show you how to use it.
 
-</br>
-
-</br>
-
 ## How to Download and Install WSA-Sideloader
 
 #### You can download WSA Sideloader in 3 different ways:

diff --git a/docs/README.md b/docs/README.md
@@ -413,12 +413,12 @@ Now run WSA and your serdata should hopefully be restored
 ### Install KernelSU Manager:
 [<img src="https://img.shields.io/badge/-How%20to%20install%20KernelSU%20Manager-474154?style=for-the-badge&logoColor=white&logo=github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/KernelSU.md)
 
+### Install BusyBox:
+[<img src="https://img.shields.io/badge/-How%20to%20install%20BusyBox-474154?style=for-the-badge&logoColor=white&logo=github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/BusyBox.md)
+
 ### Check Integrity Guide:
 [<img src="https://img.shields.io/badge/-HOW%20TO%20CHECK%20INTEGRITY%20OF%20DOWNLOAD%20PACKAGES-474154?style=for-the-badge&logoColor=white&logo=github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/Checksum.md)
 
-### How to build with latest WSA Insider Build:
-[<img src="https://img.shields.io/badge/-How%20to%20create%20Custom%20Build%20with%20Latest%20Insider%20Version-474154?style=for-the-badge&logoColor=white&logo=github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/GetWIPLatestBuild.md)
-
 ### GPU Guide:
 [<img src="https://img.shields.io/badge/-How%20to%20Change%20the%20GPU%20Used-474154?style=for-the-badge&logoColor=white&logo=github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/ChangingGPU.md)
 
@@ -428,7 +428,9 @@ Now run WSA and your serdata should hopefully be restored
 ### Moving WSA to another drive or partition:
 [<img src="https://img.shields.io/badge/-How%20to%20Move%20WSA%20to%20another%20drive%20or%20partition-474154?style=for-the-badge&logoColor=white&logo=github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/MoveToExtDrive.md)
 
-GetWIPLatestBuild.md
+### LocalHost Loopback Guide:
+[<img src="https://img.shields.io/badge/-How%20to%20connect%20WSA%20to%20the%20localhost-474154?style=for-the-badge&logoColor=white&logo=github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/LocalHostLoopback.md)
+
 </details> 
 
 &nbsp;
@@ -440,6 +442,8 @@ GetWIPLatestBuild.md
 
 [<img src="https://img.shields.io/badge/-Fix%20Install.ps1%20Issue-%23EF2D5E?style=for-the-badge&logoColor=white&logo=Github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/FixInstallps1.md)
 
+[<img src="https://img.shields.io/badge/-Fix%20Install.ps1%20Failed%20to%20update-%23EF2D5E?style=for-the-badge&logoColor=white&logo=Github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/nstallPs1FailedToUpdate.md)
+
 [<img src="https://img.shields.io/badge/-Fix Virtualization and Virtual Machine Platform Error-%23EF2D5E?style=for-the-badge&logoColor=white&logo=github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/FixVirtError.md)
 
 [<img src="https://img.shields.io/badge/-Fix%20Internet%20Issues-%23EF2D5E?style=for-the-badge&logoColor=white&logo=Github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/FixInternet.md)
@@ -460,6 +464,12 @@ GetWIPLatestBuild.md
 
 [<img src="https://img.shields.io/badge/-Fix%20Target%20Machine%20Actively%20Refused%20Connection-%23EF2D5E?style=for-the-badge&logoColor=white&logo=Github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/master/Fixes/TargetMachineActivelyRefusedConnection.md)
 
+[<img src="https://img.shields.io/badge/-Fix%20Target%20Machine%20Actively%20Refused%20Connection-%23EF2D5E?style=for-the-badge&logoColor=white&logo=Github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/master/Fixes/TargetMachineActivelyRefusedConnection.md)
+
+[<img src="https://img.shields.io/badge/-Fix%20Internet%20security%20settings%20blocked%20from%20opening-%23EF2D5E?style=for-the-badge&logoColor=white&logo=Github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/master/Fixes/InternetSecuritySettingsBlock.md)
+
+[<img src="https://img.shields.io/badge/-Cannot%20sign%20in%20to%20Google%20Account-%23EF2D5E?style=for-the-badge&logoColor=white&logo=Github" />](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/Google%20Play%20Issues.md)
+
 </details>  
 
 &nbsp;