Merge pull request #2095 from tanja3981/master

#2094: Update installation instructions to ladybug
openaps · Oct 8, 2024 · df64477 · df64477
2 parents 0e17779 + ef34884
commit df64477
Show file tree

Hide file tree

Showing 85 changed files with 166 additions and 208 deletions.
diff --git a/docs/EN/Installing-AndroidAPS/building-AAPS.md b/docs/EN/Installing-AndroidAPS/building-AAPS.md
diff --git a/docs/EN/Installing-AndroidAPS/troubleshooting_androidstudio.md b/docs/EN/Installing-AndroidAPS/troubleshooting_androidstudio.md
@@ -29,7 +29,8 @@ Gradle Sync can fail to various reasons. Wen you get a message saying that gradl
 These are the usual gradle sync failures:
 * [Uncommitted changes](troubleshooting_androidstudio-uncommitted-changes)
 * [No cached version of ... available](troubleshooting_androidstudio-could-not-resolve-no-cached-version)
-* [Android Gradle requires Java 11 to run](troubleshooting_androidstudio-android-gradle-plugin-requires-java-11-to-run)
+* [Incompatible Gradle JVM](incompatible-gradle-jvm)
+* [Incompatible version of the Android Gradle plugin](incompatible-version-of-android-gradle-plugin)
 
 *Important*:
 After you have followed the instructions for your specific problem, you need to trigger the [gradle sync](troubleshooting_androidstudio-gradle-resync) again.
@@ -103,43 +104,41 @@ If you receive a failure message like
 
 #### Step 3: Resync Gradle (again)
 
-Follow the instructions at [Gradle Resync](troubleshooting_androidstudio-step-3-gradle-resync).
+Follow the instructions at [Gradle Resync](gradle-resync).
 
 (troubleshooting_androidstudio-android-gradle-plugin-requires-java-11-to-run)=
 
-### Incompatible version of Android Gradle plugin
-
-  If you experience the following error message
-
-  ![Incompatible version of Android Gradle plugin](../images/studioTroubleshooting/15_InkompatibelAndroidGradlePlugin.png)
-
-  You are using an outdated version of Android Studio. 
-  In the menu, go to Help > Check for updates and install any updates of Android Studio and its plugins that are found.
-
-### Android Gradle plugin requires Java 17 to run
-
-  You might experience this error message:
+(incompatible-gradle-jvm)=
+### Incompatible Gradle JVM ###
 
-  ![Android Gradle plugin requires Java 17 to run](../images/studioTroubleshooting/11_GradleJDK.png)
+![Incompatible Gradle JVM](../images/studioTroubleshooting/160_InkompatibelAndroidGradleJVM.png)
+  If you experience the following error message, you need to download a correct JVM version before you can try again:
+* Open the gradle view by clicking on the elephant (1) on the right side of Android Studio and open the settings (2) and select **Gradle Settings** (3):
+
+![Open Gradle Settings](../images/studioTroubleshooting/161_GradleSettings.png)
 
-  Click on "Gradle Settings" (1) to go to open the gradle settings.
-
-  If you don't have the link to the "Gradle Settings", open the Gradle settings manually by selecting the Gradle Tab on the right border (1), select the tools icon (2) and there the item 'Gradle Settings' (3).
+* Open the **Gradle JDK** options, then select **Download JDK...**
 
-  ![Gradle Settings](../images/studioTroubleshooting/09_GradleSettings.png)
+![Select Download JDK](../images/studioTroubleshooting/162_DownloadJDK.png)
 
-  When you have opened the Gradle settings dialog, open the options (1) at "Gradle JDK" and selected the "jbr-17" (2), which should be located within your Android Studion installation directory.
+* At **Version** (1), you need to select **17**. Then select the **JetBrains Runtime** from the **Vendor** (2) options. Do not change the **Location** (3).
 
-  ![Gradle Settings](../images/studioTroubleshooting/12_GradleSettingsJDK.png)
+![Select JDK 17](../images/studioTroubleshooting/163_JDKSelection.png)
 
-  Press "OK" to save and close the settings dialog.
+* Close the **Settings** dialog with **OK**.
+* You now need to restart the Gradle Sync. Follow the instructions at [Gradle Resync](gradle-resync).
 
-  *Important*: If you don't see the setting "Gradle JDK", you might have not updated Android Studio. Make sure you are using Android Studio 2022.3 Giraffe) or newer.
+(incompatible-version-of-android-gradle-plugin)=
+### Incompatible version of Android Gradle plugin
 
-  Now you need to trigger a [Gradle Resync](troubleshooting_androidstudio-step-3-gradle-resync)
+  If you experience the following error message
+
+  ![Incompatible version of Android Gradle plugin](../images/studioTroubleshooting/15_InkompatibelAndroidGradlePlugin.png)
+
+  You are using an outdated version of Android Studio. 
+  In the menu, go to Help > Check for updates and install any updates of Android Studio and its plugins that are found.
 
 (troubleshooting_androidstudio-could-not-resolve-no-cached-version)=
-
 ### Could not resolve/No cached version
 
   You might get this error message:
@@ -152,19 +151,18 @@ Follow the instructions at [Gradle Resync](troubleshooting_androidstudio-step-3-
 
     ![Gradle Offline Mode](../images/studioTroubleshooting/10_GradleOfflineMode.png)
 
-  * Now you need to trigger a [Gradle Resync](troubleshooting_androidstudio-step-3-gradle-resync)
+  * Now you need to trigger a [Gradle Resync](gradle-resync)
 
 (troubleshooting_androidstudio-unable-to-start-daemon-process)=
 ### Unable to start daemon process
 
-  If you see an error message like the one below you probably use a Windows 10 32-bit system. This is not supported by Android Studio 3.5.1 and above and unfortunately nothing the AAPS developer can do about.
-
-  If you are using Windows 10 you must use a 64-bit operating system.
+  If you see an error message like the one below you probably use a Windows 10 32-bit system. This is not supported by Android Studio 3.5.1 and above and unfortunately nothing the AAPS developer can do about!
 
   There are a lot of manuals on the internet how to determine wether you have a 32-bit or 64-bit OS - i.e. [this one](https://support.microsoft.com/en-us/windows/32-bit-and-64-bit-windows-frequently-asked-questions-c6ca9541-8dce-4d48-0415-94a3faa2e13d).
 
   ![Screenshot Unable to start daemon process](../images/AndroidStudioWin10_32bitError.png)
 
+(gradle-resync)=
 ### Gradle Resync
 
   If you can still see the message that the gradle sync failed, now select the Link "Try again".

diff --git a/docs/EN/images/Building-the-App/010_DownloadLadybug.png b/docs/EN/images/Building-the-App/010_DownloadLadybug.png
diff --git a/docs/EN/images/Building-the-App/011_InstallLadybug.png b/docs/EN/images/Building-the-App/011_InstallLadybug.png
diff --git a/docs/EN/images/Building-the-App/012_InstallLadybug.png b/docs/EN/images/Building-the-App/012_InstallLadybug.png
diff --git a/docs/EN/images/Building-the-App/013_InstallLadybug.png b/docs/EN/images/Building-the-App/013_InstallLadybug.png
diff --git a/docs/EN/images/Building-the-App/014_InstallLadybug.png b/docs/EN/images/Building-the-App/014_InstallLadybug.png
diff --git a/docs/EN/images/Building-the-App/015_InstallLadybug.png b/docs/EN/images/Building-the-App/015_InstallLadybug.png
diff --git a/docs/EN/images/Building-the-App/016_InstallLadybug.png b/docs/EN/images/Building-the-App/016_InstallLadybug.png
diff --git a/docs/EN/images/Building-the-App/01_InstallAS_Hedgehog.png b/docs/EN/images/Building-the-App/01_InstallAS_Hedgehog.png
diff --git a/docs/EN/images/Building-the-App/020_ImproveAS.png b/docs/EN/images/Building-the-App/020_ImproveAS.png
diff --git a/docs/EN/images/Building-the-App/022_WelcomeAndroidStudioInstallation.png b/docs/EN/images/Building-the-App/022_WelcomeAndroidStudioInstallation.png
diff --git a/docs/EN/images/Building-the-App/023_DefaultInstallation.png b/docs/EN/images/Building-the-App/023_DefaultInstallation.png
diff --git a/docs/EN/images/Building-the-App/024_DefaultInstallation.png b/docs/EN/images/Building-the-App/024_DefaultInstallation.png
diff --git a/docs/EN/images/Building-the-App/025_LicenseAgreement.png b/docs/EN/images/Building-the-App/025_LicenseAgreement.png
diff --git a/docs/EN/images/Building-the-App/026_DownloadFinished.png b/docs/EN/images/Building-the-App/026_DownloadFinished.png
diff --git a/docs/EN/images/Building-the-App/02_Welcome_AS_Hedgehog.png b/docs/EN/images/Building-the-App/02_Welcome_AS_Hedgehog.png
diff --git a/docs/EN/images/Building-the-App/031_WelcomeAndroidStudio.png b/docs/EN/images/Building-the-App/031_WelcomeAndroidStudio.png
diff --git a/docs/EN/images/Building-the-App/032_GetVCS.png b/docs/EN/images/Building-the-App/032_GetVCS.png
diff --git a/docs/EN/images/Building-the-App/033_CloneGit.png b/docs/EN/images/Building-the-App/033_CloneGit.png
diff --git a/docs/EN/images/Building-the-App/034_CloningProgress.png b/docs/EN/images/Building-the-App/034_CloningProgress.png
diff --git a/docs/EN/images/Building-the-App/035_TrustProject.png b/docs/EN/images/Building-the-App/035_TrustProject.png
diff --git a/docs/EN/images/Building-the-App/036_GradleSyncing.png b/docs/EN/images/Building-the-App/036_GradleSyncing.png
diff --git a/docs/EN/images/Building-the-App/037_WindowsDefender.png b/docs/EN/images/Building-the-App/037_WindowsDefender.png
diff --git a/docs/EN/images/Building-the-App/038_SettingsGit.png b/docs/EN/images/Building-the-App/038_SettingsGit.png
diff --git a/docs/EN/images/Building-the-App/039_GitTest.png b/docs/EN/images/Building-the-App/039_GitTest.png
diff --git a/docs/EN/images/Building-the-App/039_GitTestError.png b/docs/EN/images/Building-the-App/039_GitTestError.png
diff --git a/docs/EN/images/Building-the-App/039_GitTestSuccess.png b/docs/EN/images/Building-the-App/039_GitTestSuccess.png
diff --git a/docs/EN/images/Building-the-App/03_choose_AS_components.png b/docs/EN/images/Building-the-App/03_choose_AS_components.png
diff --git a/docs/EN/images/Building-the-App/040_GenerateSignedAPK.png b/docs/EN/images/Building-the-App/040_GenerateSignedAPK.png
diff --git a/docs/EN/images/Building-the-App/041_APK.png b/docs/EN/images/Building-the-App/041_APK.png
diff --git a/docs/EN/images/Building-the-App/042_CreateNewKey.png b/docs/EN/images/Building-the-App/042_CreateNewKey.png
diff --git a/docs/EN/images/Building-the-App/043_Keystore.png b/docs/EN/images/Building-the-App/043_Keystore.png
diff --git a/docs/EN/images/Building-the-App/044_RememberPwd.png b/docs/EN/images/Building-the-App/044_RememberPwd.png
diff --git a/docs/EN/images/Building-the-App/045_BuildPath.png b/docs/EN/images/Building-the-App/045_BuildPath.png
diff --git a/docs/EN/images/Building-the-App/046_BuildRunning.png b/docs/EN/images/Building-the-App/046_BuildRunning.png
diff --git a/docs/EN/images/Building-the-App/047_BuildDetails.png b/docs/EN/images/Building-the-App/047_BuildDetails.png
diff --git a/docs/EN/images/Building-the-App/048_BuildFinished.png b/docs/EN/images/Building-the-App/048_BuildFinished.png
diff --git a/docs/EN/images/Building-the-App/049_ReopenNotification.png b/docs/EN/images/Building-the-App/049_ReopenNotification.png
diff --git a/docs/EN/images/Building-the-App/04_AS_Install_location.png b/docs/EN/images/Building-the-App/04_AS_Install_location.png
diff --git a/docs/EN/images/Building-the-App/04_AS_StartMenu.png b/docs/EN/images/Building-the-App/04_AS_StartMenu.png
diff --git a/docs/EN/images/Building-the-App/050_LocateAPK.png b/docs/EN/images/Building-the-App/050_LocateAPK.png
diff --git a/docs/EN/images/Building-the-App/06_Installation_Complete.png b/docs/EN/images/Building-the-App/06_Installation_Complete.png
diff --git a/docs/EN/images/Building-the-App/07_CloseAS_Setup.png b/docs/EN/images/Building-the-App/07_CloseAS_Setup.png
diff --git a/docs/EN/images/Building-the-App/08_Googlesharedata.png b/docs/EN/images/Building-the-App/08_Googlesharedata.png
diff --git a/docs/EN/images/Building-the-App/09_MissingSDK.png b/docs/EN/images/Building-the-App/09_MissingSDK.png
diff --git a/docs/EN/images/Building-the-App/10_SDKComponents_setup.png b/docs/EN/images/Building-the-App/10_SDKComponents_setup.png
diff --git a/docs/EN/images/Building-the-App/11_Verify_settings.png b/docs/EN/images/Building-the-App/11_Verify_settings.png
diff --git a/docs/EN/images/Building-the-App/12_Licence_agreement.png b/docs/EN/images/Building-the-App/12_Licence_agreement.png
diff --git a/docs/EN/images/Building-the-App/13_downloading_components.png b/docs/EN/images/Building-the-App/13_downloading_components.png
diff --git a/docs/EN/images/Building-the-App/14_finished_downloading_components.png b/docs/EN/images/Building-the-App/14_finished_downloading_components.png
diff --git a/docs/EN/images/Building-the-App/15_Welcome_AS.png b/docs/EN/images/Building-the-App/15_Welcome_AS.png
diff --git a/docs/EN/images/Building-the-App/16_Get_from_VCS.png b/docs/EN/images/Building-the-App/16_Get_from_VCS.png
diff --git a/docs/EN/images/Building-the-App/17_select_URL.png b/docs/EN/images/Building-the-App/17_select_URL.png
diff --git a/docs/EN/images/Building-the-App/18_cloning_repository.png b/docs/EN/images/Building-the-App/18_cloning_repository.png
diff --git a/docs/EN/images/Building-the-App/18a_trust_project.png b/docs/EN/images/Building-the-App/18a_trust_project.png
diff --git a/docs/EN/images/Building-the-App/18b_ConfirmRestartUI.png b/docs/EN/images/Building-the-App/18b_ConfirmRestartUI.png
diff --git a/docs/EN/images/Building-the-App/18c_AbortBackgroundTasks.png b/docs/EN/images/Building-the-App/18c_AbortBackgroundTasks.png
diff --git a/docs/EN/images/Building-the-App/18d_AbortProcessImport.png b/docs/EN/images/Building-the-App/18d_AbortProcessImport.png
diff --git a/docs/EN/images/Building-the-App/19_downloading_dependencies.png b/docs/EN/images/Building-the-App/19_downloading_dependencies.png
diff --git a/docs/EN/images/Building-the-App/20_close_popup.png b/docs/EN/images/Building-the-App/20_close_popup.png
diff --git a/docs/EN/images/Building-the-App/21_AS_version_control.png b/docs/EN/images/Building-the-App/21_AS_version_control.png
diff --git a/docs/EN/images/Building-the-App/22_Git_path.png b/docs/EN/images/Building-the-App/22_Git_path.png
diff --git a/docs/EN/images/Building-the-App/23_Git__path_success.png b/docs/EN/images/Building-the-App/23_Git__path_success.png
diff --git a/docs/EN/images/Building-the-App/23a_Git_path_OK.png b/docs/EN/images/Building-the-App/23a_Git_path_OK.png
diff --git a/docs/EN/images/Building-the-App/25_build_apk.png b/docs/EN/images/Building-the-App/25_build_apk.png
diff --git a/docs/EN/images/Building-the-App/26_generate_APK.png b/docs/EN/images/Building-the-App/26_generate_APK.png
diff --git a/docs/EN/images/Building-the-App/27_new_keystore.png b/docs/EN/images/Building-the-App/27_new_keystore.png
diff --git a/docs/EN/images/Building-the-App/28_new_keystore_path.png b/docs/EN/images/Building-the-App/28_new_keystore_path.png
diff --git a/docs/EN/images/Building-the-App/29_choose_keystore_file.png b/docs/EN/images/Building-the-App/29_choose_keystore_file.png
diff --git a/docs/EN/images/Building-the-App/30_new_keystore.png b/docs/EN/images/Building-the-App/30_new_keystore.png
diff --git a/docs/EN/images/Building-the-App/31_generate_APK.png b/docs/EN/images/Building-the-App/31_generate_APK.png
diff --git a/docs/EN/images/Building-the-App/32_full_release.png b/docs/EN/images/Building-the-App/32_full_release.png
diff --git a/docs/EN/images/Building-the-App/33_Studio_building1.png b/docs/EN/images/Building-the-App/33_Studio_building1.png
diff --git a/docs/EN/images/Building-the-App/34_Studio_building2.png b/docs/EN/images/Building-the-App/34_Studio_building2.png
diff --git a/docs/EN/images/Building-the-App/35_Studio__built_locate.png b/docs/EN/images/Building-the-App/35_Studio__built_locate.png
diff --git a/docs/EN/images/Building-the-App/35_Studio__built_success.png b/docs/EN/images/Building-the-App/35_Studio__built_success.png
diff --git a/docs/EN/images/Building-the-App/36_locate_apk.png b/docs/EN/images/Building-the-App/36_locate_apk.png
diff --git a/docs/EN/images/Building-the-App/37_full_release_apk.png b/docs/EN/images/Building-the-App/37_full_release_apk.png
diff --git a/docs/EN/images/Building-the-App/OldUI.png b/docs/EN/images/Building-the-App/OldUI.png
diff --git a/docs/EN/images/Building-the-App/trustProject.png b/docs/EN/images/Building-the-App/trustProject.png
diff --git a/docs/EN/images/studioTroubleshooting/160_InkompatibelAndroidGradleJVM.png b/docs/EN/images/studioTroubleshooting/160_InkompatibelAndroidGradleJVM.png
diff --git a/docs/EN/images/studioTroubleshooting/161_GradleSettings.png b/docs/EN/images/studioTroubleshooting/161_GradleSettings.png
diff --git a/docs/EN/images/studioTroubleshooting/162_DownloadJDK.png b/docs/EN/images/studioTroubleshooting/162_DownloadJDK.png
diff --git a/docs/EN/images/studioTroubleshooting/163_JDKSelection.png b/docs/EN/images/studioTroubleshooting/163_JDKSelection.png