Asset Cache

The Asset Cache stores the runtime optimized product assets for each target platform, information about the process jobs that generated the product assets, and additional information about the assets such as product dependencies. The Asset Cache is located in the Cache directory under your project’s root directory.

Important:

Don’t add the Asset Cache to source control. Because the Asset Cache is continuously updated through automatic processes, it’s difficult to manage within source control. Using an Asset Cache from source control can also cause issues with asset timestamps that are used to determine whether assets need to be reprocessed.

Don’t edit product assets directly. If Asset Processor reprocesses the source asset, any changes made to the product asset are overwritten. To make changes to an asset, edit an upstream file, the source asset file, or the .assetinfo sidecar file.

Asset Cache contents

There are three parts to the Asset Cache: the Asset Database, the Asset Catalog, and the Asset Cache itself.

Asset Database

The Asset Database is only used by Asset Processor. The Asset Database is a development time database containing details about assets, jobs, Asset Builders, and scan directories. It contains all the information Asset Processor requires to determine which assets have been processed, and which assets need to be processed.

With the information in the Asset Database, Asset Processor can be suspended in the middle of a process job and resume when relaunched, remembering all the pending process jobs in the job queue.

Asset Catalog

The Asset Catalog is a runtime catalog of product assets and product dependencies. The Asset Catalog contains a subset of information from the Asset Database; the information about assets required at runtime. Asset Browser uses the Asset Catalog to find the runtime product assets on disk that you request for your projects.

Asset Cache

The Asset Cache contains the Asset Database, the Asset Catalog, and the product assets generated by Asset Builders.

The Asset Cache contains versions of the product asset for the host platform as well as versions for each target platform. For example, when you create a project for Windows and mobile platforms, the cache contains separate versions of the Asset Cache for Windows and each mobile platform. If you are developing the project on Windows and deploying on Windows, the same product assets are used for the host and target platforms.

In the Cache directory of your project, there are subdirectories for each platform supported by your project. In the platform directories, there are directories that correspond to every scan directory in which Asset Processor found source assets. The scan directories contain the product assets generated by Asset processor.

Note:

If you ever encounter an issue with the Asset Cache that you can’t resolve, your project’s Cache directory can be deleted. Asset Processor automatically rescans the directories, analyzes the source assets it finds, and runs new process jobs, rebuilding the entire Asset Cache.