Building

The default build for the C# worker sets up a project that should get you started quickly, lets you customize the build, and is upgradeable between SpatialOS versions. However, if you need to customize it further, you can turn off the automatic build script generation.

IDE support

After running spatial worker build for the first time, a .sln file, which can be loaded in your IDE, should appear. Note that, by default, this file will be overwritten every time a build is run. It is compatible and has been tested with Visual Studio 2015 Community Edition, and is known to work with Jetbrains’ Rider early access preview, except for running a worker from within the editor. The default solution currently isn’t compatible with MonoDevelop and Xamarin. If you wish to customize the solution and project files to make them compatible with your IDE, please follow the instructions on how to customize the build by turning off automatic build script generation as shown above.

Project setup

The project is set up to have two configurations - Release and Debug - and 3 platforms for each - Windows64, Linux64, and macOS64, which build assemblies for 64-bit Windows, Linux, and macOS respectively. These assemblies are bundled from the target directories of the build, so if you wish to have additional resources statically available at runtime, you can put them in the target directory of the relevant configuration-platform. Each of the assemblies will contain compiled native code dependencies required to run the worker on the given platform. 32-bit versions of native dependencies are currently not provided.

When you run spatial worker build, this code will be generated for your schema. This is then compiled as a separate assembly, as it needs to use the unsafe keyword. Release builds and assemblies for all provided platforms will be built.

You can also open the CsharpWorker solution in an editor of your choice, and build your code from there. Schema changes should be automatically picked up when building from an editor. You will have to run spatial worker build after an upgrade of SpatialOS to pick up the newest dependencies.

Source control setup

We recommend to add some files and directories to the list of ignored items in your source control system. Apart from the usual suggested ignored C# project files (see an example .gitignore), you might want to add improbable/ and spatial.log. If you are using the default build scripts, you might also want to add spatialos.csharp.build.json, BuildTargets.targets, CsharpWorker.sln, CSharpWorker.targets, GeneratedCode.csproj, and spatialos_worker_packages.json.