Unity Builder Helper

Unity editor tool to manage and build projects
Report Bug · Request Feature

Table of Contents

1. About The Project
   • Screenshots
   • Features
   • Features with Unity Builder Bot
2. Getting Started
   • Requirements
   • Installation
   • Setup
3. Usage
   • Support files
4. Roadmap
5. Contributing
6. License
7. Contact

About The Project

Unity Builder Helper provide tools for build projects, control and fast switching build targets and defines. UBH use Unity Builder Bot (UBB) for remote builds.

Screenshots

Features

• Change build target
• Set defines
• Set build directory for target
• Change version and build
• Validate and set keystore
• Add locales and *.lproj files to iOS builds
• Add external files and frameworks to iOS builds
• Add google-services.json and agconnect-services.json
• Patch AndroidManifest.xml
• Patch gradle files
• Add dependencies to Huawei build
• Add external files to Android build
• Build project

Features with Unity Builder Bot

• Update repository before build
• Build Unity project
• Build Xcode project
• Compile, archive and export to IPA with configurated manifest
• Generate HTML with install links
• Upload all objects to remote server via sshpass
• Get build logs for project
• Clear project's logs and builds

(back to top)

Getting Started

UBH is Unity editor tool without dependencies*. Just add package to your project, create config file and use.

Requirements

1. Unity 2020+
2. NiceJson (in package)*
3. Mac OS for building Xcode projects
4. The steady hands

Installation

Get it from releases page or add the line below to Packages/manifest.json and this module will be installed directly from git url:

"com.mopsicus.ubh": "https://github.com/mopsicus/ubh.git",

Setup

1. Open UBH in Unity Editor via hotkey cmd+g or menu Tools -> Unity Builder Helper
2. Tap "Settings" button
3. Fill settings and save

(back to top)

Usage

1. Open UBH in Unity Editor via hotkey cmd+g or menu Tools -> Unity Builder Helper
2. Select platform, loggers and press Apply
3. Run local or remote build

Support files

You should store your support files in project root folder "Support files";

-Project
--Support files
---Android
----drawable
----values
----...
---iOS
----Locales
-----en.lproj
-----ru.lproj
-----es.lproj
-----....
----splash.png
----splash.storyboard
----....

All files in this folder will be added to project. For example, see demo project.

(back to top)

Roadmap

• Add WebGL build

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE file for more information.

(back to top)

Contact

Mopsicus: [email protected]

Website: https://mopsicus.ru

Telegram: https://t.me/mopsicus

Project Link: https://github.com/mopsicus/unity-builder-helper

(back to top)