Unity IL2CPP Build Support for Linux

Support for Linux players using IL2CPP is available from 2019.3 onwards.

Operating systems (OS) have their own build systems which vary from one another. If you build using the headers and libraries on a particular OS, this might result in the built player not running on a different one. To address this, Unity provides a sysroot to build against which works on all supported Linux platforms.

The sysroot also allows cross-compilation support which enables you to build Linux IL2CPP from Linux, macOS and Windows.

Prerequisites

To use the following packages, you need to install the Linux Build Support (IL2CPP) module in your Unity Editor version. Use the Unity Hub to do this. For further information, see Adding Modules to the Unity Editor.

Unity toolchain packages

Unity provides a toolchain package, which installs the sysroot and a toolchain, for building binaries for the target. The naming convention for these packages is:

“host platform and architecture” followed by “target platform and architecture”

If the host platform and architecture are the same as the target platform and architecture, the name is shortened to the platform and architecture.

Installing a Unity toolchain package

Go to Window > Package Manager. Use the search bar to find the package, and click **Install **in the bottom right corner of the Package Manager window. Choose the package based on the host platform:

Host	Package
Linux	com.unity.toolchain.linux-x86_64
macOS	com.unity.toolchain.macos-x86_64-linux-x86_64
Windows	com.unity.toolchain.windows.x86_64-linux-x86_64

Using a Unity toolchain package:

When you have installed your toolchain package, go to Project Settings >Player > Configuration and set the ScriptingBackend to IL2CPP.

To build your project go to File>Build Settings, in the Target Platform dropdown select Linux, then click Build or Build and Run.

Technical Details

Requirements:

• Unity version 2019.4.1f1
• Linux Build Support (IL2CPP) module