Learn how to configure Android development tools using External Tools window.
The Android section in External Tools panel allows you to configure Android development tools used to set up Unity projects. To access this section, go to Edit > Preferences (macOS: Unity > Settings) and then navigate to External Tools > Android.
Use the following settings to configure Android development tools for your project.
Setting | Description |
---|---|
JDK installed with Unity(recommended) | Indicates whether to use the recommended version of Java Development Kit (JDK) installed with Unity or the custom JDK installation. If enabled, the setting displays the path to the JDK installation folder. To use the custom JDK version, disable this option and select Browse to set the custom JDK installation folder path. |
Android SDK tools installed with Unity(recommended) | Indicates whether to use the recommended versions of Android SDK tools installed with Unity or the custom SDK tools installation. If enabled, the setting displays the path to the SDK tools installation folder. To use the custom SDK tools version, disable this option and select Browse to set the custom SDK tools installation folder path. |
Android NDK installed with Unity(recommended) | Indicates whether to use the recommended version of Android Native Development Kit (NDK) installed with Unity or the custom NDK installation. If enabled, the setting displays the path to the NDK installation folder. To use the custom NDK version, disable this option and select Browse to set the custom NDK installation folder path. |
GradleAn Android build system that automates several build processes. This automation means that many common build errors are less likely to occur. More info See in Glossary installed with Unity(recommended) |
Indicates whether to use the recommended version of Android Gradle installed with Unity or the custom Gradle installation. If enabled, the setting displays the path to the Gradle installation folder. To use the custom Gradle version, disable this option and select Browse to set the custom Gradle installation folder path. |
Stop Gradle daemons on exit | Indicates whether to stop Gradle daemons when the Unity Editor exits. This option is enabled by default and it might help to free up resources on your computer. |
User Home | Specifies the path to the Gradle User Home directory. If no path is specified, the Gradle User Home directory is located in the .gradle folder of your system’s home directory. For example, /home/USERNAME/.gradle on macOS or C:\Users\USERNAME\.gradle on Windows. If your username contains non-ASCII characters that Gradle might not process correctly, specify a custom location for your Gradle User Home directory instead of changing your username. |
Kill ADBAn Android Debug Bridge (ADB). You can use an ADB to deploy an Android package (APK) manually after building. More info See in Glossary server on exit |
Indicates whether to terminate Android Debug Bridge (adb) server when the Unity Editor exits. This option is enabled by default and it might help to free up resources on your computer. |
Kill external ADB instances | Indicates whether to terminate external Android Debug Bridge (ADB) instances. These are separate instances that don’t belong to the Android SDK set from Android SDK tools installed with Unity(recommended) . Multiple ADB instances can conflict with each other and might cause issues when using the Android SDK. For example, when updating the API or during application launches. Note: This option is enabled by default to prevent collision between different ADB instances. |
Maximum JVM heap size, Mbyte | Specifies the maximum Java heap size that can be allocated during the Android build process. The value is specified in megabytes and the default value is 4096. You can increase or decrease this value based on your project requirement. Increase this value if you experience heap space errors. |
Keystores Dedicated Location | Specifies the folder path to your Android keystoresAn Android system that lets you store cryptographic key entries for enhanced device security. More info See in Glossary. Unity uses this path when signing your Android application during the build process. To set a new path for your application, select Browse and navigate to the folder where you want to store your Android keystores. For more information, refer to Choose the keystore location. |
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.