kibotu/unity-gradle-plugin

Gradle plugin to build Unity 3D projects

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.kibotu:unity-gradle-plugin:1.0.0'
	}
	dependencies {
		implementation("com.github.kibotu:unity-gradle-plugin:1.0.0")
	}
	<dependency>
	    <groupId>com.github.kibotu</groupId>
	    <artifactId>unity-gradle-plugin</artifactId>
	    <version>1.0.0</version>
	</dependency>

                            
    libraryDependencies += "com.github.kibotu" % "unity-gradle-plugin" % "1.0.0"
        
        

                            
    :dependencies [[com.github.kibotu/unity-gradle-plugin "1.0.0"]]

Readme

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

Prepend this for jitpack fork usage, which includes pull-request#4, pull-request#4, pull-request#4,

buildscript {
    repositories {
        jcenter()
        maven { url "https://jitpack.io" }
    }
    dependencies {
        classpath 'com.github.kibotu:unity-gradle-plugin:1.0.0'
    }
}

allprojects {
    repositories {
        jcenter()
        maven { url "https://jitpack.io" }
    }
}

apply plugin: 'com.zasadnyy.unity'

or use old version:

  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.