tjm35 / buildactions

BuildActions for use with the SuperUnityBuild build automation tool.

SuperUnityBuild BuildActions

BuildActions for use with the SuperUnityBuild build automation tool.

Unity Forums Thread | Documentation Wiki | OpenUPM package

BuildActions are one of the key components that make the SuperUnityBuild build automation tool flexible and powerful. Each one extends the capabilities of SuperUnityBuild and can be easily setup and customized to suit your needs, and if there's some other specialized functionality that your project needs, you can simply write your own BuildActions and integrate them into the build process.

This repository is intended to serve as an ever expanding library of useful BuildActions as more of them are created.

Basic Usage

Installation

BuildActions requires SuperUnityBuild to be installed in your project.

Official releases of BuildActions can be installed via Unity Package Manager from the OpenUPM package registry. See https://openupm.com/packages/com.github.superunitybuild.buildactions/ for installation options.

You can also download the source zip of this repository and extract its contents into your Unity project's Packages directory to install BuildActions as an embedded package.

Setup

Refer to the SuperUnityBuild wiki for basic information on how to setup, use, and create your own BuildActions. For specific details on one of the BuildActions featured here, refer to the README in its directory.

Tools

• AssetBundle Builder - AssetBundle building and file management.
• Script Runner - Run batch/script files or other external applications.
• Zip File Utility - Compress builds and other files into ZIP file format.
• File Operations Utility - Perform basic file/folder operations like copy, move, and delete.
• itch.io Uploader - Upload builds to itch.io.
• Override Defines - Add/remove script defines.
• Package Management - Enable per-build Unity Package Manager settings.
• Per-Build Player Settings - Enable per-build Player settings.
• XR Plug-in Management - Enable per-build Unity XR Plug-in Management settings.

Contributing

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

Credits

Creator

• Chase Pettit - GitHub, Twitter

Maintainer

• Robin North - GitHub

Contributors

You can see a complete list of contributors at https://github.com/superunitybuild/buildactions/graphs/contributors

License

All code in this repository (buildactions) 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.

Zip File Utility includes a pre-compiled DotNetZip library which is licensed under the Ms-PL. See DotNetZip's repository for more info.