Choose Build output compression level

Explore build output compression levels to balance speed and file size.

Read time 1 minute

Last updated 9 months ago

Unity Build Automation (UBA) compresses some build outputs after the Unity build completes and before UBA uploads the build to storage buckets. UBA uses compression level 1 by default. Usually, builds Unity produces are already compressed. Compression level 1 is the compression level with the most efficient in regards to compression time and final compressed file size. However, depending on factors such as your project, your platform, and your Unity build output compression technique (

None

LZ4

, or

LZ5 HC

), you might want to change the final build output compression levels. In general, lower compression levels reduce build outputs compression time, but result in larger final compressed files. You can edit your compression level to test which level is best for your project. For example, you can evaluate compression time and final compressed file size to find the optimal build output compression level for your project and performance thresholds.

Compressed build output files

The following build output files are compressed and will be affected by the build output compression level setting:

Desktop, WebGL and console builds
Symbol files
XCode archives and projects

Configure Build output compression level

You can configure the build output compression level at two levels: for a specific project, or for a build target configuration.

Configure Build output compression level for a project

In your Unity Dashboard, select DevOps > Build Automation > Settings.
Click on the Project configurations tab.
In the Build output card, select the Build output compression level you want to use.
Click Save.

Configure Build output compression level for a Build Target Configuration

Note

This option overrides the project level Build output compression level setting for the specific build target.

In your Unity Dashboard, select DevOps > Build Automation > Configurations.
Select the edit icon on the build configuration you want to edit and go to Advanced Settings.
Select the Build output compression level in the Build Output card.
The default option is Use project's build output compression level, which inherits the compression level from your project settings, but you can override this setting for the current build target.
Click Save changes.

Documentation

Development

User Acquisition

Monetization

Industry