Hdg Build

1. Create a new Build Config Collection

In the Project window, in an appropriate folder (e.g. the root Assets folder), right click and select Create > Build Config Collection.

A Build Config Collection is just a Unity asset. It is where you will define your build configurations. The default name is BuildConfigCollection but you can rename it if you like.

2. Select the Build Config Collection asset

Select the Build Config Collection asset you just created.

This will show the Build Config Collection in the inspector window:

3. Add a build config

Click the plus button in the bottom right of the Build Config Collection inspector to create a new build configuration.

This will add a new build configuration and automatically select it:

4. Edit build settings

In the inspector window you can change various properties for this build configuration. For example:

In the above example, we have called the build configuration Windows Release. When this build configuration is built, the symbols RELEASE and DISABLE_CHEATS will be defined, and a scene called Test will be built.

To add all scenes that are currently enabled in the Unity Build Settings window, click the Add All Scenes button:

If no scenes are configured for a build configuration, Hdg Build will build all scenes that are enabled in the Unity Build Settings.

5. Use the build configurations in the editor

Once your build configurations are set up, you can build them from the inspector with the Build button, or switch to them with the Switch button:

Note that Switch will do the same thing as switching platforms in the Build Settings window (i.e. Unity will re-import your project). Switching to a build config will also apply the defines specified in the build configuration.

6. Use the build configurations in build scripts

You can also use your build configurations from your own build scripts. For example:

public static void MakeiOSBuild()
{
    Hdg.BuildConfigManager.Build("Build", "BuildConfigCollection", "iOS Release");
}

The above will build the iOS Release build configuration from the BuildConfigCollection in the Assets folder. The iOS output folder will be called Build.

This is even more powerful if you pass in the build configuration via the system environment or the command-line:

public static void MakeBuild()
{
    var buildConfig = "";
    var buildPlatform = "";

    foreach (var arg in Environment.GetCommandLineArgs())
    {
        if (arg.StartsWith("-build_config"))
        {
            var setting = arg.Split('=');
            buildConfig = setting[1];
        }
        else if (arg.StartsWith("-build_platform"))
        {
            var setting = arg.Split('=');
            buildPlatform = setting[1];
        }
    }

    var buildConfigName = string.Format("{0} {1}", buildPlatform, buildConfig);
    Debug.Log(string.Format("Building '{0}'..", buildConfigName));
    Hdg.BuildConfigManager.Build("Build", "BuildConfigCollection", buildConfigName);
}

This is useful when making builds from a continuous build server.