Gradle plugin to build Unity 3D projects
Groovy C#
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
example-unity-project
unity-gradle-plugin
.gitignore
LICENSE
NOTES.md
README.md

README.md

Unity Gradle Plugin

Build your Unity 3D projects with Gradle.

Features

  • Supports Android and iOS builds
  • The most important Player Settings exposed via Gradle DSL

Upcoming features

  • Tasks to run Unit and Integration tests
  • Distribute helper classes from Assets/GradleBuild folder as a .unitypackage
  • More supported platforms (next one Mac/Linux)

Requirnments

  • Gradle added to $PATH
  • Mac machine (not tested on Windows)

Usage

  1. $cd [unity project root]

  2. $gradle init - initialize Gradle wrapper, create settings.gradle, build.gradle

  3. Configure unity.path in local.properties, e.g. unity.path=/Applications/Unity/Unity.app/Contents/MacOS

  4. Apply unity plugin in build.gradle

    plugins {
        id "com.zasadnyy.unity" version "0.1.1"
    }
  5. Add Unity plugin configuration

    unity {
        common {
            bundleId 'com.zasadnyy.testapp'
            bundleVersion 'v0.1'
            scenes 'Assets/Scenes/MainScene.unity', 'Assets/Scenes/MainScene1.unity'
        }
    
        android {
            splitApplicationBinary false
            bundleVersionCode 42
            signingConfigs {
                debug {
                    storePath 'keystores/get-social-debug.keystore'
                    storePassword 'android'
                    keyAlias 'androiddebugkey'
                    keyPassword 'android'
                }
            }
            signingConfig signingConfigs.debug
        }
    
        ios {
            shortBundleVersion 'v0.1'
        }
    }
  6. Copy folder Assets/GradleBuild from example-unity-project into your Unity project

  7. Check available tasks with $./gradlew tasks

  8. Build selected platform, e.g. $./gradlew buildAndroidPlayer

  9. Check the output in dist/android folder

Docs

Full DSL documentation coming soon... Meantime, check example to find available options.

Example project

Check the example-unity-project folder for an example project.

Changelog

v0.1.1 - February 22, 2016

  • Initial release

License

The project is published under the Apache 2 license. Feel free to clone and modify repo as you want, but don't forget to add a reference to the author.