Some problem of compilation with `LLGL_BUILD_STATIC_LIB`.

[coco875]

When I enable LLGL_BUILD_STATIC_LIB after an recompilation I get this kind of error:

[build] Undefined symbols for architecture arm64:
[build]   "LLGL::ModuleMetal::GetModuleName()", referenced from:
[build]       LLGL::StaticModules::GetStaticModules() in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::GetRendererName(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::GetRendererID(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::AllocRenderSystem(LLGL::RenderSystemDescriptor const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleMetal::GetRendererID()", referenced from:
[build]       LLGL::StaticModules::GetRendererID(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleMetal::GetRendererName()", referenced from:
[build]       LLGL::StaticModules::GetRendererName(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleMetal::AllocRenderSystem(LLGL::RenderSystemDescriptor const*)", referenced from:
[build]       LLGL::StaticModules::AllocRenderSystem(LLGL::RenderSystemDescriptor const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleOpenGL::GetModuleName()", referenced from:
[build]       LLGL::StaticModules::GetStaticModules() in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::GetRendererName(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::GetRendererID(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::AllocRenderSystem(LLGL::RenderSystemDescriptor const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleOpenGL::GetRendererID()", referenced from:
[build]       LLGL::StaticModules::GetRendererID(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleOpenGL::GetRendererName()", referenced from:
[build]       LLGL::StaticModules::GetRendererName(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleOpenGL::AllocRenderSystem(LLGL::RenderSystemDescriptor const*)", referenced from:
[build]       LLGL::StaticModules::AllocRenderSystem(LLGL::RenderSystemDescriptor const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleVulkan::GetModuleName()", referenced from:
[build]       LLGL::StaticModules::GetStaticModules() in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::GetRendererName(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::GetRendererID(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]       LLGL::StaticModules::AllocRenderSystem(LLGL::RenderSystemDescriptor const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleVulkan::GetRendererID()", referenced from:
[build]       LLGL::StaticModules::GetRendererID(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleVulkan::GetRendererName()", referenced from:
[build]       LLGL::StaticModules::GetRendererName(LLGL::BasicStringLiteral<char, std::__1::char_traits<char>, std::__1::allocator<char>> const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build]   "LLGL::ModuleVulkan::AllocRenderSystem(LLGL::RenderSystemDescriptor const*)", referenced from:
[build]       LLGL::StaticModules::AllocRenderSystem(LLGL::RenderSystemDescriptor const&) in libLLGLD.a[66](StaticModuleInterface.cpp.o)
[build] ld: symbol(s) not found for architecture arm6

but when I add

if(LLGL_BUILD_RENDERER_VULKAN)
target_link_libraries(LLGL LLGL_Vulkan)
endif()

if(LLGL_BUILD_RENDERER_OPENGL)
target_link_libraries(LLGL LLGL_OpenGL)
endif()

if(LLGL_BUILD_RENDERER_DIRECT3D11)
target_link_libraries(LLGL LLGL_Direct3D11)
endif()

if(LLGL_BUILD_RENDERER_DIRECT3D12)
target_link_libraries(LLGL LLGL_Direct3D12)
endif()

if(LLGL_BUILD_RENDERER_METAL)
target_link_libraries(LLGL LLGL_Metal)
endif()

in the cmake it's only the first time where it fail with this error:

CMake Error: The inter-target dependency graph contains the following strongly connected component (cycle):
  "LLGL" of type SHARED_LIBRARY
    depends on "LLGL_OpenGL" (weak)
    depends on "LLGL_Metal" (weak)
  "LLGL_OpenGL" of type SHARED_LIBRARY
    depends on "LLGL" (weak)
    depends on "LLGL_Metal" (weak)
  "LLGL_Metal" of type SHARED_LIBRARY
    depends on "LLGL" (weak)
    depends on "LLGL_OpenGL" (weak)
At least one of these targets is not a STATIC_LIBRARY.  Cyclic dependencies are allowed only among static libraries.
CMake Generate step failed.  Build files cannot be regenerated correctly.

(the log from a ci https://github.com/coco875/test-llgl/actions/runs/13958466925/job/39075057293)

[LukasBanana]

Have you tried linking all active backends to your app when you're linking statically? Linking the base library against its backends will create a cyclic dependency because all backends always link against the core library.
You can also take a look at the main CMakeLists.txt file where this is mentioned:

LLGL/CMakeLists.txt

Line 799 in ab3bdfd

# Static libs must all be linked to the final apps (LLGL_BUILD_STATIC_LIB).

[coco875]

so like that ?

target_link_libraries(${PROJECT_NAME} PUBLIC LLGL)

if(LLGL_BUILD_RENDERER_VULKAN)
target_link_libraries(${PROJECT_NAME} PUBLIC LLGL_Vulkan)
endif()

if(LLGL_BUILD_RENDERER_OPENGL)
target_link_libraries(${PROJECT_NAME} PUBLIC LLGL_OpenGL)
endif()

if(LLGL_BUILD_RENDERER_DIRECT3D11)
target_link_libraries(${PROJECT_NAME} PUBLIC LLGL_Direct3D11)
endif()

if(LLGL_BUILD_RENDERER_DIRECT3D12)
target_link_libraries(${PROJECT_NAME} PUBLIC LLGL_Direct3D12)
endif()

if(LLGL_BUILD_RENDERER_METAL)
target_link_libraries(${PROJECT_NAME} PUBLIC LLGL_Metal)
endif()

I try and get at the end cannot find -lLLGL_Vulkan: No such file or directory (on mac it look like to have the same kind of issue), weirdly vulkan back-end are not build the first time, but at the second attempt it's build https://github.com/coco875/test-llgl/actions/runs/13972059454/job/39116153209

edit: a way to fix that is to set LLGL_BUILD_RENDERER_VULKAN in the cmakefile of llgl

[LukasBanana]

edit: a way to fix that is to set LLGL_BUILD_RENDERER_VULKAN in the cmakefile of llgl

Yes, because LLGL_BUILD_RENDERER_VULKAN is not enabled by default. We can change this once the Vulkan backend is no longer in an experimental state, but the backend is not stable enough at the moment.

[coco875]

yes, I know it experimental but set it outside of llgl it don't enable at every compilation. If I set it in llgl it work everytime, so there is some weird inconsistency.

[LukasBanana]

How exactly are you setting this value outside of LLGL?

[coco875]

like that:

find_package(Vulkan QUIET)
if (Vulkan_FOUND)
set(LLGL_BUILD_RENDERER_VULKAN ON)
else()
set(LLGL_BUILD_RENDERER_VULKAN OFF)
endif()
set(LLGL_BUILD_STATIC_LIB ON)

set(LLGL_OUTPUT_DIR ${CMAKE_BINARY_DIR})

if (CMAKE_GENERATOR MATCHES "Visual Studio")
    set(git_hide_output 2> nul)
endif()

# the patch to comment out LLGL_OUTPUT_DIR in the cmake of llgl (or force to set LLGL_BUILD_RENDERER_VULKAN on)
set(llgl_patch_file ${CMAKE_CURRENT_SOURCE_DIR}/cmake/llgl.patch)

# Applies the patch or checks if it has already been applied successfully previously. Will error otherwise.
set(llgl_apply_patch_if_needed git apply ${llgl_patch_file} ${git_hide_output} || git apply --reverse --check ${llgl_patch_file})

FetchContent_Declare(
    llgl
    GIT_REPOSITORY https://github.com/LukasBanana/LLGL.git
    GIT_TAG ab3bdfdf8fd54adb998be3f655b75b93ec153df6
    PATCH_COMMAND ${llgl_apply_patch_if_needed}
)
# fetch and configure it
FetchContent_MakeAvailable(llgl)

[LukasBanana]

Is this still an issue for you? I don't see anything actionable here from LLGL's side, but I'm also not familiar with FetchContent_Declare() and FetchContent_MakeAvailable() CMake commands.

[coco875]

yes it's still an issue but it's weird this inconsistency with set. I am not so much familliar with this two command.

[LukasBanana]

I'm looking at this again and I think the problem might be that you link the submodules of LLGL against your project when building as shared library:
https://github.com/coco875/test-llgl/blob/bb3684ba8d8be5a1ef3e7a63c434ef857134da16/CMakeLists.txt#L136
You should always only link against the core library (e.g. libLLGL.dylib on Mac).

This dependency from your CI log looks definitely wrong:

  "LLGL_Metal" of type SHARED_LIBRARY
    depends on "LLGL" (weak)
    depends on "LLGL_OpenGL" (weak)

The Metal submodule should never depend on the OpenGL submodule and vice-versa.

[coco875]

I try to build it as a static lib

[coco875]

I will re-dive into this the next week to provide more detail

[coco875]

ok after some research I found multiple thing:

• when I build in static LLGL_OpenGL.a are not added to the final without a link_libraries(LLGL_OpenGL), else it make this error:

[build] /usr/bin/ld : libLLGLD.a(StaticModuleInterface.cpp.o) : dans la fonction « LLGL::StaticModules::GetStaticModules[abi:cxx11]() » :
[build] /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:97:(.text+0x59) : référence indéfinie vers « LLGL::ModuleOpenGL::GetModuleName() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:97:(.text+0x7b) : référence indéfinie vers « LLGL::ModuleNull::GetModuleName() »
[build] /usr/bin/ld : libLLGLD.a(StaticModuleInterface.cpp.o) : dans la fonction « LLGL::StaticModules::GetRendererName(LLGL::BasicStringLiteral<char, std::char_traits<char>, std::allocator<char> > const&) » :
[build] /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:106:(.text+0x1c0) : référence indéfinie vers « LLGL::ModuleNull::GetModuleName() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:106:(.text+0x1db) : référence indéfinie vers « LLGL::ModuleNull::GetRendererName() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:110:(.text+0x1e2) : référence indéfinie vers « LLGL::ModuleOpenGL::GetModuleName() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:110:(.text+0x1fd) : référence indéfinie vers « LLGL::ModuleOpenGL::GetRendererName() »
[build] /usr/bin/ld : libLLGLD.a(StaticModuleInterface.cpp.o) : dans la fonction « LLGL::StaticModules::GetRendererID(LLGL::BasicStringLiteral<char, std::char_traits<char>, std::allocator<char> > const&) » :
[build] /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:149:(.text+0x239) : référence indéfinie vers « LLGL::ModuleNull::GetModuleName() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:149:(.text+0x254) : référence indéfinie vers « LLGL::ModuleNull::GetRendererID() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:153:(.text+0x25b) : référence indéfinie vers « LLGL::ModuleOpenGL::GetModuleName() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:153:(.text+0x276) : référence indéfinie vers « LLGL::ModuleOpenGL::GetRendererID() »
[build] /usr/bin/ld : libLLGLD.a(StaticModuleInterface.cpp.o) : dans la fonction « LLGL::StaticModules::AllocRenderSystem(LLGL::RenderSystemDescriptor const&) » :
[build] /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:192:(.text+0x2b2) : référence indéfinie vers « LLGL::ModuleNull::GetModuleName() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:192:(.text+0x2d4) : référence indéfinie vers « LLGL::ModuleNull::AllocRenderSystem(LLGL::RenderSystemDescriptor const*) »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:196:(.text+0x2db) : référence indéfinie vers « LLGL::ModuleOpenGL::GetModuleName() »
[build] /usr/bin/ld : /home/coco/Documents/GitHub/2ship2harkinian/build/_deps/llgl-src/sources/Renderer/StaticModuleInterface.cpp:196:(.text+0x2fd) : référence indéfinie vers « LLGL::ModuleOpenGL::AllocRenderSystem(LLGL::RenderSystemDescriptor const*) »
[build] collect2: erreur: ld a retourné le statut de sortie 1

it's in french but it's just say "undefine reference to" (normal because LLGL_OpenGL.a are not include.

• there is also a problem of static linking my order after are LLGL_OpenGL.a before LLGL.a who still reproduce the problem above it's why target_link_libraries(LLGL LLGL_OpenGL) fix it but make cycle dependancy (I guess not a problem in static).

[LukasBanana]

When you link LLGL statically against your project, you need to link all libraries against your project, not just LLGL.
When you link LLGL dynamically against your project, you only link the core library (libLLGL.a on Unix, LLGL.lib on Win32) against your project which then loads the other libraries at runtime.

Don't create these cyclic dependencies. LLGL does not depend on LLGL_OpenGL but the other way around.

This is handled via the LLGL_MODULE_LIBS variable in the CMake scripts for all example projects (see CMakeLists.txt:810)

[coco875]

just linking lib like that make an error https://github.com/coco875/test-llgl/blob/c7931e08f2c16ab9cbcf2506451eeec667255521/CMakeLists.txt#L119-L143

if(LLGL_BUILD_RENDERER_NULL)
link_libraries(LLGL_Null)
endif()

if(LLGL_BUILD_RENDERER_VULKAN)
link_libraries(LLGL_Vulkan)
endif()

if(LLGL_BUILD_RENDERER_OPENGL)
link_libraries(LLGL_OpenGL)
endif()

if(LLGL_BUILD_RENDERER_DIRECT3D11)
link_libraries(LLGL_Direct3D11)
endif()

if(LLGL_BUILD_RENDERER_DIRECT3D12)
link_libraries(LLGL_Direct3D12)
endif()

if(LLGL_BUILD_RENDERER_METAL)
link_libraries(LLGL_Metal)
endif()

link_libraries(LLGL)

https://github.com/coco875/test-llgl/actions/runs/15272227435/job/42950286382

[coco875]

also try to directly use LLGL_MODULE_LIBS but didn't get a better sucess