diff --git a/docs/EN/Installing-AndroidAPS/building-AAPS.md b/docs/EN/Installing-AndroidAPS/building-AAPS.md index fbb09755e882..1af03d226c79 100644 --- a/docs/EN/Installing-AndroidAPS/building-AAPS.md +++ b/docs/EN/Installing-AndroidAPS/building-AAPS.md @@ -11,39 +11,37 @@ See [FAQ page](../Getting-Started/FAQ.md) for details. (Building-APK-recommended-specification-of-computer-for-building-apk-file)= ## Computer and software specifications for building AAPS -* Please use the **[Android Studio version called at least Hedgehog or one more recent like Iguana, Jellyfish, and Koala](https://developer.android.com/studio/)** to build the apk. **Do not use the Ladybug version.** Older versions of Android Studio need to be updated first! +* Please use the **[Android Studio version called at least Hedgehog (2023.1.1) or one more recent like Iguana, Jellyfish, Koala or Ladybug](https://developer.android.com/studio/)** to build the apk. Older versions of Android Studio need to be updated first! * [Windows 32-bit systems](troubleshooting_androidstudio-unable-to-start-daemon-process) are not supported by Android Studio. Please keep in mind that both **64 bit CPU and 64 bit OS are mandatory condition.** If your system DOES NOT meet this condition, you have to change affected hardware or software or the whole system. - + - - - + + + - - - + - + - + - + - + @@ -60,7 +58,7 @@ See [FAQ page](../Getting-Started/FAQ.md) for details. If you run into difficulties in the process of building the **AAPS** app, there is a dedicated [**troubleshooting Android Studio**](../Installing-AndroidAPS/troubleshooting_androidstudio) section, please consult that first. -If you think something in the building instructions is wrong, missing or confusing, or you are still struggling, please reach out to other **AAPS** users on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). If you want to change something yourself (updating screenshots _etc_), please submit a [pull request (PR)](../make-a-PR.md). +If you think something in the building instructions is wrong, missing or confusing, or you are still struggling, please reach out to other **AAPS** users group on [Facebook](https://www.facebook.com/groups/AndroidAPSUsers) or [Discord](https://discord.gg/4fQUWHZ4Mw). If you want to change something yourself (updating screenshots _etc_), please submit a [pull request (PR)](../make-a-PR.md). ## Step-by-step guide to building the AAPS app @@ -104,7 +102,7 @@ Git is a program that allows you to track changes in code and to collaborate wit ![Git_installed](../images/Building-the-App/001_check_git_installed.png) -2. If you don’t have Git installed, download and install the latest version for your system from [**here**](https://git-scm.com/downloads). Any recent Git version should work, select the correct version according to your system, either Mac, Windows and Linux. +2. If you don’t have Git installed, download and install the latest version for your system from the "Download" section on [**here**](https://git-scm.com/downloads). Any recent Git version should work, select the correct version according to your system, either Mac, Windows and Linux. **Note for Mac users:** the Git webpage will also guide you to install an additional program called "homebrew" to aid the installation. If you install Git via homebrew, there is no need to change any preferences. @@ -128,92 +126,74 @@ Git is a program that allows you to track changes in code and to collaborate wit Android Studio is a program which runs on your computer. It allows you to download source code from the internet (using Git) and build smartphone (and smartwatch) apps. You cannot "break" a current, looping version of **AAPS** which you might have running on a smartphone by building a new or updated app on your PC with Android Studio, these are totally separate processes. ``` -The following screenshots have been taken from Android Studio Version **Hedgehog**, they should be identical with more recent versions. - One of the most important things when installing Android Studio is **be patient!** During installation and setup, Android Studio is downloading a lot of stuff which will take time. -**Download a supported version of Android Studio (Hedgehog, Iguana, Jellyfish or Koala - not Ladybug)** from [**here**](https://developer.android.com/studio/archive), locate it in your browser downloads folder, and install it on your computer: - -![Download Android Studio](../images/Building-the-App/01_InstallAS_Hedgehog.png) - -When you first start Android Studio, you will be greeted as follows: - -![Welcome](../images/Building-the-App/02_Welcome_AS_Hedgehog.png) - -Select "Next": - -![ChooseASComponents](../images/Building-the-App/03_choose_AS_components.png) - -Leave the boxes checked, and select "Next": - -![ChooseASlocation](../images/Building-the-App/04_AS_Install_location.png) - -Allow the installation at the default location suggested, and select "Next": - - - -![SmartMenulocation](../images/Building-the-App/04_AS_StartMenu.png) - -When asked to choose the Smart Menu Folder, simply select "Install". You will now need to wait a few minutes while Android Studio is being installed. You should then see that the Installation is Complete, select "Next": +Any version of Android Studio like version Hedgehog or any newer is suitable. With version Ladybug, you might need to do one extra step, but it's doable! -![installationcomplete](../images/Building-the-App/06_Installation_Complete.png) +```{admonition} Different UI +:class: warning +Import note: Android Studio changed its UI during the last releases. This guide will show you the steps with the *new UI* in "Ladybug". If you still use the older UI, you might want to change Android Studio to the new UI first following [these instructions](NewUI). +``` -Now select "Finish": +Download the [current version of Android Studio](https://developer.android.com/studio) or an older version from the [**Archives**](https://developer.android.com/studio/archive) and accept the download agreements. -![closeASsetup](../images/Building-the-App/07_CloseAS_Setup.png) +![DownloadAndroidStudio](../images/Building-the-App/010_DownloadLadybug.png) -Android Studio will now start. +Once the download is finished, start the downloaded application to install it on your computer. +You might need to accept/confirm some warnings about downloaded apps from Windows! -If asked if you want to import settings, select "Do not import settings". We don't want to import settings from previous installations: +Install Android Studio by clicking "Next", as shown in the following screenshots. You do **not** need to change any settings! -![Do not import settings](../images/studioSetup/01_ImportSettings.png) +![Welcome_to_Android_Studio_Setup](../images/Building-the-App/011_InstallLadybug.png) -Decide whether you want to share data with Google or not (if unsure, just select "Don't send"). +![Choose_components](../images/Building-the-App/012_InstallLadybug.png) - ![Share data with Google](../images/Building-the-App/08_Googlesharedata.png) +![Configuration_Settings](../images/Building-the-App/013_InstallLadybug.png) +Now click on "Install": -You will now get a message about a missing software development kit (SDK) (don't worry, this will be solved soon), select "Next": +![Choose_start_Menu_Folder](../images/Building-the-App/014_InstallLadybug.png) +Once it's completed, press "Next" -![missingSDK](../images/Building-the-App/09_MissingSDK.png) +![Installation_Complete](../images/Building-the-App/015_InstallLadybug.png) -The software should autoselect the required (SDK) and choose a location. +In the last step, click on "Finished" to start Android Studio for the first time. -```{admonition} What is an Android SDK? -:class: dropdown +![Completing_Android_Studio_Setup](../images/Building-the-App/016_InstallLadybug.png) -In order to run **AAPS** on the phone the application needs to integrate with Android itself. Android provides “_software development kits_” (SDK) which allow apps like **AAPS** to interface with an Android operating system. -``` +You will be asked if you want to help improve Android Studio. Choose the option to your liking, it won't make any difference for the following steps. -The SDK platform package does **not** relate to the version of Android running on your phone, but to the build of **AAPS**. **AAPS** version 3.2 (and newer) builds on top of API level 34, which is automatically selected in the **Hedgehog** version of **Android Studio**. Therefore, simply click "Next": +![Help_improve_Android_Studio](../images/Building-the-App/020_ImproveAS.png) -![SDKcomponents_setup](../images/Building-the-App/10_SDKComponents_setup.png) +The welcome screen greets you to the installation of Android Studio. Press "Next". -When asked to verify settings, just select "Next": +![Welcome](../images/Building-the-App/022_WelcomeAndroidStudioInstallation.png) -![verify_settings](../images/Building-the-App/11_Verify_settings.png) +Select "Standard" as installation type. -When asked about the Licence Agreement, select "Accept" and then click "Finish": +![Install_Type](../images/Building-the-App/023_DefaultInstallation.png) -![licence_agreement](../images/Building-the-App/12_Licence_agreement.png) +Verify the settings by clicking "Next" again. +![Verify_Settigns](../images/Building-the-App/024_DefaultInstallation.png) -> **_Note:_** Depending on your set-up, the licenses to be accepted might vary from what is shown in the screenshot. +Now you need to accept the license agreements. You have two sections (1 + 3) on the left side which you have to select one after the other and each select "Accept" (2 + 4) on the right side. -Wait while Android Studio downloads additional components, this may take a few minutes: +Then the "Finish" (5) button can be clicked. -![downloading_components](../images/Building-the-App/13_downloading_components.png) +![License_Agreement](../images/Building-the-App/025_LicenseAgreement.png) +Some Android packages will now be downloaded and installed. Be patient and wait. -Once everything is downloaded, the "Finish" button turns blue, and you can click it: +When it's finished, you will find the following screen where you can select "Finish" again. +![Downloading_Components](../images/Building-the-App/026_DownloadFinished.png) -![finished_download_components](../images/Building-the-App/14_finished_downloading_components.png) +You will now see the Welcome screen of Android Studio. -You are now greeted with the "Welcome to Android Studio" screen. +![Welcome_to_Android_Studio](../images/Building-the-App/031_WelcomeAndroidStudio.png) -![Welcome_AS](../images/Building-the-App/15_Welcome_AS.png) (Building-APK-download-AAPS-code)= ### Download the AAPS code @@ -223,47 +203,42 @@ You are now greeted with the "Welcome to Android Studio" screen. The first time **AAPS** is downloaded, Android Studio will connect over the internet to the Github website to download the source code for **AAPS**. This should take about 1 minute. -Android Studio will then use **Gradle** (a development tool in Android studio) to identify other components needed to install these items on your computer. - +Android Studio will then use **Gradle** (a development tool for Android apps) to identify other components needed to build these items on your computer. ``` -On the Android Studio Welcome screen, check that "**Projects**" (1) is highlighted on the left. Then click "**Get from VCS**" (2) on the right: - -![Get_from_VCS](../images/Building-the-App/16_Get_from_VCS.png) - -* We will now tell Android Studio where to get the code from: +On the Android Studio Welcome screen, check that "**Projects**" (1) is highlighted on the left. -* "Repository URL" should be selected (by default) on the left (1). -* "Git" should be selected (by default) as version control (2). +Then click "**Get from VCS**" (2) on the right: +![Get_from_VCS](../images/Building-the-App/032_GetVCS.png) -Now copy this URL: +We will now tell Android Studio where to get the code from: -``` -https://github.com/nightscout/AndroidAPS.git -``` +![Get from Version Control](../images/Building-the-App/033_CloneGit.png) -and paste it into the URL textbox (3). +* "Repository URL" should be selected (by default) on the left (1). +* "Git" should be selected (by default) as version control (2). +* Now copy this URL: + ``` + https://github.com/nightscout/AndroidAPS.git + ``` + and paste it into the URL textbox (3). -* Check the (default) directory for saving the cloned code is sensible (4). +* Check the (default) directory for saving the cloned code exists on your computer and doesn't already exists (4). You can change it to some directoy, but please remember where you stored it! +* Now click the button "Clone" (5). ```{admonition} INFORMATION :class: information Make a note of the directory. It is where your sourcecode is stored! ``` -* Now click the button "Clone" (5). - -![Select_URL](../images/Building-the-App/17_select_URL.png) - - You will now see a screen telling you that the repository is being cloned: -![cloning_repository](../images/Building-the-App/18_cloning_repository.png) +![cloning_repository](../images/Building-the-App/034_CloningProgress.png) -At some point, you may be asked whether you want to trust the project. Click on "Trust project": +At some point, Android Studio will close and start again. You may be asked whether you want to trust the project. Click on "Trust project": - ![Trust project](../images/Building-the-App/18a_trust_project.png) + ![Trust project](../images/Building-the-App/035_TrustProject.png) Only for Windows users: If your firewall asks for permission, grant access: @@ -272,26 +247,24 @@ Only for Windows users: If your firewall asks for permission, grant access: After the repository is cloned successfully, Android Studio will open the cloned project. +(NewUI)= +```{admonition} New UI +:class: information +Android Studio changed its UI recently. New installations of Android Studio use the new UI by default! -Click on the cog top right and select "**Switch to Classic UI...**" to return to the view used in this documentation. - -If you do not see that cog, don't worry. You already use the classic UI! - -![Switch to Classic UI](../images/Building-the-App/OldUI.png) - -Restart Android Studio to make the changes effective. - -![Confirm restart of Android Studio](../images/Building-the-App/18b_ConfirmRestartUI.png) - -You might get one or both of the following warnings about running processes. It's save to abort them! +Only if your Android Studio looks different, you might need to switch to the new UI: +Click on the hamburger menu on the top left, then select **Settings** (or **Preferences** on Apple computers). +In **Appearance & Behaviour**, go to **New UI** and tick **Enable new UI**. Then restart Android Studio to start using it. -![Confirm abort background processes](../images/Building-the-App/18c_AbortBackgroundTasks.png) ![Confirm process AndroidAPS import](../images/Building-the-App/18d_AbortProcessImport.png) +If you don't find the option **New UI** don't worry: you are already using it! +``` -When Android Studio opened again, wait patiently (this may take a few minutes), and particularly, **do not** update the project as suggested in the pop-up. +When Android Studio opened, wait patiently (this may take a few minutes), and particularly, **do not** update the project as suggested in the pop-up. +Android Studio will start a "Gradle project sync" automatically, which will take a couple of minutes to finish. You can see it (still) running: -![AS_download_dependencies](../images/Building-the-App/19_downloading_dependencies.png) +![AS_download_dependencies](../images/Building-the-App/036_GradleSyncing.png) ```{admonition} NEVER UPDATE GRADLE! :class: warning @@ -299,52 +272,41 @@ When Android Studio opened again, wait patiently (this may take a few minutes), Android Studio might recommend updating the gradle system. **Never update gradle!** This will lead to difficulties. ``` -_Optional_ - If you want to clear the pop-up for **"project update recommended"**, click on the blue text "More" (1). In the dialog box the select "Don't ask for this project" (2). +Only on windows computers: You might get a notification about windows defender running: Click on **Automatically** and confirm, it will make the build run faster! +![Windows Defender](../images/Building-the-App/037_WindowsDefender.png) -![AS_close_gradle_popup](../images/Building-the-App/20_close_popup.png) - - -For Windows users only: -If you have not restarted your computer since installing or updating Git, close Android Studio now. Then restart your computer, and re-open Android Studio. +You can leave the gradle sync running and follow the next steps already. (Building-APK-set-git-path-in-preferences)= -### Set git path in Android Studio preferences +### Set Git path in Android Studio preferences Now we will tell Android studio where to find Git, which you installed [earlier](Install-Git). -* Windows users only: Make sure you have restarted your computer after [installing Git](Install-Git). -* Open **Android Studio** (you can find it by searching in the Start menu). -* In the top left corner of **Android Studio**, navigate to _File-Settings_ (Windows) or _Android Studio > Preferences_ (Mac). This opens the following window, click to expand the dropdown called "version control" (1): - -![version_control](../images/Building-the-App/21_AS_version_control.png) - - -* Now select "**Git**" (2). -* In the lower middle of the page, make sure update method "Merge" (3) is selected. -* Check if **Android Studio** can automatically locate the correct path to **git.exe** automatically by clicking the button "Test" (4): - -![Gitpath](../images/Building-the-App/22_Git_path.png) - -* If the automatic setting is successful, your current version of **Git** will be displayed next to the path. +* Windows users only: Make sure you have restarted your computer after [installing Git](Install-Git). If not, restart now and re-open Android Studio + +In the top left corner of **Android Studio**, open the hamburger menu and navigate to **File** > **Settings** (on Windows) or **Android Studio** > **Preferences** (on Mac). +This opens the following window, click to expand the dropdown called **Version Control** (1) and select **Git** - ![Git_version_displayed](../images/Building-the-App/23_Git__path_success.png) +![Version_control_Git](../images/Building-the-App/038_SettingsGit.png) +Check if **Android Studio** can automatically locate the correct **Path to Git executable** automatically by clicking the button "Test" (1): -* If you find that **git.exe** is not found automatically, or that clicking "Test" results in an error (1), you can either manually enter the path which you saved [earlier](Make_a_note_of_Git_path), or click on the folder icon (2) and manually navigating to the directory where **git.exe** is stored: +![Git Executable](../images/Building-the-App/039_GitTest.png) - ![Git not found](../images/studioSetup/13_GitVersionError.png) +If the automatic setting is successful, your current version of **Git** will be displayed next to the path. -* Use the [search function](https://www.tenforums.com/tutorials/94452-search-file-explorer-windows-10-a.html) in windows explorer to find "git.exe" if you are unsure where git has been installed. How to do this is explained [above](Make_a_note_of_Git_path) in more detail. + ![Git_version_displayed](../images/Building-the-App/039_GitTestSuccess.png) -* If you have manually selected it, check your selected Git path with the "Test" button as described above. -When the Git version is displayed next to the path (see screenshot above) you have completed this stage successfully and you can close the Android Studio "Settings" window by clicking the "**OK**" button (5): - - ![Git_path_OK](../images/Building-the-App/23a_Git_path_OK.png) +If you find that **git.exe** is not found automatically, or that clicking "Test" results in an error (1), you can either +* manually enter the path which you saved [earlier](Make_a_note_of_Git_path), or +* click on the folder icon (1) and manually navigating to the directory where **git.exe** was installed [earlier](Make_a_note_of_Git_path) +* Verify your settings with the **Test** button! + ![Git not found](../images/Building-the-App/039_GitTestError.png) (Building-APK-generate-signed-apk)= ### Build the AAPS "signed" APK @@ -352,110 +314,108 @@ When the Git version is displayed next to the path (see screenshot above) you ha ```{admonition} Why does the AAPS app need to be "signed"? :class: dropdown -Android requires each app to be _signed_, to ensure that it can only be updated later from the same trusted source that released the original app. For more information on this topic, follow [this link](https://developer.android.com/studio/publish/app-signing.html#generate-key). For our purposes, this just means that we generate a signing or "keystore" file and use it when we build the **AAPS** app. +Android requires each app to be _signed_, to ensure that it can only be updated later from the same trusted source that released the original app. For more information on this topic, follow [this link](https://developer.android.com/studio/publish/app-signing.html#generate-key). + +For our purposes, this just means that we generate a signing or "keystore" file and use it when we build the **AAPS** app. ``` -* In the menu bar, click "Build" (1), select "Generate Signed Bundle/APK (2) -![Build apk](../images/Building-the-App/25_build_apk.png) +**Important: Make sure the gradle sync is finished successfully before proceeding!** + + +Click the hamburger menu on the top left to open the menu bar. +Select **Build** (1), then select **Generate Signed App Bundle / APK** (2) -* Select "APK" instead of "Android App Bundle" and click "Next": +![Build apk](../images/Building-the-App/040_GenerateSignedAPK.png) -![APK instead of bundle](../images/Building-the-App/26_generate_APK.png) +Select "APK" instead of "Android App Bundle" and click "Next": -* In the next screen, make sure that "Module" is set to "AAPS.app" (1). +![APK instead of bundle](../images/Building-the-App/041_APK.png) + +In the next screen, make sure that "Module" is set to "AAPS.app" (1). (Building-APK-wearapk)= ```{admonition} INFORMATION! :class: information -If you want to create the apk for your watch, you need to select AAPS.wear! +If you want to create the apk for your watch, you now need to select AAPS.wear! ``` +![Create_key_store](../images/Building-the-App/042_CreateNewKey.png) -* Click "Create new..." (2) to start creating your key store. +Click "Create new..." (2) to start creating your key store. ```{admonition} INFORMATION! :class: information You will only need to create the keystore once. -If you have build AAPS before, do NOT create a new keystore but select your existing one! +If you have build AAPS before, do NOT create a new keystore but select your existing one and enter its passwords! ``` **_Note:_** The key store is a file in which the information for signing the app is stored. It is encrypted, and the information is secured with passwords. -![Create_key_store](../images/Building-the-App/27_new_keystore.png) - -* Click the "folder" symbol (1) to select a path on your computer for your key store: - -![Create key store](../images/Building-the-App/28_new_keystore_path.png) +![Create key store](../images/Building-the-App/043_Keystore.png) -* Click on the drop-down menu (1), to select where you want to save your keystore file. In this example, it is being saved in "My Documents" (2). Do not save the keystore in same folder as your Android Studio files (StudioProject). Type in a simple name for your key store (3) and confirm it with "OK" (4): +* Click the "folder" symbol (1) to select a path on your computer for your key store. -![Create key store](../images/Building-the-App/29_choose_keystore_file.png) - - -This will take you back to the previous screen. Your chosen location for saving the key store file is shown. + Do **not** use the directory where you stored your sourcecode but some directory that you would also transfer to a new computer. ```{admonition} WARNING! :class: warning Make sure to note down for yourself where your keystore is stored. You will need it when you build the next AndroidAPS update! ``` -Now choose a simple password (make a note of it), enter it in the password box (1), and confirm it (2). The passwords for key store and key do not have to be sophisticated. If you lose your password in the future, see [troubleshooting for lost key store](troubleshooting_androidstudio-lost-keystore). +* Now choose a simple password (and make a note of it), enter it in the password box (2), and confirm it (2). -The default alias (3) for your key is "key0", leave this unchanged. + The passwords for key store and key do not have to be sophisticated. If you lose your password in the future, see [troubleshooting for lost key store](troubleshooting_androidstudio-lost-keystore). -You now need a password for your key. To keep it simple, if you want, you can use the same password you used for your keystore, above. Enter a password (4) and confirm (5) it. +* The default alias (3) for your key is "key0", leave this unchanged. + +* You now need a password for your key. To keep it simple, if you want, you can use the same password you used for your keystore, above. Enter a password (4) and confirm it. ```{admonition} WARNING! :class: warning Note down these passwords! You will need them when you build the next AAPS update! ``` -The validity (6) is 25 years by default, leave it as it is. +* The validity is 25 years by default, leave it as it is. -Enter your first and last name (7). No other information needs to be added. +* Enter your first and last name (5). No other information needs to be added but you are free to do (6-7). -Click "OK" (8) to continue: +* Click "OK" (8) to continue: -![Select key store path](../images/Building-the-App/30_new_keystore.png) -On the "Generate signed bundle or APK" page, the path to your keystore will now be displayed. Now re-enter the Key Store password (1) and Key password (2), and tick the box to remember passwords is checked (3), so you don't have to enter them again next time you build the apk (i.e. when updating to a new AAPS version). Click "Next" (4): +On the **Generate signed App Bundle or APK** page, the path to your keystore will now be displayed. Now re-enter the Key Store password (1) and Key password (2), and tick the box (3) to remember passwords, so you don't have to enter them again next time you build the apk (i.e. when updating to a new AAPS version). Click "Next" (4): -![Remember passwords](../images/Building-the-App/31_generate_APK.png) +![Remember passwords](../images/Building-the-App/044_RememberPwd.png) -On the next screen, select build variant "fullRelease" (1) and click "Create" (2). +On the next screen, select build variant "fullRelease" (2) and click "Create" (3). You should remember the directory displayed at (1), as later you will find your built apk file there! - ![Select build variant](../images/Building-the-App/32_full_release.png) + ![Select build variant](../images/Building-the-App/045_BuildPath.png) -Android Studio will now build the **AAPS** apk. It will show "Gradle Build running" at the bottom right. The process takes some time, depending on your computer and internet connection, **be patient!** If you want to watch the progress of the build, click on the small hammer "build" at the bottom of Android Studio: +Android Studio will now build the **AAPS** apk. It will show "Gradle Build running" (2) at the bottom right. The process takes some time, depending on your computer and internet connection, so **be patient!** If you want to watch the progress of the build, click on the small hammer "build" (1) at the bottom of Android Studio: -![Gradle Running](../images/Building-the-App/33_Studio_building1.png) +![Gradle Running](../images/Building-the-App/046_BuildRunning.png) Now you can watch the building progress: -![Android_Studio_building](../images/Building-the-App/34_Studio_building2.png) - -Android Studio will display the information "BUILD SUCCESSFUL" after build is finished. You may see a popup notification which you can click to select "locate". If you miss this, click on the notification "locate or analyse the APK" (yellow highlight) at the very bottom of the screen to bring up the Notifications: +![Android_Studio_building](../images/Building-the-App/047_BuildDetails.png) -![Build finished](../images/Building-the-App/35_Studio__built_success.png) +Android Studio will display the information "BUILD SUCCESSFUL" after build is finished. You may see a popup notification which you can click to select "locate". If you miss this, click on the notification icon (1) and then on **locate** (2) at the very bottom of the screen to bring up the Notifications: +![Build finished](../images/Building-the-App/049_ReopenNotification.png) -_If the build was not successful, refer to the [troubleshooting section](../Installing-AndroidAPS/troubleshooting_androidstudio)._ +_If the build was not successful, refer to the [Android Studio Troubleshooting section](../Installing-AndroidAPS/troubleshooting_androidstudio)._ In the Notifications box, click on the blue link "locate": -![Locate build](../images/Building-the-App/35_Studio__built_locate.png) - Your file manager/explorer will open. Navigate to the directory "full" (1) > "release" (2). - - ![File location apk](../images/Building-the-App/36_locate_apk.png) - -Open the folder "release". The file "app-full-release.apk" (1) is the **AAPS** apk that you have just built, you will be transferring this file to your smartphone in the next section of the docs: - +![Locate build](../images/Building-the-App/048_BuildFinished.png) + Your file manager will open and show you the build apk file that you have just built. -![apk_file](../images/Building-the-App/37_full_release_apk.png) + ![File location apk](../images/Building-the-App/050_LocateAPK.png) + +Congratulations! Now you have built the **AAPS** apk file, you will be transferring this file to your smartphone in the next section of the docs. -Congratulations! Now you have built the **AAPS** apk file, you can move to the next stage of [Transferring and Installing **AAPS**](Transferring-and-installing-AAPS.md). +Move to the next stage of [Transferring and Installing **AAPS**](Transferring-and-installing-AAPS.md). diff --git a/docs/EN/Installing-AndroidAPS/troubleshooting_androidstudio.md b/docs/EN/Installing-AndroidAPS/troubleshooting_androidstudio.md index 6b00e572322d..4c111b8b46b9 100644 --- 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 new file mode 100644 index 000000000000..19a0b7316e63 Binary files /dev/null and b/docs/EN/images/Building-the-App/010_DownloadLadybug.png differ diff --git a/docs/EN/images/Building-the-App/011_InstallLadybug.png b/docs/EN/images/Building-the-App/011_InstallLadybug.png new file mode 100644 index 000000000000..8e8b1853edf8 Binary files /dev/null and b/docs/EN/images/Building-the-App/011_InstallLadybug.png differ diff --git a/docs/EN/images/Building-the-App/012_InstallLadybug.png b/docs/EN/images/Building-the-App/012_InstallLadybug.png new file mode 100644 index 000000000000..54cd496eb048 Binary files /dev/null and b/docs/EN/images/Building-the-App/012_InstallLadybug.png differ diff --git a/docs/EN/images/Building-the-App/013_InstallLadybug.png b/docs/EN/images/Building-the-App/013_InstallLadybug.png new file mode 100644 index 000000000000..11129ba18757 Binary files /dev/null and b/docs/EN/images/Building-the-App/013_InstallLadybug.png differ diff --git a/docs/EN/images/Building-the-App/014_InstallLadybug.png b/docs/EN/images/Building-the-App/014_InstallLadybug.png new file mode 100644 index 000000000000..bb6d29e5ef09 Binary files /dev/null and b/docs/EN/images/Building-the-App/014_InstallLadybug.png differ diff --git a/docs/EN/images/Building-the-App/015_InstallLadybug.png b/docs/EN/images/Building-the-App/015_InstallLadybug.png new file mode 100644 index 000000000000..a98b182203ad Binary files /dev/null and b/docs/EN/images/Building-the-App/015_InstallLadybug.png differ diff --git a/docs/EN/images/Building-the-App/016_InstallLadybug.png b/docs/EN/images/Building-the-App/016_InstallLadybug.png new file mode 100644 index 000000000000..b21fd7054edb Binary files /dev/null and b/docs/EN/images/Building-the-App/016_InstallLadybug.png differ diff --git a/docs/EN/images/Building-the-App/01_InstallAS_Hedgehog.png b/docs/EN/images/Building-the-App/01_InstallAS_Hedgehog.png deleted file mode 100644 index e66015bfbaa4..000000000000 Binary files a/docs/EN/images/Building-the-App/01_InstallAS_Hedgehog.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/020_ImproveAS.png b/docs/EN/images/Building-the-App/020_ImproveAS.png new file mode 100644 index 000000000000..70d3d6fcbf1d Binary files /dev/null and b/docs/EN/images/Building-the-App/020_ImproveAS.png differ diff --git a/docs/EN/images/Building-the-App/022_WelcomeAndroidStudioInstallation.png b/docs/EN/images/Building-the-App/022_WelcomeAndroidStudioInstallation.png new file mode 100644 index 000000000000..ec5aa6e2586e Binary files /dev/null and b/docs/EN/images/Building-the-App/022_WelcomeAndroidStudioInstallation.png differ diff --git a/docs/EN/images/Building-the-App/023_DefaultInstallation.png b/docs/EN/images/Building-the-App/023_DefaultInstallation.png new file mode 100644 index 000000000000..0c91a014b2be Binary files /dev/null and b/docs/EN/images/Building-the-App/023_DefaultInstallation.png differ diff --git a/docs/EN/images/Building-the-App/024_DefaultInstallation.png b/docs/EN/images/Building-the-App/024_DefaultInstallation.png new file mode 100644 index 000000000000..91def435f30a Binary files /dev/null and b/docs/EN/images/Building-the-App/024_DefaultInstallation.png differ diff --git a/docs/EN/images/Building-the-App/025_LicenseAgreement.png b/docs/EN/images/Building-the-App/025_LicenseAgreement.png new file mode 100644 index 000000000000..4ff3292c383d Binary files /dev/null and b/docs/EN/images/Building-the-App/025_LicenseAgreement.png differ diff --git a/docs/EN/images/Building-the-App/026_DownloadFinished.png b/docs/EN/images/Building-the-App/026_DownloadFinished.png new file mode 100644 index 000000000000..5d5b447e30f0 Binary files /dev/null and b/docs/EN/images/Building-the-App/026_DownloadFinished.png differ 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 deleted file mode 100644 index 759d6d98c3c7..000000000000 Binary files a/docs/EN/images/Building-the-App/02_Welcome_AS_Hedgehog.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/031_WelcomeAndroidStudio.png b/docs/EN/images/Building-the-App/031_WelcomeAndroidStudio.png new file mode 100644 index 000000000000..5d99e995f3d3 Binary files /dev/null and b/docs/EN/images/Building-the-App/031_WelcomeAndroidStudio.png differ diff --git a/docs/EN/images/Building-the-App/032_GetVCS.png b/docs/EN/images/Building-the-App/032_GetVCS.png new file mode 100644 index 000000000000..b17883b552f5 Binary files /dev/null and b/docs/EN/images/Building-the-App/032_GetVCS.png differ diff --git a/docs/EN/images/Building-the-App/033_CloneGit.png b/docs/EN/images/Building-the-App/033_CloneGit.png new file mode 100644 index 000000000000..71b5856d43c0 Binary files /dev/null and b/docs/EN/images/Building-the-App/033_CloneGit.png differ diff --git a/docs/EN/images/Building-the-App/034_CloningProgress.png b/docs/EN/images/Building-the-App/034_CloningProgress.png new file mode 100644 index 000000000000..4021e30499ae Binary files /dev/null and b/docs/EN/images/Building-the-App/034_CloningProgress.png differ diff --git a/docs/EN/images/Building-the-App/035_TrustProject.png b/docs/EN/images/Building-the-App/035_TrustProject.png new file mode 100644 index 000000000000..83c228db46a6 Binary files /dev/null and b/docs/EN/images/Building-the-App/035_TrustProject.png differ diff --git a/docs/EN/images/Building-the-App/036_GradleSyncing.png b/docs/EN/images/Building-the-App/036_GradleSyncing.png new file mode 100644 index 000000000000..54c8bc998b9d Binary files /dev/null and b/docs/EN/images/Building-the-App/036_GradleSyncing.png differ diff --git a/docs/EN/images/Building-the-App/037_WindowsDefender.png b/docs/EN/images/Building-the-App/037_WindowsDefender.png new file mode 100644 index 000000000000..2a10cc2bea31 Binary files /dev/null and b/docs/EN/images/Building-the-App/037_WindowsDefender.png differ diff --git a/docs/EN/images/Building-the-App/038_SettingsGit.png b/docs/EN/images/Building-the-App/038_SettingsGit.png new file mode 100644 index 000000000000..d16de9b7445a Binary files /dev/null and b/docs/EN/images/Building-the-App/038_SettingsGit.png differ diff --git a/docs/EN/images/Building-the-App/039_GitTest.png b/docs/EN/images/Building-the-App/039_GitTest.png new file mode 100644 index 000000000000..d6d8d0eab8c1 Binary files /dev/null and b/docs/EN/images/Building-the-App/039_GitTest.png differ diff --git a/docs/EN/images/Building-the-App/039_GitTestError.png b/docs/EN/images/Building-the-App/039_GitTestError.png new file mode 100644 index 000000000000..d78c7c634394 Binary files /dev/null and b/docs/EN/images/Building-the-App/039_GitTestError.png differ diff --git a/docs/EN/images/Building-the-App/039_GitTestSuccess.png b/docs/EN/images/Building-the-App/039_GitTestSuccess.png new file mode 100644 index 000000000000..e47dd552e799 Binary files /dev/null and b/docs/EN/images/Building-the-App/039_GitTestSuccess.png differ 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 deleted file mode 100644 index 350c68731860..000000000000 Binary files a/docs/EN/images/Building-the-App/03_choose_AS_components.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/040_GenerateSignedAPK.png b/docs/EN/images/Building-the-App/040_GenerateSignedAPK.png new file mode 100644 index 000000000000..65ae405b51b7 Binary files /dev/null and b/docs/EN/images/Building-the-App/040_GenerateSignedAPK.png differ diff --git a/docs/EN/images/Building-the-App/041_APK.png b/docs/EN/images/Building-the-App/041_APK.png new file mode 100644 index 000000000000..28425e884eef Binary files /dev/null and b/docs/EN/images/Building-the-App/041_APK.png differ diff --git a/docs/EN/images/Building-the-App/042_CreateNewKey.png b/docs/EN/images/Building-the-App/042_CreateNewKey.png new file mode 100644 index 000000000000..44da4858e3cb Binary files /dev/null and b/docs/EN/images/Building-the-App/042_CreateNewKey.png differ diff --git a/docs/EN/images/Building-the-App/043_Keystore.png b/docs/EN/images/Building-the-App/043_Keystore.png new file mode 100644 index 000000000000..d2382c30f073 Binary files /dev/null and b/docs/EN/images/Building-the-App/043_Keystore.png differ diff --git a/docs/EN/images/Building-the-App/044_RememberPwd.png b/docs/EN/images/Building-the-App/044_RememberPwd.png new file mode 100644 index 000000000000..47fb8a48575b Binary files /dev/null and b/docs/EN/images/Building-the-App/044_RememberPwd.png differ diff --git a/docs/EN/images/Building-the-App/045_BuildPath.png b/docs/EN/images/Building-the-App/045_BuildPath.png new file mode 100644 index 000000000000..4804c69a280f Binary files /dev/null and b/docs/EN/images/Building-the-App/045_BuildPath.png differ diff --git a/docs/EN/images/Building-the-App/046_BuildRunning.png b/docs/EN/images/Building-the-App/046_BuildRunning.png new file mode 100644 index 000000000000..a29d791ebbd7 Binary files /dev/null and b/docs/EN/images/Building-the-App/046_BuildRunning.png differ diff --git a/docs/EN/images/Building-the-App/047_BuildDetails.png b/docs/EN/images/Building-the-App/047_BuildDetails.png new file mode 100644 index 000000000000..3aab71c23c8e Binary files /dev/null and b/docs/EN/images/Building-the-App/047_BuildDetails.png differ diff --git a/docs/EN/images/Building-the-App/048_BuildFinished.png b/docs/EN/images/Building-the-App/048_BuildFinished.png new file mode 100644 index 000000000000..5f871b197ad3 Binary files /dev/null and b/docs/EN/images/Building-the-App/048_BuildFinished.png differ diff --git a/docs/EN/images/Building-the-App/049_ReopenNotification.png b/docs/EN/images/Building-the-App/049_ReopenNotification.png new file mode 100644 index 000000000000..6c9f27181022 Binary files /dev/null and b/docs/EN/images/Building-the-App/049_ReopenNotification.png differ 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 deleted file mode 100644 index 634f1dc97f4b..000000000000 Binary files a/docs/EN/images/Building-the-App/04_AS_Install_location.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/04_AS_StartMenu.png b/docs/EN/images/Building-the-App/04_AS_StartMenu.png deleted file mode 100644 index 37595ae73514..000000000000 Binary files a/docs/EN/images/Building-the-App/04_AS_StartMenu.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/050_LocateAPK.png b/docs/EN/images/Building-the-App/050_LocateAPK.png new file mode 100644 index 000000000000..d4bc1589b92b Binary files /dev/null and b/docs/EN/images/Building-the-App/050_LocateAPK.png differ diff --git a/docs/EN/images/Building-the-App/06_Installation_Complete.png b/docs/EN/images/Building-the-App/06_Installation_Complete.png deleted file mode 100644 index d6fd611f75ae..000000000000 Binary files a/docs/EN/images/Building-the-App/06_Installation_Complete.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/07_CloseAS_Setup.png b/docs/EN/images/Building-the-App/07_CloseAS_Setup.png deleted file mode 100644 index 1e58caa4d64e..000000000000 Binary files a/docs/EN/images/Building-the-App/07_CloseAS_Setup.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/08_Googlesharedata.png b/docs/EN/images/Building-the-App/08_Googlesharedata.png deleted file mode 100644 index 3e4047650857..000000000000 Binary files a/docs/EN/images/Building-the-App/08_Googlesharedata.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/09_MissingSDK.png b/docs/EN/images/Building-the-App/09_MissingSDK.png deleted file mode 100644 index ee1f5a23f144..000000000000 Binary files a/docs/EN/images/Building-the-App/09_MissingSDK.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/10_SDKComponents_setup.png b/docs/EN/images/Building-the-App/10_SDKComponents_setup.png deleted file mode 100644 index 2eb6aeeece0d..000000000000 Binary files a/docs/EN/images/Building-the-App/10_SDKComponents_setup.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/11_Verify_settings.png b/docs/EN/images/Building-the-App/11_Verify_settings.png deleted file mode 100644 index d50cd648cb53..000000000000 Binary files a/docs/EN/images/Building-the-App/11_Verify_settings.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/12_Licence_agreement.png b/docs/EN/images/Building-the-App/12_Licence_agreement.png deleted file mode 100644 index 35b105b58494..000000000000 Binary files a/docs/EN/images/Building-the-App/12_Licence_agreement.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/13_downloading_components.png b/docs/EN/images/Building-the-App/13_downloading_components.png deleted file mode 100644 index 08ce11d0eea0..000000000000 Binary files a/docs/EN/images/Building-the-App/13_downloading_components.png and /dev/null differ 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 deleted file mode 100644 index c5ddab37e76b..000000000000 Binary files a/docs/EN/images/Building-the-App/14_finished_downloading_components.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/15_Welcome_AS.png b/docs/EN/images/Building-the-App/15_Welcome_AS.png deleted file mode 100644 index f9474db0d7ec..000000000000 Binary files a/docs/EN/images/Building-the-App/15_Welcome_AS.png and /dev/null differ 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 deleted file mode 100644 index b4fb05cdc73b..000000000000 Binary files a/docs/EN/images/Building-the-App/16_Get_from_VCS.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/17_select_URL.png b/docs/EN/images/Building-the-App/17_select_URL.png deleted file mode 100644 index 0185476f5961..000000000000 Binary files a/docs/EN/images/Building-the-App/17_select_URL.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/18_cloning_repository.png b/docs/EN/images/Building-the-App/18_cloning_repository.png deleted file mode 100644 index df59ea0a7495..000000000000 Binary files a/docs/EN/images/Building-the-App/18_cloning_repository.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/18a_trust_project.png b/docs/EN/images/Building-the-App/18a_trust_project.png deleted file mode 100644 index c7c7711ec9bd..000000000000 Binary files a/docs/EN/images/Building-the-App/18a_trust_project.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/18b_ConfirmRestartUI.png b/docs/EN/images/Building-the-App/18b_ConfirmRestartUI.png deleted file mode 100644 index ba678767ceb0..000000000000 Binary files a/docs/EN/images/Building-the-App/18b_ConfirmRestartUI.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/18c_AbortBackgroundTasks.png b/docs/EN/images/Building-the-App/18c_AbortBackgroundTasks.png deleted file mode 100644 index d30f7ddf6869..000000000000 Binary files a/docs/EN/images/Building-the-App/18c_AbortBackgroundTasks.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/18d_AbortProcessImport.png b/docs/EN/images/Building-the-App/18d_AbortProcessImport.png deleted file mode 100644 index ca857a882990..000000000000 Binary files a/docs/EN/images/Building-the-App/18d_AbortProcessImport.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/19_downloading_dependencies.png b/docs/EN/images/Building-the-App/19_downloading_dependencies.png deleted file mode 100644 index bedad96b1dfb..000000000000 Binary files a/docs/EN/images/Building-the-App/19_downloading_dependencies.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/20_close_popup.png b/docs/EN/images/Building-the-App/20_close_popup.png deleted file mode 100644 index 3df3047db728..000000000000 Binary files a/docs/EN/images/Building-the-App/20_close_popup.png and /dev/null differ 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 deleted file mode 100644 index ad0aea266c80..000000000000 Binary files a/docs/EN/images/Building-the-App/21_AS_version_control.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/22_Git_path.png b/docs/EN/images/Building-the-App/22_Git_path.png deleted file mode 100644 index 696c683f680f..000000000000 Binary files a/docs/EN/images/Building-the-App/22_Git_path.png and /dev/null differ 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 deleted file mode 100644 index 6b986c1b787f..000000000000 Binary files a/docs/EN/images/Building-the-App/23_Git__path_success.png and /dev/null differ 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 deleted file mode 100644 index 577334ba0067..000000000000 Binary files a/docs/EN/images/Building-the-App/23a_Git_path_OK.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/25_build_apk.png b/docs/EN/images/Building-the-App/25_build_apk.png deleted file mode 100644 index 42369819a2c1..000000000000 Binary files a/docs/EN/images/Building-the-App/25_build_apk.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/26_generate_APK.png b/docs/EN/images/Building-the-App/26_generate_APK.png deleted file mode 100644 index b83676ad62fc..000000000000 Binary files a/docs/EN/images/Building-the-App/26_generate_APK.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/27_new_keystore.png b/docs/EN/images/Building-the-App/27_new_keystore.png deleted file mode 100644 index 60878835370d..000000000000 Binary files a/docs/EN/images/Building-the-App/27_new_keystore.png and /dev/null differ 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 deleted file mode 100644 index 9fe9ee46af56..000000000000 Binary files a/docs/EN/images/Building-the-App/28_new_keystore_path.png and /dev/null differ 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 deleted file mode 100644 index dc1f98a7d291..000000000000 Binary files a/docs/EN/images/Building-the-App/29_choose_keystore_file.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/30_new_keystore.png b/docs/EN/images/Building-the-App/30_new_keystore.png deleted file mode 100644 index 82973f21e4c6..000000000000 Binary files a/docs/EN/images/Building-the-App/30_new_keystore.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/31_generate_APK.png b/docs/EN/images/Building-the-App/31_generate_APK.png deleted file mode 100644 index 89146c0031ba..000000000000 Binary files a/docs/EN/images/Building-the-App/31_generate_APK.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/32_full_release.png b/docs/EN/images/Building-the-App/32_full_release.png deleted file mode 100644 index 81353f7bf45c..000000000000 Binary files a/docs/EN/images/Building-the-App/32_full_release.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/33_Studio_building1.png b/docs/EN/images/Building-the-App/33_Studio_building1.png deleted file mode 100644 index 82c9fefe67d2..000000000000 Binary files a/docs/EN/images/Building-the-App/33_Studio_building1.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/34_Studio_building2.png b/docs/EN/images/Building-the-App/34_Studio_building2.png deleted file mode 100644 index c3cfe0bf50a5..000000000000 Binary files a/docs/EN/images/Building-the-App/34_Studio_building2.png and /dev/null differ 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 deleted file mode 100644 index d9f47f5318b4..000000000000 Binary files a/docs/EN/images/Building-the-App/35_Studio__built_locate.png and /dev/null differ 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 deleted file mode 100644 index 3493926f4b38..000000000000 Binary files a/docs/EN/images/Building-the-App/35_Studio__built_success.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/36_locate_apk.png b/docs/EN/images/Building-the-App/36_locate_apk.png deleted file mode 100644 index 8b19bc2008c4..000000000000 Binary files a/docs/EN/images/Building-the-App/36_locate_apk.png and /dev/null differ 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 deleted file mode 100644 index 044a888c9dc2..000000000000 Binary files a/docs/EN/images/Building-the-App/37_full_release_apk.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/OldUI.png b/docs/EN/images/Building-the-App/OldUI.png deleted file mode 100644 index c4f240a4b76f..000000000000 Binary files a/docs/EN/images/Building-the-App/OldUI.png and /dev/null differ diff --git a/docs/EN/images/Building-the-App/trustProject.png b/docs/EN/images/Building-the-App/trustProject.png new file mode 100644 index 000000000000..462c6a00c348 Binary files /dev/null and b/docs/EN/images/Building-the-App/trustProject.png differ diff --git a/docs/EN/images/studioTroubleshooting/160_InkompatibelAndroidGradleJVM.png b/docs/EN/images/studioTroubleshooting/160_InkompatibelAndroidGradleJVM.png new file mode 100644 index 000000000000..0448795dcbea Binary files /dev/null and b/docs/EN/images/studioTroubleshooting/160_InkompatibelAndroidGradleJVM.png differ diff --git a/docs/EN/images/studioTroubleshooting/161_GradleSettings.png b/docs/EN/images/studioTroubleshooting/161_GradleSettings.png new file mode 100644 index 000000000000..571d869a7a4e Binary files /dev/null and b/docs/EN/images/studioTroubleshooting/161_GradleSettings.png differ diff --git a/docs/EN/images/studioTroubleshooting/162_DownloadJDK.png b/docs/EN/images/studioTroubleshooting/162_DownloadJDK.png new file mode 100644 index 000000000000..e6e988f456fc Binary files /dev/null and b/docs/EN/images/studioTroubleshooting/162_DownloadJDK.png differ diff --git a/docs/EN/images/studioTroubleshooting/163_JDKSelection.png b/docs/EN/images/studioTroubleshooting/163_JDKSelection.png new file mode 100644 index 000000000000..126434bc9484 Binary files /dev/null and b/docs/EN/images/studioTroubleshooting/163_JDKSelection.png differ
OS (Only 64 bit)Windows 8 or higherMac OS 10.14 or higherAny Linux supports Gnome, KDE, or Unity DE;  GNU C Library 2.31 or laterWindows 8 or higherMac OS 10.14 or higherAny Linux supports Gnome, KDE, or Unity DE;  GNU C Library 2.31 or later

CPU (Only 64 bit)

CPU (Only 64 bit)

 x86_64 CPU architecture; 2nd generation Intel Core or newer, or AMD CPU with support for a
Windows Hypervisor		 ARM-based chips, or 2nd generation Intel Core or newer with support for
Hypervisor.Framework		 x86_64 CPU architecture; 2nd generation Intel Core or newer, or AMD processor with support for AMD Virtualization (AMD-V) and SSSE3

RAM

RAM

8GB or more

Disk

Disk

At least 30GB free space. SSD is recommended.

Resolution

Resolution

1280 x 800 Minimum

Internet

Internet

Broadband