- 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.
It is best practice to have your Android developer environment set up before building your Unity application in Android Studio.
This involves downloading and installing Android Studio, which also installs the Android SDK. You can download Android Studio from the Android Studio website.
Once you have downloaded Android Studio, 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.
Important: 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 and tick the Export Project checkbox, as shown below:
You can now export your project using the Export button and choose 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 open your Grandle project with Android Studio, open Android Studio and select Import Project, then navigate to the folder that contains your Gradle folder. If you're asked to choose whether to use a Gradle wrapper, select OK. Later, you need to override the Gradle distribution that it downloads (this is to work around 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>.