Version: 2022.2
Build Settings
Project Settings

Incremental build pipeline

For faster iteration during development, Unity uses an incremental build pipeline that only rebuilds parts of the application if they have changed since the previous build. This includes build steps such as asset serialization, code compilation, data compression, and signing. By default, Unity uses the incremental builds pipeline for both release and development builds.

The incremental build pipeline also automates the Scripts Only Build feature. Scripts Only Build is therefore only available in the Build Settings window for the platforms that do not use incremental builds.

The incremental build pipeline works for both the Mono and IL2CPP scripting backend. Although, the output file structure changes depending on which scripting backend your project uses.

Platform compatibility

Unity supports the incremental build pipeline for the following platforms:

  • Standalone (Windows, Mac and Linux)
  • WebGL
  • Xbox One
  • Xbox Series X and Xbox Series S
  • Android
  • iOS
  • tvOS

Creating non-incremental builds

In some scenarios, it can be useful or necessary to create builds that don’t use the incremental build pipeline.

To create a clean, non-incremental, build:

  1. Open the Build Settings window.
  2. Next to the Build button, select the drop-down.
  3. Select Clean Build.

In general, if expected changes are not present after an incremental build and you think there is a problem with the incremental build pipeline, create a clean build. The most common reason for this is when you implement or make changes to build process callbacks that affect assets.

Since the build process can’t know how a callback you’ve implemented affects an asset, it can’t determine how to rebuild the asset. Unity only regenerates files if the file’s dependencies change. This means if the callback modifies a file that Unity generates, and the file’s dependencies don’t change, the callback can apply modifications to an already modified file. For example, if the callback adds new entries to an Android App Manifest, and the dependencies for the Android App Manifest don’t change, the callback still adds the new entries, which results in an invalid file.

If you change a callback or its input data and you want Unity to rebuild assets that the callback affects, create a clean build. Examples of callbacks include:

Note: If you make changes to an asset, Unity rebuilds that asset when it builds the application. This also includes processing any callback that affects it which means you don’t need to create a clean build if you make changes to an asset, only if you make changes to a build process callback.

Build Settings
Project Settings