Version: 2019.4
Sprite Atlas workflow
Methods of distribution

Preparing Sprite Atlases for distribution

A Project can have multiple Sprite Atlases for different purposes (for example, Variant Atlases with lower-resolution Textures for hardware with different limitations). If you enable all available Sprite Atlases, you might encounter conflicts (refer to Resolving different Sprite Atlas scenarios for more information).

To prevent these issues, properly prepare Sprite Atlases for distribution with the following steps:

  1. Disable ‘Include in Build’ in the Sprite Atlas properties.
  2. Choose a method to distribute the Atlas.
  3. Load the Atlas via Late Binding with a script.

Disable ‘Include in Build’

Unity includes Sprite Atlases in a Project’s build by default, and automatically loads them at run time. Clear the Include in Build setting of the selected Sprite Atlas to disable this behavior.

If ‘Include in Build’ is disabled, Unity still packs the Sprite Atlas into a *.spriteatlas file in the Project’s Assets folder. However, Sprites which reference Textures in an disabled Sprite Atlas appear invisible as the reference Texture is not available or loaded. Unity does not include the disabled Sprite Atlas in the Project’s published build, and does not automatically load it at run time. To do so, a script is required to load the Sprite Atlas via Late Binding.

Sprite Atlas workflow
Methods of distribution