Linux fails to compile in Ubuntu 24.04 LTS

[masakk1]

I'm trying to use Stride3d for the first time.

Platform

I'm running Ubuntu 24.04 LTS in a distrobox.

Steps to reproduce

1. Install the necessary dependencies from the linux setup guide

sudo apt install dotnet10
sudo apt install libfreetype6-dev libopenal-dev libsdl2-dev libfreeimage-dev 

2. Create project

dotnet new console --framework net10.0 --name Issue01Project
cd Issue01Project

3. Add packages

dotnet add package Stride.CommunityToolkit --prerelease
dotnet add package Stride.CommunityToolkit.Linux --prerelease
dotnet add package Stride.CommunityToolkit.Bepu --prerelease

4. Change to Linux platform.

   • Add <StridePlatform>Linux</StridePlatform> to the Issue01Project.csproj

5. Run dotnet build

Relevant files

The project file:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>

    <StridePlatform>Linux</StridePlatform>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Stride.CommunityToolkit" Version="1.0.0-preview.62" />
    <PackageReference Include="Stride.CommunityToolkit.Bepu" Version="1.0.0-preview.62" />
    <PackageReference Include="Stride.CommunityToolkit.Linux" Version="1.0.0-preview.62" />
  </ItemGroup>

</Project>

Logs

mas@stride-gamedev:~/Documents/Dev/gamedev/Issue01Project$ dotnet build
Restore succeeded with 3 warning(s) in 0.4s
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1903: Package 'Microsoft.Build.Tasks.Core' 17.7.2 has a known high severity vulnerability, https://github.com/advisories/GHSA-h4j7-5rxr-p4wc
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1901: Package 'NuGet.Packaging' 7.0.0 has a known low severity vulnerability, https://github.com/advisories/GHSA-g4vj-cjjj-v7hg
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1901: Package 'NuGet.Protocol' 7.0.0 has a known low severity vulnerability, https://github.com/advisories/GHSA-g4vj-cjjj-v7hg
  Issue01Project net10.0 failed with 1 error(s) and 3 warning(s) (2.4s) → bin/Debug/net10.0/Issue01Project.dll
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1903: Package 'Microsoft.Build.Tasks.Core' 17.7.2 has a known high severity vulnerability, https://github.com/advisories/GHSA-h4j7-5rxr-p4wc
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1901: Package 'NuGet.Packaging' 7.0.0 has a known low severity vulnerability, https://github.com/advisories/GHSA-g4vj-cjjj-v7hg
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1901: Package 'NuGet.Protocol' 7.0.0 has a known low severity vulnerability, https://github.com/advisories/GHSA-g4vj-cjjj-v7hg
    /var/home/mas/.nuget/packages/stride.core.assets.compilerapp/4.3.0.2507/buildTransitive/Stride.Core.Assets.CompilerApp.targets(154,5): error MSB3073: The command "dotnet "/var/home/mas/.nuget/packages/stride.core.assets.compilerapp/4.3.0.2507/buildTransitive/../lib/net10.0/Stride.Core.Assets.CompilerApp.dll"  --disable-auto-compile --project-configuration "Debug" --platform=Linux --project-configuration=Debug --compile-property:StrideGraphicsApi=OpenGL --output-path="/var/home/mas/Documents/Dev/gamedev/Issue01Project/bin/Debug/net10.0/data" --build-path="/var/home/mas/Documents/Dev/gamedev/Issue01Project/obj/stride/assetbuild/data" --package-file="/var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj" --msbuild-uptodatecheck-filebase="/var/home/mas/Documents/Dev/gamedev/Issue01Project/obj/Debug/net10.0/stride/assetcompiler-uptodatecheck"" exited with code 1.

Build failed with 1 error(s) and 6 warning(s) in 3.1s

[masakk1]

I switched to an arch distrobox, which is working fine after installing the Liberation font.

I tried running the Liberation font on the Ubuntu machine, and I got a new set of issues now:

mas@stride-gamedev:~/Documents/Dev/gamedev/Issue01Project$ dotnet build
Restore succeeded with 3 warning(s) in 1.2s
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1903: Package 'Microsoft.Build.Tasks.Core' 17.7.2 has a known high severity vulnerability, https://github.com/advisories/GHSA-h4j7-5rxr-p4wc
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1901: Package 'NuGet.Packaging' 7.0.0 has a known low severity vulnerability, https://github.com/advisories/GHSA-g4vj-cjjj-v7hg
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1901: Package 'NuGet.Protocol' 7.0.0 has a known low severity vulnerability, https://github.com/advisories/GHSA-g4vj-cjjj-v7hg
  Issue01Project net10.0 failed with 19 error(s) and 4 warning(s) (5.6s) → bin/Debug/net10.0/Issue01Project.dll
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1903: Package 'Microsoft.Build.Tasks.Core' 17.7.2 has a known high severity vulnerability, https://github.com/advisories/GHSA-h4j7-5rxr-p4wc
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1901: Package 'NuGet.Packaging' 7.0.0 has a known low severity vulnerability, https://github.com/advisories/GHSA-g4vj-cjjj-v7hg
    /var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj : warning NU1901: Package 'NuGet.Protocol' 7.0.0 has a known low severity vulnerability, https://github.com/advisories/GHSA-g4vj-cjjj-v7hg
    EXEC : warning 1.069s: [AssetCompiler] Could not find game settings asset at location [GameSettings]. Use a Default One
    EXEC : error 1.117s: [AssetsCompiler.AttributeBasedRegistry] Unable to instantiate compiler [Stride.BepuPhysics.Assets.HullAsset, Stride.Assets, Version=4.3.0.2507, Culture=neutral, PublicKeyToken=null]. Exception: TargetInvocationException: Exception has been thrown by the target of an invocation.
    EXEC : error 1.119s: [AssetsCompiler.AttributeBasedRegistry] Unable to instantiate compiler [Stride.Assets.Physics.ColliderShapeAsset, Stride.Assets, Version=4.3.0.2507, Culture=neutral, PublicKeyToken=null]. Exception: TargetInvocationException: Exception has been thrown by the target of an invocation.
    EXEC : error 1.299s: [AssetCompiler] Exception in command [StrideDefaultSplashScreen] Stride.Assets.Textures.TextureConvertParameters: System.TypeInitializationException: The type initializer for 'Stride.TextureConverter.TextureTool' threw an exception.
    EXEC : error 1.299s: [AssetCompiler] Exception in command [StrideDebugSpriteFont] Stride.Assets.Textures.TextureConvertParameters: System.TypeInitializationException: The type initializer for 'Stride.TextureConverter.TextureTool' threw an exception.
    EXEC : error 1.305s: [AssetCompiler] BuildStep [StrideDefaultSplashScreen] Stride.Assets.Textures.TextureConvertParameters failed.
    EXEC : error 1.305s: [AssetCompiler] BuildStep [StrideDebugSpriteFont] Stride.Assets.Textures.TextureConvertParameters failed.
    EXEC : error 1.306s: [AssetCompiler] Exception in command [StrideDebugSpriteFont] Stride.Assets.Textures.TextureConvertParameters: System.TypeInitializationException: The type initializer for 'Stride.TextureConverter.TextureTool' threw an exception.
    EXEC : error 1.306s: [AssetCompiler] BuildStep [StrideDebugSpriteFont] Stride.Assets.Textures.TextureConvertParameters failed.
    EXEC : error 1.306s: [AssetCompiler] Exception in command [StrideDefaultSplashScreen] Stride.Assets.Textures.TextureConvertParameters: System.TypeInitializationException: The type initializer for 'Stride.TextureConverter.TextureTool' threw an exception.
    EXEC : error 1.306s: [AssetCompiler] BuildStep [StrideDefaultSplashScreen] Stride.Assets.Textures.TextureConvertParameters failed.
    EXEC(1,1): error 1.307s: [AssetCompiler] Asset [StrideDebugSpriteFont] failed to compile
    EXEC(1,1): error 1.307s: [AssetCompiler] Asset [StrideDefaultSplashScreen] failed to compile
    EXEC : error 1.310s: [AssetCompiler] BuildStep Asset build steps [TextureAsset:'StrideDebugSpriteFont'] (1 items) failed.
    EXEC : error 1.310s: [AssetCompiler] BuildStep Asset build steps [TextureAsset:'StrideDefaultSplashScreen'] (1 items) failed.
    EXEC : error 1.387s: [AssetCompiler] BuildStep Build step list (411 items) failed.
    EXEC : error 1.388s: [AssetCompiler] BuildStep Build step list (1 items) failed.
    EXEC : error 1.389s: [AssetCompiler] Build finished in 825 steps. Command results: 819 succeeded, 0 up-to-date, 6 failed, 0 not triggered due to previous failure.
    EXEC : error 1.389s: [AssetCompiler] Build failed.
    /var/home/mas/.nuget/packages/stride.core.assets.compilerapp/4.3.0.2507/buildTransitive/Stride.Core.Assets.CompilerApp.targets(154,5): error MSB3073: The command "dotnet "/var/home/mas/.nuget/packages/stride.core.assets.compilerapp/4.3.0.2507/buildTransitive/../lib/net10.0/Stride.Core.Assets.CompilerApp.dll"  --disable-auto-compile --project-configuration "Debug" --platform=Linux --project-configuration=Debug --compile-property:StrideGraphicsApi=OpenGL --output-path="/var/home/mas/Documents/Dev/gamedev/Issue01Project/bin/Debug/net10.0/data" --build-path="/var/home/mas/Documents/Dev/gamedev/Issue01Project/obj/stride/assetbuild/data" --package-file="/var/home/mas/Documents/Dev/gamedev/Issue01Project/Issue01Project.csproj" --msbuild-uptodatecheck-filebase="/var/home/mas/Documents/Dev/gamedev/Issue01Project/obj/Debug/net10.0/stride/assetcompiler-uptodatecheck"" exited with code 1.

Build failed with 19 error(s) and 7 warning(s) in 7.2s

[VaclavElias]

Some references stride3d/stride#2596

[pickles976]

Here's how I fixed. Disclosure: I just let Claude bang its' head against the wall until it figured this out.

.csproj

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <StrideGraphicsApi>OpenGL</StrideGraphicsApi>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="StbImageSharp" Version="2.30.0" />
    <PackageReference Include="Stride.CommunityToolkit.Bepu" Version="1.0.0-preview.62" />
    <PackageReference Include="Stride.CommunityToolkit.Linux" Version="1.0.0-preview.62" />
  </ItemGroup>

  <!-- Workaround: Stride's .ssdeps uses Windows backslash paths for Linux native libs, so the
       NuGet resolver can't find native .so files at asset-compile time.
       We set LD_LIBRARY_PATH in the MSBuild process before the asset compiler subprocess
       launches; child processes inherit it, so the system loader finds the .so files.
       Update paths below if you upgrade Stride packages (currently all 4.3.0.2507). -->
  <UsingTask TaskName="SetProcessEnvVar" TaskFactory="RoslynCodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)/Microsoft.Build.Tasks.Core.dll" Condition="$([MSBuild]::IsOSPlatform('Linux'))">
    <ParameterGroup>
      <Name ParameterType="System.String" Required="true" />
      <Value ParameterType="System.String" Required="true" />
    </ParameterGroup>
    <Task>
      <Code Type="Fragment" Language="cs">
        System.Environment.SetEnvironmentVariable(Name, Value);
      </Code>
    </Task>
  </UsingTask>

  <Target Name="SetStrideNativeLibPathForLinux" BeforeTargets="StrideCompileAsset" Condition="$([MSBuild]::IsOSPlatform('Linux'))">
    <SetProcessEnvVar Name="LD_LIBRARY_PATH" Value="$(NuGetPackageRoot)stride.textureconverter/4.3.0.2507/runtimes/linux-x64/native:$(NuGetPackageRoot)stride.physics/4.3.0.2507/runtimes/linux-x64/native:$(NuGetPackageRoot)stride.audio/4.3.0.2507/runtimes/linux-x64/native:$(NuGetPackageRoot)stride.navigation/4.3.0.2507/runtimes/linux-x64/native:$(NuGetPackageRoot)stride.assets/4.3.0.2507/runtimes/linux-x64/native:$([System.Environment]::GetEnvironmentVariable('LD_LIBRARY_PATH'))" />
  </Target>

</Project>

Stride ships native libraries (.so files on Linux) inside NuGet packages under runtimes/linux-x64/native/. However, Stride's .ssdeps manifest files record those paths using Windows backslashes (e.g. runtimes\linux-x64\native\DxtWrapper.so). The Stride NuGet resolver running on Linux can't parse those paths, so it never registers the native libs with .NET's loader.

When the asset compiler runs as a subprocess it loads the full Stride engine, which immediately tries to dlopen several native libraries via NativeLibraryHelper.PreloadLibrary. If those .so files aren't on the search path the static constructors throw TypeInitializationException and asset compilation aborts.

An inline MSBuild task sets LD_LIBRARY_PATH on the MSBuild process before the asset compiler subprocess is spawned. Child processes inherit the env var, so the system linker finds the .so files.