cartergames / buildversions

A free automatic semantic build number updater for Unity.

Build Versions is a FREE build version updater tool for Unity that keeps your track of your projects versioning so you don't have to.

Badges

Key Features

• Automatic build information updating.
• Choose when the build number updates.
• No user setup required.
• Support to update the player settings build number on build.
• Support to update the Android bundle code on build.

How To Install

Either download and import the package from the releases section or the Unity Asset Store and use the package manager. Alternatively, download this repo and copy all files into your project.

Setup

None required once imported, though you can change some settings should you wish, more on this below:

This asset is designed to help automate a normally mundane task that most developers forget to change when making builds. The asset requires no setup on your part as it will do this itself when you first make a build. If you want to setup the asset yourself, just create an instance of Build Information & Build Versions Options and store them somewhere in your project. These can be created via the Create Asset menu via the path showed below:

From here all you need to do is configure the asset to work as you wish. You can change the settings in the options scriptable object directly or via the settings editor window under Tools/Build Verisons | CG/Settings

Changing Types

This is the only element of the asset that is not automated, as we can't read minds 😂 You can select a type of build via the tools menu. We've listed most common build types which we feel covers most of the types you will require. Should you want a different one, you can simply write it into the Build Information scriptable object.

Player Settings Systematic Versioning

When enabled the asset also updates the player settings for which ever platform you are currently on as well. The current version will not be transferred when you change platform. For the version to be correct on the new platform, you will need to set the version in the player settings to the last build's version to keep the version in sync.

The version number in the settings MUST follow the x.x.x or major/minor/build style formatting which is common in the industry. The asset only support 3 numbers separated by a dot (.), any other combinations will cause issues or errors.

By default the asset will only increment the build number by 1 each build made. Should you wish to update the major or minor number you can do so manually or via the tools menu options.

Documentation

You can access a online of the documentation here: Online Documentation. A offline copy if provided with the package and asset if needed.

Authors

• Jonathan Carter

Licence

MIT Licence

buildversions's Issues

Disable on development builds

Hello!
First for the great asset! I was tired by changing the Android version every time I upload game to Play store so I really appreciate!
I have an idea for a feature request:
add a setting to disable incrementing build number on development builds. I am testing my game using "Patch and run" multiple times a day, and every time I have to click "no" on prompts, or silently agree to increment number. And I would like to have version number increased only when I do release builds. Is this something possible for you to add?

Thanks again, and have a good day!