如何在CMake构建可执行文件时自动编译关联依赖库？

使用CMake ExternalProject_Add #

• 核心逻辑：在项目构建流程中自动完成外部依赖库的克隆、编译与安装，完全满足「不移动库目录、不修改仓库内容、项目独立」的限制
• 具体配置步骤：
  1. 在项目根目录的CMakeLists.txt中引入ExternalProject模块：

     include(ExternalProject)
     

  2. 定义外部依赖库的构建规则（以名为foo_lib的Git仓库为例）：

     ExternalProject_Add(
       foo_lib
       GIT_REPOSITORY https://github.com/xxx/foo_lib.git  # 替换为实际Git仓库地址
       GIT_TAG v1.0.0  # 指定依赖的版本标签、分支或commit哈希
       PREFIX ${CMAKE_BINARY_DIR}/external/foo_lib  # 依赖库的临时构建目录
       CMAKE_ARGS -DCMAKE_INSTALL_PREFIX=${CMAKE_BINARY_DIR}/external/install/foo_lib  # 库的安装路径
                  -DBUILD_SHARED_LIBS=ON  # 强制生成动态库
     )
     

     若需多个项目共享编译后的库文件，可将CMAKE_INSTALL_PREFIX设为全局路径（如~/shared_external_libs/foo_lib），避免重复编译
  3. 关联项目可执行文件与依赖库：

     # 定义项目自身的可执行文件
     add_executable(my_project main.cpp)
     
     # 确保依赖库编译完成后再构建项目
     add_dependencies(my_project foo_lib)
     
     # 添加依赖库的头文件路径
     target_include_directories(my_project PRIVATE ${CMAKE_BINARY_DIR}/external/install/foo_lib/include)
     
     # 指定依赖库的链接路径并完成链接
     target_link_directories(my_project PRIVATE ${CMAKE_BINARY_DIR}/external/install/foo_lib/lib)
     target_link_libraries(my_project PRIVATE foo)  # 替换为实际库名（如libfoo.so对应foo，foo.dll对应foo）
     

关于add_subdirectory失败的原因 #

add_subdirectory要求依赖库源码处于项目目录结构内，或需手动指定固定绝对路径，无法自动克隆外部Git仓库，也难以实现多项目共享编译产物，因此不适合你的场景。

生成DLL替代SO #

• 在配置外部依赖库时，通过CMAKE_ARGS传递-DBUILD_SHARED_LIBS=ON参数，若依赖库的CMakeLists支持该标准参数，Windows环境下会自动生成DLL，Linux下生成SO
• 若依赖库使用自定义开关控制动态库生成，需替换为对应参数（如-DBUILD_FOO_SHARED=ON）

生成EXE替代Linux二进制文件 #

有两种主流实现方式：

• Windows本地构建：使用Visual Studio作为CMake生成器，命令行示例：

  cmake -G "Visual Studio 17 2022" -A x64 ..
  cmake --build . --config Release
  

  构建完成后会在对应目录生成EXE与DLL文件
• Linux交叉编译至Windows：使用MinGW工具链，在项目的CMakeLists开头添加工具链配置：

  set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
  set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++)
  set(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres)
  set(CMAKE_SYSTEM_NAME Windows)
  

  之后正常执行cmake构建流程，即可生成Windows平台的EXE与DLL

跨平台注意事项 #

• 避免硬编码库后缀，改用CMake内置变量${CMAKE_SHARED_LIBRARY_SUFFIX}（自动适配.so/.dll）
• 若依赖库未处理Windows下的符号导出，需确认维护团队的CMake配置已包含__declspec(dllexport)相关逻辑，否则DLL无法正常被链接

内容的提问来源于stack exchange，提问作者Ravshan S.K.