Mirrors/WSABuilds
2
0
Fork 0
mirror of https://github.com/MustardChef/WSABuilds.git synced 2024-11-23 11:49:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #34 from MustardChef/MustardChef-sideloader-guide

Browse Source 
Splitting Sideloader Guide Into Three Sections
This commit is contained in:
MCDeltaT 2023-03-18 23:09:00 +00:00 committed by GitHub
commit 46dc3f9990
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 121 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Guides/ADB-Sideloading.md Normal file
View File

@ -0,0 +1 @@

36
Guides/Sideloading.md
View File

@ -1,36 +1,14 @@
# WSABuilds &nbsp; &nbsp; <img src="https://img.shields.io/github/downloads/MustardChef/WSABuilds/total?label=Total%20Downloads&style=for-the-badge"/> &nbsp;
### Guide: Sideloading APKs (installing from Windows) into Windows Subsystem For Android™
&nbsp;
## Guide: Sideloading APKs
**Step 1:** &nbsp; Download and install [**WSA Pacman**](https://github.com/alesimula/wsa_pacman/releases) or [**WSA Sideloader**](https://github.com/infinitepower18/WSA-Sideloader).
### This guide covers the three different method of sideloading and installing APKs (from Windows) into Windows Subsystem For Android™
&nbsp;
&nbsp;
|Application|
|-----------|
|[<img src="https://user-images.githubusercontent.com/68516357/226143645-0a0ff0df-00f4-4d69-a257-1ffbee039f36.png" style="width: 250px;"/>](https://github.com/MustardChef/WSABuilds/blob/master/Guides/WSA-Sideloader.md)|
|[<img src="https://user-images.githubusercontent.com/68516357/226144462-25e8ba07-9f5b-424b-9ecf-b973e8f396b2.png" style="width: 300px;" style="float: left;"/>](https://github.com/MustardChef/WSABuilds/blob/master/Guides/WSAPacman.md)|
|[<img src="https://user-images.githubusercontent.com/68516357/226143960-70ba58b6-7339-48c8-9f25-602e7236eaf5.png" style="width: 240px;" style="float: left;"/>](https://github.com/MustardChef/WSABuilds/blob/master/Guides/ADB-Sideloading.md)|
**Step 2:** &nbsp; Go to `Windows Subsystem for Android` → `Developer` and turn on **Developer mode**.
> **Warning**:
> #### You have to give WSAPacman or other sideloaders, ADB Debugging permission.
>
> ![](https://media.discordapp.net/attachments/1015131233824538624/1062611905249820733/allow.png)
&nbsp;
&nbsp;
> **Note**
> #### If the "Install" button is greyed out while installing apk
>
> ![image](https://user-images.githubusercontent.com/68516357/215341077-162f64c0-bea5-4f39-9f48-a8d5acaa5cf3.png)
>
> #### Solution: Open WSAPacman and turn on WSA from there.
>![](https://media.discordapp.net/attachments/1015131233824538624/1062610433506287708/WSA-pacman_x7UaiviLSW.png)
</br>
> **Note**
> #### If WSAPacman states that the "Installation timed out":
>
> <img src="https://user-images.githubusercontent.com/68516357/222983664-cf41ac0b-194b-4c11-9b40-2975eea6c176.png" style="width: 350px;"/>
>
> #### Solution: Wait for a few minutes, and see if the app is installed and shows in the Start Menu. If not retry the installation </br> In the case that nothing works, report this to the [WSAPacman Github](https://github.com/alesimula/wsa_pacman)

81
Guides/WSA-Sideloader.md Normal file
View File

@ -0,0 +1,81 @@
# WSA Sideloader Usage Guide
#### 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:
Operating System|Downloads
|---------|---------|
|<img src="https://upload.wikimedia.org/wikipedia/commons/e/e6/Windows_11_logo.svg" style="width: 150px;"/></br><img src="https://upload.wikimedia.org/wikipedia/commons/0/05/Windows_10_Logo.svg" style="width: 150px;"/> |[<img src="https://user-images.githubusercontent.com/49786146/159123331-729ae9f2-4cf9-439b-8515-16a4ef991089.png" style="width: 200px;"/>](https://winget.run/pkg/infinitepower18/WSASideloader)|
|<img src="https://upload.wikimedia.org/wikipedia/commons/e/e6/Windows_11_logo.svg" style="width: 150px;"/></br><img src="https://upload.wikimedia.org/wikipedia/commons/0/05/Windows_10_Logo.svg" style="width: 150px;"/> |[<img src="https://user-images.githubusercontent.com/68516357/226141505-c93328f9-d6ae-4838-b080-85b073bfa1e0.png" style="width: 200px;"/>](https://github.com/infinitepower18/WSA-Sideloader/releases/latest)|
|<img src="https://upload.wikimedia.org/wikipedia/commons/e/e6/Windows_11_logo.svg" style="width: 150px;"/>|[<img src="https://get.microsoft.com/images/en-GB%20dark.svg" style="width: 200px;"/>](https://www.microsoft.com/store/apps/9NMFSJB25QJR)|
## Setup
***Step 1. Once installed, you should see this screen:***
![image](https://user-images.githubusercontent.com/44692189/226059063-9148821a-8661-4f38-9089-bfd6bb72b135.png)
>**Note** :
> If you get a message that says WSA is not installed, check that you have downloaded and installed WSA correctly as per the WSABuilds instructions.
</br>
***Step 2. Next, open WSA Settings from the start menu or by typing wsa-settings:// in your browser's address bar, select Developer and enable Developer mode. Most likely the IP address shown is 127.0.0.1:58526 which is already entered by default in WSA Sideloader, however if the IP address is different for you make sure to change it in the sideloader.***
![image](https://user-images.githubusercontent.com/44692189/226059697-9d54c122-8674-46f4-871a-4937805498ef.png)
</br>
***Step 3. Now, you can click the Browse button to select your APK file. You can also double click a file in File Explorer to automatically open WSA Sideloader with the APK file already selected.***
<img width="1157" alt="image" src="https://user-images.githubusercontent.com/44692189/226060206-ffc9a9af-42b2-4281-859d-bb83c3e8b019.png">
</br>
***Step 4. The first time you install an APK, it will ask to allow ADB debugging. Allow it and attempt the installation again. Check the always allow box if you don't want to manually accept the permission every time you install an app.***
<img width="485" alt="image" src="https://user-images.githubusercontent.com/44692189/226060674-233a60b5-56d7-4dcf-a626-295d21a4c464.png">
</br>
***Step 5. It should take a few seconds to install the APK. Once it says `The application has been successfully installed`, you can click Open app.***
>**Note** :
> If WSA is off, WSA Sideloader will start it for you. After 30 seconds, the installation will automatically continue.
<img width="314" alt="image" src="https://user-images.githubusercontent.com/44692189/226061387-f0126c32-3a2f-49c4-8ecf-83ad5809ab38.png">
</br>
***You can find all your installed WSA apps on the start menu, as well as via the "Installed apps" button in WSA Sideloader:***
<img width="962" alt="image" src="https://user-images.githubusercontent.com/44692189/226061500-c210ded3-5342-483d-b4b8-c4b683b138a7.png">
## Updating WSA Sideloader
From time to time, there may be updates that improve the reliability of the app, as well as ensuring it works properly with future releases of WSA.
Therefore, it's highly recommended you keep it up to date.
- If you installed WSA Sideloader using MS Store, you can update the app via the store.
- If you installed through other methods, the sideloader will notify you of an update the next time you launch it.
## Troubleshooting
If you get an error like the one below, check that you have allowed the ADB authorization and enabled Developer Mode.
<img width="446" alt="image" src="https://user-images.githubusercontent.com/44692189/226061768-61743f6c-2ed3-401a-a561-8754c297ad74.png">
If you continue to face problems, make a note of the error info displayed in WSA Sideloader and join the Discord server below for further assistance.
[<img src="https://invidget.switchblade.xyz/2thee7zzHZ" style="width: 400px;"/>](https://discord.gg/2thee7zzHZ)
## Credits
#### Special Thanks to infinitepower18
#### Feel free to Star the [WSA-Sideloader Github Repo](https://github.com/infinitepower18/WSA-Sideloader/) or leave a review on the [Microsoft Store Page](https://www.microsoft.com/store/apps/9NMFSJB25QJR), if you found the app useful

32
Guides/WSAPacman.md Normal file
View File

@ -0,0 +1,32 @@
# WSAPacman
**Step 1:** &nbsp; Download and install [**WSA Pacman**](https://github.com/alesimula/wsa_pacman/releases)
**Step 2:** &nbsp; Go to `Windows Subsystem for Android` → `Developer` and turn on **Developer mode**.
> **Warning**:
> #### You have to give WSAPacman, ADB Debugging permission.
>
> ![](https://media.discordapp.net/attachments/1015131233824538624/1062611905249820733/allow.png)
&nbsp;
&nbsp;
## Issues and Solutions
> **Note**
> #### If the "Install" button is greyed out while installing apk
>
> ![image](https://user-images.githubusercontent.com/68516357/215341077-162f64c0-bea5-4f39-9f48-a8d5acaa5cf3.png)
>
> #### Solution: Open WSAPacman and turn on WSA from there.
>![](https://media.discordapp.net/attachments/1015131233824538624/1062610433506287708/WSA-pacman_x7UaiviLSW.png)
</br>
> **Note**
> #### If WSAPacman states that the "Installation timed out":
>
> <img src="https://user-images.githubusercontent.com/68516357/222983664-cf41ac0b-194b-4c11-9b40-2975eea6c176.png" style="width: 350px;"/>
>
> #### Solution: Wait for a few minutes, and see if the app is installed and shows in the Start Menu. If not retry the installation </br> In the case that nothing works, report this to the [WSAPacman Github](https://github.com/alesimula/wsa_pacman)