Skip to main content

How to set the Build Profile in Unity Build Automation

Updated

Unity 6 Build Profiles streamline reusable development and production configurations. Create or review a profile, commit its .asset file to source control, specify its path in Unity Dashboard Build Automation configuration, select the correct branch, save, and trigger the build.

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

    • Any required Platform-specific settings.

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 → Build Automation -> 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