How do I use this in my project? (how do cmake?)

[RenaKunisaki]

I'm using cmake already but I know very little about it. I don't understand what I need to add to my CMakeLists.txt to be able to use qlib.

So far I have:

set(Q_DIR ${CMAKE_CURRENT_LIST_DIR}/external/Q)
FetchContent_Declare(Q
    GIT_REPOSITORY "https://github.com/cycfi/q.git"
    SOURCE_DIR ${Q_DIR}
)
FetchContent_MakeAvailable(Q)
add_library(Q OBJECT ${Q_sources})
target_include_directories(Q PUBLIC
    ${Q_DIR}/q_lib/include
)

but this fails because Q_sources is empty. Am I supposed to manually add some source files? (I thought FetchContent would fill that variable in.)

Without the add_library line, it fails because "Cannot specify include directories for target "Q" which is not built by this project". I can "fix" that by adding ${Q_DIR}/q_lib/include to BASE_DIRS in target_sources instead, but then it fails to find infra/support.hpp. Also this feels like the wrong approach because other libraries (imgui, SDL3) don't make me do that.

Here's the entire CMakeLists.txt, there are probably several more problems:
CMakeLists.txt

[djowel]

Please follow the Setup and Installation.

Also, q_lib is header-only, so you should not create your own Q target from Q_sources. Just fetch the project and link your executable against libq.

For example:

include(FetchContent)

set(Q_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
set(Q_BUILD_TEST OFF CACHE BOOL "" FORCE)
set(Q_BUILD_IO OFF CACHE BOOL "" FORCE)

FetchContent_Declare(
  q
  GIT_REPOSITORY https://github.com/cycfi/q.git
  GIT_TAG master
  GIT_SUBMODULES_RECURSE ON
)
FetchContent_MakeAvailable(q)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE libq)

I cannot provide a full CMake tutorial here, but the snippet above should point you in the right direction.