CMake怎么构建动态库?

云枫君_5397

云枫君_5397

2026-08-09

165人浏览

原创

cmake构建动态库必须使用add_library(... shared),漏写shared将生成静态库或报错;linux生成libxxx.so,windows生成xxx.dll,需配合target_include_directories、set(library_output_path)、install(targets ... library)等设置头文件路径、输出位置和安装规则。

cmake怎么构建动态库?

add_library(... SHARED) 是构建动态库的唯一正确写法

不是用 add_executable,也不是靠改后缀或权限位,CMake 构建动态库必须显式使用 add_library 并指定 SHARED 类型。漏掉这个关键字,哪怕源文件全对、路径全通,最终生成的仍是静态库或报错。

常见错误现象包括:libxxx.a 被意外生成(误用了 STATIC),或者链接时报 undefined reference to `dlopen'(根本没走动态链接流程)。

  • SHARED 在 Linux 下生成 libxxx.so,在 Windows 下生成 xxx.dll(不带 lib 前缀),macOS 下生成 libxxx.dylib
  • 库名只需写 xxx,前缀和后缀由 CMake 自动补全,硬写 libcalc.so 会导致构建失败
  • 如果源文件中含 Windows 导出符号(如 __declspec(dllexport)),需配合预定义宏(如 MYLIB_EXPORT)控制编译行为,否则 Linux 下可忽略

头文件路径和库输出路径必须显式设置

默认情况下,add_library(calc SHARED ...) 只管编译,不负责头文件暴露和产物落盘位置。不设 include_directories,调用方找不到声明;不设输出路径,生成的 .so 可能落在 build/CMakeFiles/... 深层目录里,难以定位和安装。

推荐做法是分两处控制:

  • include_directories(${PROJECT_SOURCE_DIR}/include) 或更现代的 target_include_directories(calc PUBLIC ${PROJECT_SOURCE_DIR}/include) 暴露头文件
  • set(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib) 统一指定动态库输出根目录(注意:不是 EXECUTABLE_OUTPUT_PATH,后者只影响可执行文件)
  • 避免用 file(GLOB ...) 收集源文件——它不触发增量重编译,改了 .cpp 但没改 CMakeLists.txt 时容易漏更新

动态库链接时 target_link_libraries 的顺序和作用域很关键

构建完动态库只是第一步,调用它的可执行目标必须正确链接。错用 target_link_libraries(myapp calc) 往往失败,原因常出在作用域和依赖传递上。

C++ 算法竞赛自动化测试数据生成与校验框架
C++ 算法竞赛自动化测试数据生成与校验框架

根据原题生成新题面、验证器及完整测试数据,自动套用 testlib 模板,用于用户要求生成测试数据时。

下载

典型问题:

  • 如果 calc 库没导出其依赖(比如它自己又用了 pthread),而你只写 target_link_libraries(myapp calc),链接时可能报 undefined reference to `pthread_create'
  • 在子目录中定义的库(如 add_subdirectory(lib)),主 CMakeLists.txt 中直接写 calc 会找不到目标——必须确保 add_library(calc SHARED ...) 已执行且未加 EXCLUDE_FROM_ALL
  • 正确写法应为:target_link_libraries(myapp PRIVATE calc),其中 PRIVATE 表示仅 myapp 内部使用该链接,不向其依赖者透传

install() 不是可选项,而是部署前提

不加 install(),动态库就只是构建产物,无法被系统级查找(ldconfig)、无法被其他项目 find_package() 发现、也无法打包发布。

最简可用的安装配置:

  • install(TARGETS calc LIBRARY DESTINATION lib) —— 安装动态库到 /usr/local/lib(或前缀指定路径下的 lib
  • install(DIRECTORY ${PROJECT_SOURCE_DIR}/include/ DESTINATION include) —— 同步安装头文件
  • 若省略 LIBRARY 关键字而写成 install(TARGETS calc DESTINATION lib),Linux 下会安装到 lib,但 macOS 可能落到 lib,Windows 落到 bin,跨平台行为不一致

真正麻烦的是运行时找不到库:即使编译链接全过,./myapp 运行时仍可能报 error while loading shared libraries: libcalc.so: cannot open shared object file。这不是 CMake 问题,而是 LD_LIBRARY_PATHrunpath 没配好——这点最容易被忽略,也最难调试。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

2025.10.17

5266

15

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.23

1371

14

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

2025.12.13

314

18

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

0

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

0

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

2026.09.20

20

13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习

CMake 保姆级教程
CMake 保姆级教程

共0课时 | 0人学习