如何将CMake库添加至qmake项目？现有项目整合最佳方式咨询

嘿，我来帮你搞定把CMake构建的库整合进qmake项目这件事——其实分两种常见场景，我一步步给你说清楚，还有长期维护的最佳实践：

如果已经拿到别人编译好的CMake库产物，直接在qmake里配置路径和链接就行：

• 先确认库的核心文件位置：一般会有include目录（存放头文件）和lib/bin目录（存放静态库.a/.lib或动态库.so/.dll/.dylib）。

• 在你的qmake.pro文件里添加配置：
  首先指定头文件搜索路径：

  INCLUDEPATH += /absolute/path/to/cmake-lib/include
  

  然后链接库文件：

  • 静态库：用-L指定库目录，-l后跟库名（注意去掉前缀lib和后缀）

    LIBS += -L/absolute/path/to/cmake-lib/lib -lyourlibname
    

  • 动态库：Windows下可以直接指定dll路径，或者同样用-L+-l；Linux/macOS只要库路径在系统搜索路径里，或者用-L指定就行。

  举个实际例子：我有个叫mathutils的CMake库，编译后放在~/projects/mathutils-build，那.pro里这么写：

  INCLUDEPATH += ~/projects/mathutils-build/include
  LIBS += -L~/projects/mathutils-build/lib -lmathutils
  

如果希望项目能自动构建依赖的CMake库，避免手动编译和版本不一致的问题，这是长期维护的最优方案：

• 第一步，把CMake库源码整合到项目里：可以用Git子模块（推荐），或者直接把源码放在项目的thirdparty目录下。比如用子模块的话，终端执行：

  git submodule add https://github.com/xxx/mathutils.git thirdparty/mathutils
  

• 第二步，在.pro文件里添加自动构建逻辑：
  先定义构建目录，然后调用CMake和编译工具完成构建：

  # 定义库的构建目录，用$$PWD确保路径是相对当前.pro文件的
  MYLIB_BUILD_DIR = $$PWD/thirdparty/mathutils-build
  # 自动创建构建目录（跨平台兼容写法）
  system(mkdir -p $$MYLIB_BUILD_DIR 2>/dev/null)
  # 根据qmake的Debug/Release配置，同步CMake的构建类型
  CONFIG(release, debug|release): MYLIB_BUILD_TYPE = Release
  CONFIG(debug, debug|release): MYLIB_BUILD_TYPE = Debug
  # 运行CMake配置
  system(cd $$MYLIB_BUILD_DIR && cmake $$PWD/thirdparty/mathutils -DCMAKE_BUILD_TYPE=$$MYLIB_BUILD_TYPE)
  # 编译库（Linux/macOS用make，Windows可以换成msbuild或ninja）
  system(cd $$MYLIB_BUILD_DIR && make -j$$NUMBER_OF_PROCESSORS)
  

• 第三步，链接构建好的库：和预编译场景一样，指向构建目录里的产物：

  INCLUDEPATH += $$MYLIB_BUILD_DIR/include
  LIBS += -L$$MYLIB_BUILD_DIR/lib -lmathutils
  

• 额外优化：添加预构建依赖，确保每次编译项目前先更新库：

  # 根据平台和库类型调整路径，比如Linux静态库是libmathutils.a
  PRE_TARGETDEPS += $$MYLIB_BUILD_DIR/lib/libmathutils.a
  

• 优先选择源码自动构建：避免手动管理预编译库的版本、平台兼容问题，团队协作时更省心。
• 跨平台适配：在.pro里根据CONFIG区分Debug/Release，根据QMAKE_TARGET.os区分Windows/Linux/macOS，调整编译命令和库路径。
• 动态库运行时适配：Windows下需要把动态库复制到可执行文件目录，可以用qmake的COPY_FILES：

  CONFIG(release, debug|release): MYLIB_DLL = $$MYLIB_BUILD_DIR/bin/mathutils.dll
  CONFIG(debug, debug|release): MYLIB_DLL = $$MYLIB_BUILD_DIR/bin/mathutilsd.dll
  COPY_FILES += $$MYLIB_DLL $$DESTDIR
  

• 避免硬编码路径：全部用qmake内置变量（比如$$PWD、$$DESTDIR），项目移动位置也不用改配置。

内容的提问来源于stack exchange，提问作者zhjh