Skip to content

rthery/unity-build

 
 

Repository files navigation

SuperUnityBuild

A powerful automation tool for quickly and easily generating builds of a game with Unity.

Unity Forums Thread | Documentation Wiki

SuperUnityBuild is a Unity utility that automates the process of generating builds of your game. It's easy and quick enough to use on small games, but it's also powerful and extensible enough to be extremely useful on larger projects. The key to this flexibility lies in SuperUnityBuilds configurable degrees of granularity and its "BuildActions" framework which allows additional operations to be added into the build process.

Features:

  • Manage and Build Multiple Versions - If you're targetting more than one platform or distribution storefront, the build process can quickly become very cumbersome with Unity's built in tools. SuperUnityBuild makes it easy to manage a wide array of build configurations targetting any number of versions, platforms, architectures, or distribution methods.
  • One-Click Batch Builds - Easily kick-off batch builds for all or a specific subset of your build configurations.
  • Expanded Build Capability - SuperUnityBuild overs many features not available in Unity's built in build workflow such as version number generation, and the BuildAction framework provides options for even more expanded build capabilities like automated file copying/moving, creating zip files, and building AssetBundles.
  • Quick Initial Setup - If all you need is the bare essentials, you can be up and running in minutes. SuperUnityBuild scales to fit your project's specific needs whether it be large or small.
  • Highly Extensible and Customizable - SuperUnityBuild's BuildAction framework provides simple hooks for adding in your own additional functionality.
  • Free and Open-Source - Some similar tools available only on the AssetStore are as much as $50+.

Basic Usage

Requires Unity 5.0 or higher. Currently supports Windows, OSX, and Linux builds - more platforms soon once they've been tested more thoroughly.

Install

Either download the latest released Unity Package and import it into your project OR download the zip of this repository and extract its contents into your Unity project's Assets directory.

You may also want to download some of the available BuildAction modules in the Unity-Build-Actions repository to expand SuperUnityBuild's capabilities.

Basic Setup

See Standard Usage in the wiki.

Customizing and Expanding

Creating BuildPlatforms

TODO

Creating BuildActions

See Build Actions in the wiki for details.

Command Line Interface

See Command Line Interface in the wiki.

Contributing

Bug reports, feature requests, and pull requests are welcome and appreciated.

Credits

License

All code in this repository (unity-build) is made freely available under the MIT license. This essentially means you're free to use it however you like as long as you provide attribution.

About

A powerful automation tool for quickly and easily generating builds of a game with Unity.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%