From 5e80f00a511ea36b545e989dd4b78c4cce80b667 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ho=C3=A0ng=20Gia=20B=E1=BA=A3o?= <70064328+YT-Advanced@users.noreply.github.com> Date: Sun, 11 Jun 2023 16:08:02 +0700 Subject: [PATCH] Update Docs --- Fixes/Fix Error 0x80073CF6.md | 8 +- Fixes/FixInstallps1.md | 3 - Fixes/FixPathTooLong.md | 3 - Fixes/FixVirtError.md | 2 - Fixes/Google Play Issues.md | 10 +++ Fixes/InstallPs1FailedToUpdate.md | 13 ++++ Fixes/InternetSecuritySettingsBlock.md | 17 +++++ Fixes/MissingIcons.md | 5 -- .../TargetMachineActivelyRefusedConnection.md | 26 +++++++ Guides/BusyBox.md | 24 ++++++ Guides/GetWIPLatestBuild.md | 73 ------------------- Guides/LocalHostLoopback.md | 17 +++++ Guides/WSA-Sideloader.md | 4 - docs/README.md | 18 ++++- 14 files changed, 122 insertions(+), 101 deletions(-) create mode 100644 Fixes/Google Play Issues.md create mode 100644 Fixes/InstallPs1FailedToUpdate.md create mode 100644 Fixes/InternetSecuritySettingsBlock.md create mode 100644 Fixes/TargetMachineActivelyRefusedConnection.md create mode 100644 Guides/BusyBox.md delete mode 100644 Guides/GetWIPLatestBuild.md create mode 100644 Guides/LocalHostLoopback.md diff --git a/Fixes/Fix Error 0x80073CF6.md b/Fixes/Fix Error 0x80073CF6.md index 5b12acae..ce9192bf 100644 --- 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:** -
- - *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** -
- 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): ```
-
--- @@ -85,7 +80,6 @@ To obtain the logs (admin privilege required): **3. Restart your PC** -

--- @@ -111,4 +105,4 @@ AppxManifest.xml (24,27): Error 0x80073B06: Unable to install or update package --- -**Hope these fixes work for you!** \ No newline at end of file +**Hope these fixes work for you!** diff --git a/Fixes/FixInstallps1.md b/Fixes/FixInstallps1.md index 851dccbe..b33028f6 100644 --- a/Fixes/FixInstallps1.md +++ b/Fixes/FixInstallps1.md @@ -1,4 +1,3 @@ -# WSABuilds

Issue:

  Install.ps1 is not recognized/missing

 @@ -6,8 +5,6 @@

Solution

 -  - 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:   diff --git a/Fixes/FixPathTooLong.md b/Fixes/FixPathTooLong.md index 811d47e1..b4ab2ef5 100644 --- a/Fixes/FixPathTooLong.md +++ b/Fixes/FixPathTooLong.md @@ -1,6 +1,3 @@ -# WSAGuides - ---- ## Issue:
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 index fdd1a26d..df3e769c 100644 --- a/Fixes/FixVirtError.md +++ b/Fixes/FixVirtError.md @@ -1,5 +1,3 @@ -# WSAGuides - ## Issues: diff --git a/Fixes/Google Play Issues.md b/Fixes/Google Play Issues.md new file mode 100644 index 00000000..8ef9c460 --- /dev/null +++ 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 new file mode 100644 index 00000000..6dae56e8 --- /dev/null +++ b/Fixes/InstallPs1FailedToUpdate.md @@ -0,0 +1,13 @@ +## Issues: Install.ps1 Failed To Update + +  + + + +## Solution: + +1. Run Powershell with this command: +```powershell +PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1 +``` +  diff --git a/Fixes/InternetSecuritySettingsBlock.md b/Fixes/InternetSecuritySettingsBlock.md new file mode 100644 index 00000000..42c715a8 --- /dev/null +++ b/Fixes/InternetSecuritySettingsBlock.md @@ -0,0 +1,17 @@ +## Issue:
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. + + + +--- +## 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
(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
(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 index 1bed892e..16379489 100644 --- 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 -
- ### Preface: ##### This looks like a bug in the WSA itself and the icons can be restored by the following steps. -
-
- ## Solution **1.** Backup `userdata.vhdx` from `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx` diff --git a/Fixes/TargetMachineActivelyRefusedConnection.md b/Fixes/TargetMachineActivelyRefusedConnection.md new file mode 100644 index 00000000..c8ec5d16 --- /dev/null +++ b/Fixes/TargetMachineActivelyRefusedConnection.md @@ -0,0 +1,26 @@ +## Issue:
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 new file mode 100644 index 00000000..9a271ab1 --- /dev/null +++ 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 deleted file mode 100644 index bf65643e..00000000 --- a/Guides/GetWIPLatestBuild.md +++ /dev/null @@ -1,73 +0,0 @@ -# How to getting latest Insider Build -#### **1. Check the Insider Build from [Release](/~https://github.com/YT-Advanced/WSA-Script/releases/tag/WSA-Insider-Version) first. If it does not have the version you want, continue to follow this guide. If it does, then feel free to use those prebuild WSA builds** -#### **2. Open the home page, click on the button (shown below) and select "import a repository" or go to [this page directly](/~https://github.com/new/import)** - ***Step 2.1:*** - - - - ***Step 2.2:*** - - ![image](https://user-images.githubusercontent.com/68516357/221641202-e3ef4deb-f2dd-46e6-82c8-fb4767f82e99.png) - ---- -#### **3. [Copy the URL of this Repo](/~https://github.com/YT-Advanced/WSA-Script) and paste it into the the text box below and press "Import"** - -![image](https://user-images.githubusercontent.com/68516357/221643582-72d71f68-8f53-48d9-a940-692a54d42098.png) - ---- -#### **4. Go to the **Setting** tab in your newly imported repo and enable "Github Actions"** - ***Step 4.1:*** - -![Settings](https://user-images.githubusercontent.com/68516357/222214308-b52b1c6f-a60b-44ef-9ce0-bc335087e3a2.png) - - ***Step 4.2:*** - -![MRq9WD3SO2](https://user-images.githubusercontent.com/68516357/222215598-30d68ad3-9700-4061-bba4-815b3befcb10.png) - ---- -#### **5. Then, scroll down until you reach the section titled "Workflow Permission" and follow the steps as shown in the image below** -![image](https://user-images.githubusercontent.com/68516357/224546417-a82249b4-3864-42bd-8a29-32350b8b0c97.png) - ---- -#### **6. Open [this link](/~https://github.com/settings/tokens/new) in new tab, then follow the step below. FINALLY, SCROLL DOWN AND CLICK GENERATE TOKEN** -![image](https://user-images.githubusercontent.com/70064328/231184720-0d3b4ce7-0b82-4b1f-b337-5f0fd0ceb632.png) - ---- -#### **7. The key will appear. Then click the copy button at right side of the key.** -![image](https://user-images.githubusercontent.com/70064328/231189492-cf3b407e-708b-4224-ba4e-11f3e27012a1.png) - ---- -#### **8. Now, back to your repository **Setting** tab, and open Secret and Variable, then click Action. Next click **New reporistory secret** button** -![image](https://user-images.githubusercontent.com/70064328/231191605-1e3c4b53-6d17-49f5-8e7f-c752ae12aee8.png) - ---- -#### **9. In the name boxes, type PAT. Next, paste your copied Secret key to Secret boxes, then click **Add Secrets** button** -![image](https://user-images.githubusercontent.com/70064328/231192376-16aa194c-07ae-4262-857f-d9d86701a110.png) - ---- -#### **10. Now, Go to the **Action** tab** -![CvYhP0B0CI](https://user-images.githubusercontent.com/68516357/222221960-f48ab9c3-eb77-4cb0-b932-5cd343381048.png) - ---- -#### **11. In the left sidebar, click the **Custom Build** workflow.** -![image](https://user-images.githubusercontent.com/68516357/222221307-8a4571d2-ac3e-410b-b999-0eb62b14d8d5.png) - ---- -#### **12. Above the list of workflow runs, select **Run workflow**** -![image](https://user-images.githubusercontent.com/68516357/222222850-f991890c-5a80-4cc2-b83d-0ef35c24a79e.png) - ---- -#### **13. Select your desired options such as ***WSA Release Channel***, ***Magisk Version***, ***WSA Archetecture*** , ***GApps Varient*** and ***Compression Format*** then click **Run workflow**** -> **Note** : -> In WSA Release Channel option, you must choose Insider Private or specific Microsoft User Code for getting latest WSA Insider Version - -![image](https://user-images.githubusercontent.com/68516357/222224185-abcfa0cf-c8c6-46e3-bc38-871c968b86f2.png) - ---- -#### **14. Wait for the action to complete and download the artifact** -**DO NOT download it via multithread downloaders like IDM** -![image](https://user-images.githubusercontent.com/68516357/222224469-5748b78a-158e-46ff-9f65-317dbb519aac.png) - ---- -#### **15. Install like normal using [the instructions](/~https://github.com/YT-Advanced/WSA-Script#--installation) in this repository** and most important of all.... - diff --git a/Guides/LocalHostLoopback.md b/Guides/LocalHostLoopback.md new file mode 100644 index 00000000..968eaeb2 --- /dev/null +++ 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 index e4068c8d..902ee981 100644 --- 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. -
- -
- ## 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 index 79f59333..1ecd6186 100644 --- 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: [](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/KernelSU.md) +### Install BusyBox: +[](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/BusyBox.md) + ### Check Integrity Guide: [](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/Checksum.md) -### How to build with latest WSA Insider Build: -[](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/GetWIPLatestBuild.md) - ### GPU Guide: [](/~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: [](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/MoveToExtDrive.md) -GetWIPLatestBuild.md +### LocalHost Loopback Guide: +[](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Guides/LocalHostLoopback.md) +   @@ -440,6 +442,8 @@ GetWIPLatestBuild.md [](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/FixInstallps1.md) +[](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/nstallPs1FailedToUpdate.md) + [](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/FixVirtError.md) [](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/FixInternet.md) @@ -460,6 +464,12 @@ GetWIPLatestBuild.md [](/~https://github.com/YT-Advanced/WSA-Script/blob/master/Fixes/TargetMachineActivelyRefusedConnection.md) +[](/~https://github.com/YT-Advanced/WSA-Script/blob/master/Fixes/TargetMachineActivelyRefusedConnection.md) + +[](/~https://github.com/YT-Advanced/WSA-Script/blob/master/Fixes/InternetSecuritySettingsBlock.md) + +[](/~https://github.com/YT-Advanced/WSA-Script/blob/main/Fixes/Google%20Play%20Issues.md) +