Building content

A content build processes your Addressables groups to produce the content catalog and the AssetBundles that contain your assets.

To make an Addressables build, use the Build menu on the Addressables Groups window as described in Making builds. The next time you build the Player for your project, it uses the artifacts produced by the last Addressables content build run for the current platform. See Build scripting for information about automating your Addressables build process.

Your content build can produce two general categories of content:

  • Local content: content that's included directly in your player build. The Addressables system manages local content automatically as long as you use the default build path for your local content. If you change the local build path, you must copy the artifacts from the local build path to the project's Assets/StreamingAssets folder before making a Player build.
  • Remote content: content that's downloaded from a URL after your application is installed. It is your responsibility to upload remote content to a hosting server so your application can access it the designated URL (specified by your RemoteLoadPath).

Your Group settings determine which category a group belongs to; the active Profile determines the specific paths and URLs that the Addressables system uses to build and load the content. (Your Addressable Asset settings also contain options that affect your content builds, such as whether to build remote content at all.)

You can start builds from a script as well as from the Groups window. See Build scripting for more information.

The Addressables system includes the following build scripts:

  • Default Build Script: performs a full content build based on Group, Profile, and Addressables system settings.
  • Update a Previous Build: performs a differential content build to update a previously created build.
  • Play Mode scripts: the Play Mode scripts are technically build scripts and control how the Editor accesses your content in Play Mode. See Play Mode Scripts for more information.

The build scripts also provide a function to clear the cached files they create. You can run these functions from the Build > Clean Build menu of the Groups window.

Build commands

Access build commands from the Build menu on the toolbar at the top of the Groups window.

The menu provides the following items:

  • New Build: choose a build script to run a full content build. The Addressables package includes one build script, Default Build Script. If you create custom build scripts, you can access them here (see Build scripting).
  • Update a Previous Build: run a differential update based on an earlier build. An update build can produce smaller downloads when you support remote content distribution and publish updated content. See Content update builds.
  • Clean Build: choose a command to clean existing build cache files. Each build script can provide a clean up function, which you can invoke from this menu. (See Build scripting.)

Build artifacts

The build creates the following files that become part of the player build:

  • Local AssetBundles (.bundle): according to your group, profile, and platform settings
  • settings.json: contains Addressables configuration data used at runtime.
  • catalog.json: the catalog used to locate and load assets at runtime (if no newer remote catalog is available).
  • link.xml: prevents the Unity linker from stripping types used by your assets. See Code Stripping.

The Addressables system copies these files into your StreamingAssets folder when you make a player build so that they're included in your application. It removes the files when the player build is finished.

The build also creates the following files that aren't copied to streaming assets:

  • Remote AssetBundles (.bundle): according to your group, profile, and platform settings. You must upload remote bundles to your hosting server.
  • catalog_timestamp.json: the catalog to upload to your hosting server (overrides the local catalog). An Addressables build only creates a remote catalog file if you enable the Build Remote Catalog option in the project Addressable Asset settings.
  • catalog_timestamp.hash: the hash file to upload to your hosting server. Used to check whether the remote catalog has changed since the last time a client app downloaded it.
  • addressables_content_state.bin: used to make a content update build. If you are supporting dynamic content updates, you must save this file after each full content build that you release. Otherwise, you can ignore this file. See Content update builds.
  • AddressablesBuildTEP.json: build performance data. See Build profiling.