CMake 基本用法

最新推荐文章于 2025-06-04 14:35:58 发布

perception_

最新推荐文章于 2025-06-04 14:35:58 发布

阅读量423

点赞数 1

CC 4.0 BY-SA版权

分类专栏： cmake 文章标签： cmake

本文链接：https://blog.youkuaiyun.com/perception_/article/details/77603043

cmake 专栏收录该内容

2 篇文章

订阅专栏

本文介绍CMake的基础用法，包括创建基本的CMakeLists文件、添加子目录、使用目标文件的安装方法、添加库文件及如何链接外部共享库和头文件等内容。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1. 最基本的CMakeLists 文件

# 它将 main.c 编译为 hello 的可执行文件
PROJECT (HELLO)    # 项目名称
SET(SRC_LIST main.c)   # 源文件
ADD_EXECUTABLE(hello ${SRC_LIST})  # 可执行文件

Cmake 是强烈推荐外部编译的，内部编译会生成一些无法自动删除的中间文件。使用 cmake [CMakeLists.txt path] 进行编译，会生成Makefile等文件，在此执行 make, 即可生成可执行文件。

2. 添加子文件

可以使用ADD_SUBDIRECROTY(source_dir [binary_dir][EXCLUDE_FROM_ALL])来添加下一层的 CMakeLists.txt, 并指定目录.

ADD_SUBDIRECTORY(src bin) # 将 src目录编译为 bin 目录

另外可以都可以通过 SET 指令重新定义 EXECUTABLE_OUTPUT_PATH 和 LIBRARY_OUTPUT_PATH 变量来指定最终的目标二进制的位置(指最终生成的 hello 或者最终的共享库，不包含编译生成的中间文件)

SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

3. 使用目标文件的安装:

目标文件的安装

INSTALL(TARGETS myrun mylib mystaticlib
   RUNTIME DESTINATION bin  # 可执行二进制库
   LIBRARY DESTINATION lib  # 动态库
   ARCHIVE DESTINATION libstatic  # 静态库
)

普通文件的安装
```
INSTALL(FILES README DESTINATION share)
```

目录的安装

INSTALL(DIRECTORY icons scripts/ DESTINATION share/myproj)  

# icons 文件夹 scripts 目录下的所有文件

如果你要直接安装到系统，可以使用如下指令:

cmake -DCMAKE_INSTALL_PREFIX=/usr ..

4. 添加库

   ADD_LIBRARY(hello SHARED ${LIBHELLO_SRC})
   # SHARED，动态库
   # STATIC，静态库
   # MODULE，在使用 dyld 的系统有效，如果不支持 dyld，则被当作 SHARED 对待
   # 更新库版本号
   SET_TARGET_PROPERTIES(hello PROPERTIES VERSION 1.2 SOVERSION 1) 
   # VERSION 指代动态库版本，SOVERSION 指代 API 版本

5. 使用外部共享库和头文件

INCLUDE_DIRECTORIES([AFTER|BEFORE] [SYSTEM] dir1 dir2 ...) # 添加头文件包含路径
TARGET_LINK_LIBRARIES(target library1 library2...) # 为 target 添加共享库

6. 其它

设置最小的CMake 版本
```
cmake_minimum_required(VERSION 3.1.0)
```

限定使用 C++11


# Use C++11

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
message(STATUS "C++11 support has been enabled by default.")

常见的变量

CMAKE_CURRENT_SOURCE_DIR  # 当前 CMakeLists 所在路径