Exporting a project to Gradle and building/deploying on Android Studio



  • I want to export my project via Gradle and use Android Studio to build it.


Reasons you might want to do this include:

  • You want to make modifications to the application in Android Studio before building it.
  • You want full control over the build process.


You need to have your Android developer environment set up before you can build your Unity application in Android Studio. This involves downloading and installing Android Studio, which also installs the Android SDK. Download Android Studio from the Android Studio website.

Next, you need to add the Android SDK path to Unity. See Unity documentation on Android SDK/NDK setup for steps on how to do this.

Once you have your Android developer environment set up you can open your Unity Project. Note that you need to set a valid bundle identifier to be able to export an Android Project. To set this, go to Player Settings (menu: Edit > Project Settings > Player), navigate to Other Settings, and under Identification use the Package Name field.

Go to Build Settings and make sure Android is selected as the target platform. Change the Build System to Gradle, and tick the Export Project checkbox, as shown in the picture below.


You can now export your project using the Export button. Select a folder to export your project to. 

Assuming there are no build errors, you now have a Gradle project located in the specified folder. You can open this with Android Studio. To do this, open Android Studio and select Import Projectthen navigate to the folder that contains your Gradle folder. If you’re asked to select whether to use a Gradle wrapper, select OK. Later, you need to override the Gradle distribution that it downloads (this is to workaround a bug in Android Studio, where it believes Unity's Gradle version is invalid).

Once the project has finished importing, go to Android Studio’s preferences and search for Gradle. From here you can select a specific Gradle version for your project. Select Use local Gradle distribution, then navigate to Unity’s Gradle installation, located at:

OSX: <Unity installation folder>/PlaybackEngines/AndroidPlayer/Tools/gradle

Windows: <Unity installation folder>/Editor/Data/PlaybackEngines/AndroidPlayer/Tools/gradle


Click Apply, and wait for your project to perform another Gradle sync. After this is finished, you can make your changes to the Android Studio project.

To build with Android Studio, go to Run > Edit Configurations. Create a new Gradle configuration with the plus (+) icon. To select a Gradle project, click the folder icon. In Tasks enter build, as shown below. Then apply your changes and click Run > Run <Name of your config>.


More Information

Was this article helpful?
1 out of 2 found this helpful
Have more questions? Submit a request


  • 0
    Daniel Jooryabi

    On windows 10 with Unity 2017.4.0f1 there is no need to specify the unity gradle directory when importing the Unity project into android studio. When android studio prompts for a gradle directory just say cancel and it builds fine. Android studio might prompt for the gradle directory again after it completes the build and you should just select cancel again.

  • 0
    Laynor Alberto Solenzal Milián

    Tengo un problema con Unity 2018.3.10f1 (64-bit) Me aparece el siguiente mensaje: "Failed getting available Android API levels. Make sure your android sdk tools version is 25 or higher and you have internet connection".

    Son un cliente de Unity Plus desde el año pasado, y hasta ahora no he podido compilar mi proyecto de Unity para Android. Necesito Ayuda.

  • 0
    Cagatay Oezbay

    No build system (gradle) available "Unity 2019.1.4f1". Why is that?

  • 0
    Ori Weisblum

    Thanks! It's really helpful.

Please sign in to leave a comment.