Build target configurations
When you’ve configured your project in Cloud BuildA continuous integration service for Unity projects that automates the process of creating builds on Unity’s servers. More info
See in Glossary, you can set up advanced build options for each of your build targets.
These options accommodate the more complex build processing options supported in the Unity Editor.
Note: If you are configuring your build options for the first time, you must set up source control first.
To access your build target’s advanced options:
- Sign in to the to the Unity Developer website.
- Select DevOps > Cloud Build > Configurations.
You have two options to set up a new build target:
Quick target setup
When you select Quick target setup, you see the basic configurations required to configure a build target for each platform. Choose this option if you don’t want to configure advanced settings for your build target.
Target setup
When you select Target setup, you first set up the basic settings required for launching your build target. Then, you can either save your configuration or move to the advanced settings.
In the Advanced settings tab, the build target’s Advanced Options are displayed.
All advanced options are set per build target. This means that, for example, when you click the Advanced Options link for an iOS target, those options are only for that iOS target. When you click Advanced Options for an Android target, those options are only for that Android target. This lets you use different pre- and post-methods per platform, per build target.
The table below describes the Advanced Options.
| Property | Description |
|---|---|
| Build output | A build output includes debug symbols and enables the ProfilerA window that helps you to optimize your game. It shows how much time is spent in the various areas of your game. For example, it can report the percentage of time spent rendering, animating, or in your game logic. More info See in Glossary. For more information, see Build output. |
| Script hooks -Pre-Build Script | Cloud Build will run this script before the Unity build process starts. You can use this script for custom pre/post processing. |
| Script hooks -Post-Build Script | Cloud Build will run this script after the Unity build process is completed. You can use this script for custom pre/post processing. |
| Script hooks-Pre-Export Method | Manipulate project files before the project is built. Examples include copying variables from an external file into the project, processing Assets, or working with plug-insA set of code created outside of Unity that creates functionality in Unity. There are two kinds of plug-ins you can use in Unity: Managed plug-ins (managed .NET assemblies created with tools like Visual Studio) and Native plug-ins (platform-specific native code libraries). More info See in Glossary that require special treatment. For more information, see Pre- and post-export methods. |
| Script hooks- post-Export method | Add the public method you want use to call after finishing the Unity build process (but before Xcode). |
| Tests | Use this to configure conditions to run tests and actions on failures. |
| Environment variables | Use environment variables if you want to give different configurations to your code for different builds. |
| SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info See in Glossary List |
Use this to configure a build target to build a set of Scenes that’s different to what is set up in the project’s Build Settings menu in the Unity Editor. For more information, see Including specific Scenes. |
| Addressables | Use this to build the configured Addressables for the build target’s platform as part of the build process. For more information, see Using Addressables in Unity Cloud build. |
| Asset bundles | Use this to build all configured Asset Bundles for this build target’s platform as part of the build process. For more information, see AssetBundles. |
Using Xcode frameworks
When building for iOS, you might need to include various frameworks after the Unity build process is done, but before the Xcode build process starts.
See Xcode frameworks for more information.