Skip to main content

How to set the Build Profile in Unity Build Automation

Updated

Unity 6 introduces Build Profiles to manage development and production builds efficiently. Create or review Build Profiles in the Unity Editor, include necessary settings, add the profile asset to source control, and configure the build target in the Unity Dashboard by specifying the branch and profile path. Finally, trigger builds using these configurations via Unity Build Automation. More details are available in Unity’s documentation and tutorial videos.

Symptoms:

  • I want to create different builds for development and production using Unity Build Automation (UBA).
  • I'm using Unity 6 and I see a new "Build Profiles" option, but I'm not sure how to configure it.
  • I want to trigger my builds on UBA directly from the Unity Editor using custom profiles.
  • What is the best practice to connect the active build profile to UBA?

Cause:


Unity 6 introduces Build Profiles, a feature that helps streamline the creation and management of builds by allowing teams to define and reuse build configurations across multiple platforms and environments. Build Profiles can be integrated into UBA workflows to simplify cloud-based builds. These profiles are saved as assets within the Unity Editor and should be added to version control to ensure they’re correctly referenced in the Unity Dashboard.

 

Resolution:

To set up a Build Profile for use in Unity Build Automation, follow these steps:

1. Create or review your Build Profile in the Unity Editor

  • Navigate to File → Build Profiles.

  • Create a new Build Profile or review an existing one.

  • Ensure the profile includes all necessary settings, such as:

    • Target platform (e.g., Android, iOS)

    • Scene list

    • Scripting define symbols

    • Keystore reference

    • Build type (e.g., Debug, Release, Development, Production)

2. Add the Build Profile asset to source control

  • Unity saves each Build Profile as a .asset file. For example: 

    Assets/Settings/Build Profiles/AndroidDevelopment.asset

  • Commit and push this file to the branch you'll use for cloud builds.

3. Configure the Build Target in the Unity Dashboard

  • Go to the Unity Dashboard → DevOps → Configuration.

  • Start a new build-target configuration.

  • In the Basic Info panel:

    • Set the Branch to the one containing the Build Profile.

    • In the Build Profile path (optional) field, enter the relative path to the asset (e.g. Assets/Settings/Build Profiles/AndroidDevelopment.asset).

  • Save the configuration.

     

4. Run the Build

  • Trigger a new build using the new configuration and Build Profile.

 

More information:

Unity documentation: Introduction to build profiles

 

 

Related to

Related articles