Troubleshoot the Embedded Linux Unity Editor

This page lists the common problems that might occur when using the Embedded Linux Unity Editor.

The Player build fails with an error

When exporting the Unity project, the following error appears: No EmbeddedLinux Burst Support on X86/Arm32 architecture. Disabling Burst in Settings and removing it from the project doesn't fix the issue because another package has a dependency on it.

Solution

Burst isn't supported on 32-bit Embedded Linux platforms. To prevent seeing the error, you can disable Burst by starting the Unity Editor with the --burst-disable-compilation argument.

Wayand is not available error

Starting the player on the target device fails with: SDL Error: wayland,x11 not available although Wayland is available.

Solution

This error might occur due to one of the following reasons:

  • The Wayland library isn't located by SDL2. Make sure that the Wayland library is locatable by dlopen from the player application.
  • Unity requires at least Wayland version 1.18. Because some systems have only version 1.16 or lower available, ensure to check that at least Wayland version 1.18 is supported on the target device.
  • The connection to the Wayland display fails. Make sure the Wayland environment is properly set up.

Lightmapper corrupts GI cache in the editor when the target platform is UWP

When using the Lightmapper in the Editor, the GI cache gets corrupted if UWP is selected as the Target platform.

Solution

The -nographics commandline argument in the Player build of the Unity Editor is the root cause of this problem, because it generates sky ambient probe and reflection probe that require loading a gfx device, otherwise these probes include uninitialized data. To prevent this from happening, run the Player build without -nographics, or generate lighting in the Editor for each scene included in the build. That is, don't add lights or generate lightmaps, and instead generate lighting that will automatically bake the sky probes. When -nographics is set, no probes will be rendered.

Additional resources