CMake怎么把多个cpp文件打包编译成动态链接库

夏枫酱_7904

夏枫酱_7904

2026-10-08

766人浏览

原创

必须显式列出所有.cpp文件或用file(glob)收集源码,禁用aux_source_directory;导出符号需加-fvisibility=hidden及__attribute__((visibility("default")));链接时用target_link_libraries并配置运行时库路径。

cmake怎么把多个cpp文件打包编译成动态链接库

直接用 add_library 指定 SHARED 类型,并把所有 cpp 文件列进去,就能打包成动态库。关键不是“能不能”,而是“怎么列、怎么导出、怎么链接时不踩坑”。

如何在 CMakeLists.txt 中声明多个源文件的动态库

必须显式列出所有参与编译的 .cpp 文件(或用 aux_source_directory 收集),不能只写目录名。CMake 不会自动递归扫描子目录。

  • add_library(mylib SHARED a.cpp b.cpp c.cpp) —— 最稳妥,推荐用于小项目
  • file(GLOB SOURCES "src/*.cpp") + add_library(mylib SHARED ${SOURCES}) —— 注意:GLOB 不支持增量构建,改了文件但没改 CMakeLists.txt 时可能漏编译
  • 不要用 aux_source_directory(src DIR_SRCS) 配合 add_library(mylib SHARED ${DIR_SRCS}) —— 它不处理子目录,且容易混入非源文件(比如测试文件)

为什么编译出来的 .so 里找不到函数?导出符号是关键

Linux 下默认不导出符号(不像 Windows 的 __declspec(dllexport)),所以即使编译成功,链接时也可能报 undefined reference,或者运行时报 dlsym: symbol not found。

CMake 4.3.2
CMake 4.3.2

CMake 4.3.2 Windows x86_64 历史版本安装包,适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。

下载
  • 加编译选项 -fvisibility=hidden(推荐)+ 在头文件中用 __attribute__((visibility("default"))) 标记要导出的函数或类
  • 或者简单粗暴:编译时加 -fPIC -shared 并确保没加 -fvisibility=hidden(但会导出所有符号,增大体积、有命名冲突风险)
  • 检查是否导出成功:nm -D libmylib.so | grep my_function —— 如果没输出,说明没导出

链接动态库时,-L 和 -l 顺序和路径必须匹配

CMake 里用 target_link_libraries 是安全的,但要注意作用域和依赖顺序。手动用 gcc 链接时最容易错。

  • target_link_libraries(myapp PRIVATE mylib) —— 前提是 mylib 是同一个 CMakeLists.txt 或 add_subdirectory 引入的目标;否则要先 find_library 或 find_package
  • 如果库不在标准路径(如 /usr/lib),要用 link_directories(/path/to/so),但更推荐用 target_link_directories(myapp PRIVATE /path/to/so)(CMake 3.13+)
  • 运行时报 error while loading shared libraries: libmylib.so: cannot open shared object file,说明 LD_LIBRARY_PATH 没包含库路径,或没运行 sudo ldconfig 刷新缓存

最常被忽略的是符号可见性控制和运行时库路径 —— 编译通过不代表函数真能被调用,得用 nm -D 和 ldd 实锤验证。

相关文章

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

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

下载

相关标签:

cmake

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

相关专题

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

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

2025.10.17

6046

15

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

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

2025.10.23

1511

14

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

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

2025.12.13

354

18

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

2026.10.08

0

20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

120

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

100

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

80

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

100

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 入门教程
Conan 2 入门教程

共0课时 | 0人学习

CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习