Build and deploy

Build a simulator to be uploaded to the cloud

A simulator build is a built Unity Player for the Linux 64-bit platform that you can upload to coherence straight from Unity Editor.

Make sure you have run through Build and run and Create an account.

On Unity's menu bar, navigate to coherence -> Simulator -> Build Wizard.

From within the Build Wizard you can build and upload simulators.

The Info tab provides information and requirements to build simulators properly.

The Build tab creates valid simulator builds from Build Configuration Assets.

There's a known issue in the Platforms package provided by Unity where builds will fail when the project is not in the target build platform. To prevent this from happening, please switch your active platform to match the one used in your build configuration before building.

Creating a Build Configuration Asset

You can create them via Assets -> Create -> coherence -> Simulator Build Configuration.

A newly created build configuration looks like this:

There are several settings you might want to change.

• Specify the scenes you want to get in the build via the Scene List component.

• Specify a Company Name and a Version from the General Settings component (optional).

• Additionally, you can add our OptimizeForSize component (find it using Add Component). Specify which optimizations you want to use to reduce the final build size from the Optimize For Size component (optional).

Reducing simulator build size (experimental ⚠️)

This feature is experimental, please make sure you backup your project beforehand.

You can add an OptimizeForSize component to your build configuration via the Add Component in the build configuration inspector. It looks like this:

Optimize For Size component, part of a Build Configuration Asset.

Select the desired optimizations depending on your needs.

Optimization	What it does
Replace Textures And Sounds With Dummies	Project's textures and sound files are replaced with tiny and lightweight alternatives (dummies). Original assets are copied over to <project>/Library/coherence/AssetsBackup. They are restored once the build process has finished.
Keep Original Assets Backup	The Assets Backup (found at<project>/Library/coherence/AssetsBackup) is kept after the build process is completed, instead of deleted. This will take disk space depending on the size of the project, but it's a safety convenience.
Compress Meshes	Sets Mesh Compression on all your models to High.
Disable Static Batching	Static Batching tries to combine meshes at compile-time, potentially increasing build size. Depending on your project, static batching can affect build size drastically. Read more about static batching.

Settings applied to built simulators will be reverted once the build process is completed, so these settings won't affect other builds you make.

Upload your simulator

Once you have created a valid simulator build, you can upload it to coherence.

If you built your simulator using the Build tab, you should have a valid path to your simulator build set already. If you haven't or want to use a different path, use the Browse button.

You'll see in the developer dashboard when your simulator is ready and running.

Target frame rate on simulator builds is forced at 30.