https://github.com/gilzoide/unity-gradle-wrapper
Automatically generate Gradle Wrapper (gradlew) when exporting Android projects in Unity
https://github.com/gilzoide/unity-gradle-wrapper
android android-project build gradle-wrapper unity
Last synced: 11 months ago
JSON representation
Automatically generate Gradle Wrapper (gradlew) when exporting Android projects in Unity
- Host: GitHub
- URL: https://github.com/gilzoide/unity-gradle-wrapper
- Owner: gilzoide
- License: unlicense
- Created: 2022-06-19T18:23:59.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-19T19:44:43.000Z (about 1 year ago)
- Last Synced: 2025-04-19T21:33:23.634Z (about 1 year ago)
- Topics: android, android-project, build, gradle-wrapper, unity
- Language: C#
- Homepage:
- Size: 37.1 KB
- Stars: 47
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Gradle Wrapper Generator
[](https://openupm.com/packages/com.gilzoide.gradle-wrapper/)
Automatically generate a [Gradle Wrapper (gradlew)](https://docs.gradle.org/current/userguide/gradle_wrapper.html)
when exporting Android projects in Unity.
Just choose the desired version in `Gradle Wrapper` Project Settings and voilà!
The plugin will use the JDK and Gradle configured in Unity for generating the
wrapper, so there's no need to install or configure anything else.
The `Gradle Version` setting gets stored in the
`ProjectSettings/GradleVersion.txt` file.
## Installing
This package is available on the [openupm registry](https://openupm.com/) and can be installed using the [openupm-cli](https://github.com/openupm/openupm-cli):
```
openupm add com.gilzoide.gradle-wrapper
```
Otherwise, you can install via [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui-giturl.html)
using this repository URL and tag:
```
https://github.com/gilzoide/unity-gradle-wrapper.git#1.1.2
```
Alternatively, add the following into your `Packages/manifest.json` file:
```json
{
"dependencies": {
// ...
"com.gilzoide.gradle-wrapper": "https://github.com/gilzoide/unity-gradle-wrapper.git#1.1.2",
// ...
}
}
```
## How to use
1. Open the `Gradle Wrapper` section in Project Settings
2. Write the version of Gradle you want in the `Gradle Version` setting input
field
3. Mark `Export Project` in the Build Settings window
4. Hit the `Export` button
5. Enjoy 🍾
## Why
If you open an exported project in Android Studio, it will
generate a Gradle Wrapper if none is found in the project.
It will use one of the newest versions of Gradle, which may be incompatible
with the project's build scripts, and may not be able to build.
Also, even though Unity bundles it's own version of Gradle and all others are
not officially supported, sometimes projects need Gradle features that are only
available in newer versions.
In this scenario, every developer would need to download this specific version
and configure Unity to use it.
On top of that, when dealing with multiple projects, chances are not all of
them need the same version of Gradle.
With `gradlew`, all you need to do is run it, either from Android Studio or
from the console - the wrapper will take care of downloading and running the
right version.