cmake - 如何使用不同的 3rd-party 库构建 cmake 项目

问题描述

我是 cmake 的新手，并尝试创建一个需要一些 3rd-party 库的小项目。我希望将库作为 git repos 始终保持最新。一些库只是 .cpp 和 .hpp 文件（glad、imgui），而其他库是 cmake 项目（glfw、glm）。

这个想法是拥有一个将所有库作为一种子项目的第 3 方项目和一个使用库和包含等的沙盒项目。我想使用现代 cmake 代码，它不会在框架结构之外安装任何东西。

文件夹结构：

Framework
|--3rd_party
|  |--glad
|  |  |--include
|  |  |--src
|  |--glfw-master
|  |  |--...
|  |  |--CMakeLists.txt
|  |--glm-master
|  |  |--..
|  |  |--CMakeLists.txt
|  |--imgui-master
|  |  |--*.cpp
|  |  |--*.hpp
|  |  |--examples
|  |  |  |--*.cpp
|  |  |  |--*.hpp
|  |--CMakeLists.txt
|--sandbox
|  |--main.cpp
|  |--CMakeLists.txt
|--CMakeLists.txt

所以我创建了这个文件夹结构以及一些 CMakeLists：

CMakeLists.txt（框架）

cmake_minimum_required(VERSION 3.10)

project(Framework)

add_subdirectory("3rd_party")
add_subdirectory("sandbox")

CMakeLists.txt (3rd_party)

#GLFW
set(GLFW_BUILD_DOCS OFF CACHE BOOL "" FORCE)
set(GLFW_BUILD_TESTS OFF CACHE BOOL "" FORCE)
set(GLFW_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
add_subdirectory(glfw-master)

# GLM
set(GLM_TEST_ENABLE OFF CACHE BOOL "" FORCE)
add_subdirectory(glm-master)

# Glad
add_library(
    Glad STATIC
    "glad/src/glad.c"
)

target_include_directories(Glad PUBLIC "glad/include")

# ImGui
add_compile_definitions(IMGUI_IMPL_OPENGL_LOADER_GLAD=1)

set(IMGUI_SOURCES
    "imgui-master/imgui.cpp"
    "imgui-master/imgui_demo.cpp"
    "imgui-master/imgui_draw.cpp"
    "imgui-master/imgui_widgets.cpp"
    "imgui-master/examples/imgui_impl_glfw.cpp"
    "imgui-master/examples/imgui_impl_opengl3.cpp"
)

set(IMGUI_HEADERS
    "imgui-master/imconfig.h"
    "imgui-master/imgui.h"
    "imgui-master/imgui_internal.h"
    "imgui-master/imstb_rectpack.h"
    "imgui-master/imstb_textedit.h"
    "imgui-master/imstb_truetype.h"
    "imgui-master/examples/imgui_impl_glfw.h"
    "imgui-master/examples/imgui_impl_opengl3.h"
)

add_library(
    ImGui STATIC
    ${IMGUI_SOURCES}
    ${IMGUI_HEADERS}
)

target_include_directories(ImGui PUBLIC "imgui-master" "glfw-master/include" "glad/include")

CMakeLists.txt（沙盒）

project(Sandbox)

find_package(OpenGL REQUIRED)

add_executable(sandbox main.cpp)

# OpenGL
target_include_directories(Sandbox PUBLIC ${OPENGL_INCLUDE_DIR})
target_include_directories(Sandbox PUBLIC external)

# Glfw
target_include_directories(Sandbox PUBLIC "../3rd_party/glfw-master/include")

# Link libs
target_link_libraries(Sandbox PUBLIC
           ${OPENGL_LIBRARIES}
           "../3rd_party/glfw-master/src/Debug/glfw3"
           Glad
           ImGui
           glm_static
)

该代码有效，但不像我预期的那样。起初我知道这有点难看，也许有更好的方法来处理包含和源的路径，但更大的问题是项目结构。例如，当我为 ms vs studio 构建它时，我有三个解决方案

./framework.sln
./sandbox/sandbox.sln
./3rd_party/glfw-master/glfw.sln

很高兴，glm 和 imgui 是 sandbox.sln 的一部分

我想要的是一个包含两个子解决方案沙箱和 3rd_party 的解决方案，它也有所有库的子解决方案或项目。

那么有可能吗？如果是的话，我怎么能用cmake创建这样的结构？

标签： cmake

解决方案

在进一步调查和 CMake 的大量尝试和错误之后，我想我是从错误的期望和一些误解开始的。

不可能从 CMake 文件中为 Visual Studio 获得有用的解决方案/项目结构，因为所有 CMake 项目都将生成 VS 解决方案，并且所有 add_library 或 add_executable 都将是 VS 项目。如果我想为我的框架创建一个 CMake 项目并将 GLFW 添加为第三方，这也会创建一个 CMake 项目，它将以两个不同的 VS 解决方案结束，并且结构消失了。我认为这就是为什么微软在 Visual Studio 中为 CMake 文件引入了一个特殊的开放上下文。

如果使用此上下文打开项目，“解决方案”查看器会显示项目的文件夹结构。这或多或少是我一开始所期望的。

还有一个选项可以切换视图以查看所有 CMake 目标（exec、libs、...）。

我还“升级”了我的 CMakeLists。我使用不同的方式添加第三方库：

带有 CMakeLists（如 GLFW）的库的 add_subdirectory
add_library 和 INTERFACE 用于诸如 glm 之类的仅标头库
add_library STATIC 用于像 ImGui 这样的静态库（在我的情况下）

沙盒的包含由库的公共接口提供，构建/依赖顺序由 target_link_libraries 中的顺序给出。

我希望这是有帮助的，并会节省你很多时间；）

干杯! 老板0r