From 9cb2e4b156e1dece3e7e514e3f579c7e6ec86a74 Mon Sep 17 00:00:00 2001 From: Angus Date: Wed, 13 Aug 2025 23:25:57 +0800 Subject: [PATCH 1/5] Fix image links and markdown formatting. --- docs/EN/AdvancedOptions/DevBranch.md | 2 +- docs/EN/SettingUpAaps/BrowserBuild.md | 7 ++++--- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/EN/AdvancedOptions/DevBranch.md b/docs/EN/AdvancedOptions/DevBranch.md index 851f33a1e9f1..6c605841b5a5 100644 --- a/docs/EN/AdvancedOptions/DevBranch.md +++ b/docs/EN/AdvancedOptions/DevBranch.md @@ -37,7 +37,7 @@ Available from 3.3.2.1.dev ``` -![aaps_ci_pr_ci](C:\Data\50 - My Projects\AAPS\OpenAPS\AndroidAPSdocs\docs\EN\images\Building-the-App\CI\aaps_ci_pr_ci.png) +![aaps_ci_pr_ci](../images/Building-the-App/CI/aaps_ci_pr_ci.png) - PR number: Please enter the PR number that you want to test. diff --git a/docs/EN/SettingUpAaps/BrowserBuild.md b/docs/EN/SettingUpAaps/BrowserBuild.md index 9ccac305b043..5ae67c779a79 100644 --- a/docs/EN/SettingUpAaps/BrowserBuild.md +++ b/docs/EN/SettingUpAaps/BrowserBuild.md @@ -68,9 +68,10 @@ GitHub now displays your personal copy of AndroidAPS. Leave this web browser tab 
       • Download the preparation file from here
-

+ ``` + AndroidAPS build requires private keys, that are stored in a Java KeyStore (JKS): - If this is your first time building AAPS (or you don't have a an Android Studio JKS), follow [AAPS-CI Option 1 – Generate JKS](aaps-ci-option1) to complete the setup. @@ -195,8 +196,8 @@ The AAPS app will be saved in your Google Cloud drive once built: (aaps-ci-troubleshooting)= ## AAPS-CI Troubleshooting - (aaps-ci-preparation)= - ### aaps-ci-preparation web page +(aaps-ci-preparation)= +### aaps-ci-preparation web page - When you open aaps-ci-preparation.html using a file manager, it will start a temporary local server on your phone to display the webpage and receive the Google refresh token. - If you see the screen below, it means you have been inactive for a while, and the file manager has already shut down the local server. - Please reopen aaps-ci-preparation.html using the file manager app and complete the remaining steps. From 8d6a9830f174143df2bce5ea1796b03e3266b6d4 Mon Sep 17 00:00:00 2001 From: Angus Date: Wed, 13 Aug 2025 23:29:59 +0800 Subject: [PATCH 2/5] markdown formatting. --- docs/EN/SettingUpAaps/BrowserBuild.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/EN/SettingUpAaps/BrowserBuild.md b/docs/EN/SettingUpAaps/BrowserBuild.md index 5ae67c779a79..57f4c18b1060 100644 --- a/docs/EN/SettingUpAaps/BrowserBuild.md +++ b/docs/EN/SettingUpAaps/BrowserBuild.md @@ -70,7 +70,7 @@ GitHub now displays your personal copy of AndroidAPS. Leave this web browser tab • Download the preparation file from here ``` - +
AndroidAPS build requires private keys, that are stored in a Java KeyStore (JKS): From 42abeacf456a9556585198191dcdcd1a422c4f30 Mon Sep 17 00:00:00 2001 From: Angus Date: Wed, 13 Aug 2025 23:41:09 +0800 Subject: [PATCH 3/5] Add Troubleshooting (VPN & GitHub Actions Permissions) --- docs/EN/SettingUpAaps/BrowserBuild.md | 8 ++++++++ .../CI/aaps-ci-actions-permission.jpg | Bin 0 -> 6779 bytes 2 files changed, 8 insertions(+) create mode 100644 docs/EN/images/Building-the-App/CI/aaps-ci-actions-permission.jpg diff --git a/docs/EN/SettingUpAaps/BrowserBuild.md b/docs/EN/SettingUpAaps/BrowserBuild.md index 57f4c18b1060..bff13b126d74 100644 --- a/docs/EN/SettingUpAaps/BrowserBuild.md +++ b/docs/EN/SettingUpAaps/BrowserBuild.md @@ -204,7 +204,15 @@ The AAPS app will be saved in your Google Cloud drive once built: ![aaps_ci_html_not_found](../images/Building-the-App/CI/aaps_ci_html_not_found.png) +(aaps-ci-disable-software)= +### Disable Software That May Interfere With OAUTH Verification + - Disable any VPN or security app (firewall, antimalware,...) on the phone before trying to get the OAUTH key +(aaps-ci-actions-permission)= +### Check GitHub Action Permission Settings + - Make sure GitHub Action policies are set correctly to "Allow all actions and reusable workflows" + + ![aaps_ci_actions_permission](../images/Building-the-App/CI/aaps-ci-actions-permission.jpg) -------- diff --git a/docs/EN/images/Building-the-App/CI/aaps-ci-actions-permission.jpg b/docs/EN/images/Building-the-App/CI/aaps-ci-actions-permission.jpg new file mode 100644 index 0000000000000000000000000000000000000000..8aa0f7bd272f9b73b33d9bf3903032e807d237f4 GIT binary patch literal 6779 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 literal 0 HcmV?d00001 From 99af9b164d9c071041816bcb05ddacc7a1b02935 Mon Sep 17 00:00:00 2001 From: Angus Date: Thu, 14 Aug 2025 00:07:37 +0800 Subject: [PATCH 4/5] Additional explanation for Permissions --- docs/EN/SettingUpAaps/BrowserBuild.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/EN/SettingUpAaps/BrowserBuild.md b/docs/EN/SettingUpAaps/BrowserBuild.md index bff13b126d74..44cabec01abe 100644 --- a/docs/EN/SettingUpAaps/BrowserBuild.md +++ b/docs/EN/SettingUpAaps/BrowserBuild.md @@ -206,11 +206,11 @@ The AAPS app will be saved in your Google Cloud drive once built: (aaps-ci-disable-software)= ### Disable Software That May Interfere With OAUTH Verification - - Disable any VPN or security app (firewall, antimalware,...) on the phone before trying to get the OAUTH key + - Disable any VPN or security app (firewall, antimalware,...) on the phone before trying to get the OAUTH key. (aaps-ci-actions-permission)= ### Check GitHub Action Permission Settings - - Make sure GitHub Action policies are set correctly to "Allow all actions and reusable workflows" + - Make sure GitHub Actions policies are set to “Allow all actions and reusable workflows” (Settings → Actions → General). ![aaps_ci_actions_permission](../images/Building-the-App/CI/aaps-ci-actions-permission.jpg) From 2a10def08854ab721f582265131a3a850c22244d Mon Sep 17 00:00:00 2001 From: Angus Date: Thu, 14 Aug 2025 00:10:05 +0800 Subject: [PATCH 5/5] Corrected typo --- docs/EN/SettingUpAaps/BrowserBuild.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/EN/SettingUpAaps/BrowserBuild.md b/docs/EN/SettingUpAaps/BrowserBuild.md index 44cabec01abe..ca18dc95c107 100644 --- a/docs/EN/SettingUpAaps/BrowserBuild.md +++ b/docs/EN/SettingUpAaps/BrowserBuild.md @@ -209,7 +209,7 @@ The AAPS app will be saved in your Google Cloud drive once built: - Disable any VPN or security app (firewall, antimalware,...) on the phone before trying to get the OAUTH key. (aaps-ci-actions-permission)= -### Check GitHub Action Permission Settings +### Check GitHub Actions Permission Settings - Make sure GitHub Actions policies are set to “Allow all actions and reusable workflows” (Settings → Actions → General). ![aaps_ci_actions_permission](../images/Building-the-App/CI/aaps-ci-actions-permission.jpg)