These are the docs for 11.0, an old version of SpatialOS. The docs for this version are frozen: we do not correct, update or republish them. 14.5 is the newest →

This page applies to SpatialOS 10.4. It hasn’t been upgraded to SpatialOS 11 yet.

Unity iOS support

Building Unity client workers for iOS platforms has experimental support.


You can run your SpatialOS Unity client workers on both iOS devices and simulators.


  • MacOS 10.12.2 (Sierra) and with Xcode 8 installed.
  • Unity 5.6.0 installed.
  • “iOS Build Support” installed as an additional Unity component. Refer to the Unity setup guide (Windows/Mac), which describes how to select required Unity components during the installation process.
  • Active enrolment in the Apple Developer Program for iOS, either as a team or as an individual.
    • An Apple Developer Account is not strictly required for developing only with the iOS Simulator. But it is still required for code-signing any external libraries, which is a necessary step in this guide.
    • Apple requires an active enrolment for developing and deploying on iOS devices.

Details about Apple Developer Accounts and the general distribution pipeline for Xcode and iOS is beyond the scope of this guide. For more details, please refer to Apple’s developer documentation for more details.

Known issues

  • Currently, developing for iOS devices only works with remote deployments. i.e. you can still perform iOS Device testing against a remote deployment using spatial cloud launch. Developing using the iOS Simulator supports both local and remote deployments.

  • When building out iOS workers with Unity, the generated XCode project contains compilation errors due to a known bug with Unity IL2CPP code generation. We have provided detailed instructions on how to resolve these issues in our Troubleshooting section.

Getting started

The next section describes the steps required to getting with using SpatialOS with Unity iOS builds.

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums