Troubleshooting Android Studio
If you use the same keystore when updating AAPS you do not have to uninstall the previous version on your smartphone. That’s why it is recommended to store the keystore in a save place.
If you try to install the apk, signed with a different keystore than before, you will get an error message that the installation failed!
In case you cannot find your old keystore or its password anymore, proceed as follows:
Export settings on your phone.
Copy or upload the settings file from your phone to an external location (i.e. your computer, cloud storage service…).
Generate signed apk of new version as described on the Update guide and transfer it to your phone.
Uninstall previous AAPS version on your phone.
Install new AAPS version on your phone.
Import settings to restore your objectives and configuration.
If you can’t find them on your phone copy them from the external storage to your phone.
Check your battery optimization options and disable them again.
Keep on looping.
Gradle Sync failed
Gradle Sync can fail to various reasons. Wen you get a message saying that gradle sync failed, open the „Build“ tab (1) at the bottom of Android Studio and check what error message (2) is displayed.
These are the usual gradle sync failures:
Important: After you have followed the instructions for your specific problem, you need to trigger the gradle sync again.
If you receive a failure message like
Step 1 - Check git installation
Open the terminal tab (1) at the bottom of Android Studio and copy the following text and paste or type into the terminal.
Note: There is a space and two hyphens between git and version!
You must receive a message saying what git version is installed, as you can see in the screenshot above. In this case, go to Step 2.
In case you get an message saying
Git: command not found
your Git installation is not right.
if on Windows and git was just installed, you should restart your computer to make git globally available after the installation
If Git is installed, you have restarted (if on windows), and git still couldn’t found:
Search your computer for a file „git.exe“.
Note for yourself, what directory it is in.
Go to the Environment variables in windows, select the variable „PATH“ and click edit. Add the directory where you have found your git installation.
Save and close.
Restart Android Studio.
Step 2: Check for uncommitted changes.
In Android Studio, oben the „Commit“ Tab (1) on the left-hand side.
You can see either a „Default changeset“ (2) or „Unversioned files“ (3):
For „Default changeset“, you probably updated gradle or changed some of the file contents by mistake.
Right click on „Default Changeset“ and select „Rollback“
The files are fetched again from the Git server. If there are no other changes in the commit tab, go to Step 3.
If you can see „Unversioned Files“, you might have stored files in your sourecode directory which should be better places somewhere else, e.g. your keystore file.
Use your regular file explorer on your computer to move or cut and paste that file to a save place.
Go back to Android Studio and click the Refresh button (4) within the Commit tab to make sure the file is not stored in the AAPS directory anymore.
If there are no other changes in the commit tab, go to Step 3.
Step 3: Resync Gradle (again)
Follow the instructions at Gradle Resync.
Incompatible version of Android Gradle plugin
If you experience the following error message
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:
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).
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.
Press „OK“ to save and close the settings dialog.
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.
Now you need to trigger a Gradle Resync
Could not resolve/No cached version
You might get this error message:
![Could not resolve... No cached version](../images/studioTroubleshooting/08_NoCachedVersion.png)
On the right side, open the Gradle tab (1).
Make sure the button shown at (2) is NOT selected.
Now you need to trigger a Gradle Resync
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.
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.
If you can still see the message that the gradle sync failed, now select the Link „Try again“.
If you don’t see the a message anymore, you can still trigger this manually:
Open the Gradle tab (1) on the right border of Android Studio.
Right-click on AAPS (2)
Click on „Reload Gradle Project“ (3)
Generate Signed APK generated successfully with 0 build variants
When you generate the signed apk, you might get the notification that generation was successfully but are told that 0 build variants where generated:
This is a false warning. Check the directory your selected as „Destination folder“ for generation (step Generate Signed APK) and you will find the generated apk there!
App was created with compiler/kotlin warnings
If your build completed successfully but you get compiler or kotlin warnings (indicated by a yellow or blue exclamation mark) then you can just ignore these warnings.
Your app was build successfully and can be transferred to phone!
Key was created with errors
When creating a new keystore for building the signed APK, on Windows the following error message might appear
This seems to be a bug with Android Studio 3.5.1 and its shipped Java environment in Windows. The key is created correctly but a recommendation is falsely displayed as an error. This can currently be ignored.
No CGM data is received by AAPS
App not installed
Make sure you have transferred the “app-full-release.apk” file to your phone.
If „App not installed“ is displayed on your phone follow these steps:
App installed but old version
If you built the app successfully, transferred it to your phone and installed it successfully but the version number stays the same then you might have missed to update your local copy
None of the above worked
If non of the above tips helped you might consider building the app from scratch:
Export settings (in AAPS version already installed on your phone)
Have your key password and key store password ready. In case you have forgotten passwords you can try to find them in project files as described here.
Or you just use a new keystore.
Build app from scratch as described here.
When you have build the APK successfully delete the exiting app on your phone, transfer the new apk to your phone and install.
Import settings again to restore your objectives and settings.
You should check your battery optimization options and disable them again.
Worst case scenario
In case even building the app from scratch does not solve your problem you might want to try to uninstall Android Studio completely. Some Users reported that this solved their problem.
Make sure to uninstall all files associated with Android Studio. If you do not completely remove Android Studio with all hidden files, uninstalling may cause new problems instead of solving your existing one(s). Manuals for complete uninstall can be found online i.e.
Install Android Studio from scratch as described here.