Choose Build output compression level#

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#

1. In your Unity Cloud dashboard, select DevOps > Build Automation > Settings.
2. Click on the Project configurations tab.
3. In the Build output card, select the Build output compression level you want to use.
4. Click Save.

Configure Build output compression level for a Build Target Configuration#

1. In your Unity Cloud dashboard, select DevOps > Build Automation > Configurations.
2. Select the edit icon on the build configuration you want to edit and go to Advanced Settings.
3. Select the Build output compression level in the Build Output card.
4. 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.
5. Click Save changes.