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 facing 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.