From 1e7712714f9e5c742bbc412161b08b0d9058080e Mon Sep 17 00:00:00 2001 From: MCDeltaT <68516357+MustardChef@users.noreply.github.com> Date: Thu, 4 May 2023 13:00:25 +0100 Subject: [PATCH] Update Instruction on Custom Building --- README.md | 160 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 84 insertions(+), 76 deletions(-) diff --git a/README.md b/README.md index 15a2130..30f7d77 100644 --- a/README.md +++ b/README.md @@ -38,102 +38,110 @@ > #### The same level of scrutiny should be applied with the Windows Subsystem For Android™ builds as with any other program that you download from the internet - +

  ❓Want to build your own custom build❓

- + | :exclamation: **Important:**   `⚠️DO NOT FORK⚠️` | |------------------------------------------------------------------------| -|**The repository shown in this is designed specifically not to be forked. MagiskOnWSA and some of the various forks and clones that have sprung up on the platform (***potentially***) violate GitHub's Terms of Service due to abuse of GitHub Actions and have been ultimately warned, disabled or banned.**| -|**Therefore, don't fork this repository unless you're a developer and want to modify the code itself and/or want to contribute to the Github repository.**| +|**This repository is designed specifically not to be forked. MagiskOnWSA and some of the various forks and clones that have sprung up on the platform (***potentially***) violate GitHub's Terms of Service due to abuse of GitHub Actions and have been ultimately warned, disabled or banned.**| +|**Therefore, don't fork this repository unless you're a developer and want to modify the code itself and/or want to contribute to this Github repository.**| |**If you want to create your Custom Build, please follow the instructions set out clearly, to avoid the repo from being taken down as a result of a misuse of Github Actions due to the large number of forks.**| - ---- -#### **1. Star this repos (I will happy if you do that)** + +#### **1. Star the WSABuilds repos (I will happy if you do that)** ---- #### **2. Check the version from [Releases](https://github.com/MustardChef/WSABuilds/releases) 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** ---- -#### **3. Log into your Github Account (this is necessary) and in 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 1:*** - - - - ***Step 2:*** - - ![image](https://user-images.githubusercontent.com/68516357/221641202-e3ef4deb-f2dd-46e6-82c8-fb4767f82e99.png) - ---- -#### **4. [Copy the URL of this Repo](https://github.com/WellCodeIsDelicious/WSA-Script) and paste it into the the text box below and press "Import"** +#### **3. Open [this page directly](https://wellcodeisdelicious.github.io/WSA-Script/Issues.html) then choose the option that you want to build** +![image](https://user-images.githubusercontent.com/70064328/236150011-191bf3a8-2efb-44a1-af44-202c6ea9fe66.png) -![image](https://user-images.githubusercontent.com/68516357/221643582-72d71f68-8f53-48d9-a940-692a54d42098.png) +#### **4. Click "Create Issues" Button, the issues page will be generated and open. Then you click "Submit New Issues" (green button) and wait.** +![image](https://user-images.githubusercontent.com/70064328/236150320-65fdd492-9fc4-4176-b3bd-a3cee8b7753d.png) ---- -#### **5. Go to the **Setting** tab in your newly imported repo and enable "Github Actions"** - -![Settings](https://user-images.githubusercontent.com/68516357/222214308-b52b1c6f-a60b-44ef-9ce0-bc335087e3a2.png) -![MRq9WD3SO2](https://user-images.githubusercontent.com/68516357/222215598-30d68ad3-9700-4061-bba4-815b3befcb10.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 ***Magisk Version***, ***WSA Release Channel + WSA Archetecture*** , ***GApps Varient*** and ***Compression Format*** then click **Run workflow**** - -![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** +#### **5. After about 15 minutes, the bot will reply that the workflow have built successfully (like the picture below), OPEN THE LINK BELOW THE BOT COMMENT** +![image](https://user-images.githubusercontent.com/70064328/236154819-75dd1997-1999-43fd-a482-050f21e34b72.png) +#### **6. Download the package as artifact** **DO NOT download it via multithread downloaders like IDM** ![image](https://user-images.githubusercontent.com/68516357/222224469-5748b78a-158e-46ff-9f65-317dbb519aac.png) +#### **7. Install like normal using [the instructions](https://github.com/YT-Advanced/WSA-Script#--installation) in this repository** + --- -#### **15. Install like normal using [the instructions](https://github.com/YT-Advanced/WSA-Script#--installation) in this repository** and most important of all.... +

  The workflow didn't work ❓ Follow these step

-
+#### **1. 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 1.1:*** + + + + ***Step 1.2:*** + + ![image](https://user-images.githubusercontent.com/68516357/221641202-e3ef4deb-f2dd-46e6-82c8-fb4767f82e99.png) + +--- +#### **2. [Copy the URL of this Repo](https://github.com/WellCodeIsDelicious/WSA-Script) and paste it into the the text box below and press "Import"** -### **Enjoy!** - -
+![image](https://user-images.githubusercontent.com/68516357/221643582-72d71f68-8f53-48d9-a940-692a54d42098.png) + +--- +#### **3. Go to the **Setting** tab in your newly imported repo and enable "Github Actions"** + ***Step 3.1:*** + +![Settings](https://user-images.githubusercontent.com/68516357/222214308-b52b1c6f-a60b-44ef-9ce0-bc335087e3a2.png) + + ***Step 3.2:*** + +![MRq9WD3SO2](https://user-images.githubusercontent.com/68516357/222215598-30d68ad3-9700-4061-bba4-815b3befcb10.png) + +--- +#### **4. 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) + +--- +#### **5. 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) + +--- +#### **6. 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) + +--- +#### **7. 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) + +--- +#### **8. 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) + +--- +#### **9. Now, Go to the **Action** tab** +![CvYhP0B0CI](https://user-images.githubusercontent.com/68516357/222221960-f48ab9c3-eb77-4cb0-b932-5cd343381048.png) + +--- +#### **10. In the left sidebar, click the **Custom Build** workflow.** +![image](https://user-images.githubusercontent.com/68516357/222221307-8a4571d2-ac3e-410b-b999-0eb62b14d8d5.png) + +--- +#### **11. Above the list of workflow runs, select **Run workflow**** +![image](https://user-images.githubusercontent.com/68516357/222222850-f991890c-5a80-4cc2-b83d-0ef35c24a79e.png) + +--- +#### **12. Select your desired options such as ***Magisk Version***, ***WSA Release Channel + WSA Archetecture*** , ***GApps Varient*** and ***Compression Format*** then click **Run workflow**** +![image](https://user-images.githubusercontent.com/68516357/222224185-abcfa0cf-c8c6-46e3-bc38-871c968b86f2.png) --- -
+#### **13. 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) + +--- +#### **14. Install like normal using [the instructions](https://github.com/YT-Advanced/WSA-Script#--installation) in this repository** and most important of all.... + +### **Enjoy!** + +

  ❓Want to request a prebuilt custom build❓