CMake 基本用法

最新推荐文章于 2025-10-20 14:40:29 发布
原创 最新推荐文章于 2025-10-20 14:40:29 发布 · 441 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#cmake

本文介绍CMake的基础用法，包括创建基本的CMakeLists文件、添加子目录、使用目标文件的安装方法、添加库文件及如何链接外部共享库和头文件等内容。
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 所在路径

    ​

嵌入式linux系统中CMake的基本用法
嵌入式技术开发
01-04 448
CMake 是一个跨平台的项目构建工具，通俗点说，它会帮你生成 Makefile 或其他编译系统需要的构建文件。
CMake 基础用法
zhbi98 的技术 Blogs
10-24 3851
CMake 基于平台分为两个版本，分别为命令行 CLI 版本，图形界面 GUI 版本。CLI 版本一般用于 Linux 系统中，GUI 版本易于在 Windows 系统中使用，当然 GUI 版本在 Windows 系统中同样也可以使用命令行操作。对于 GUI 版本 CMake 来说图形界面图形化操作可以替代 CMake 的控制命令来操作 CMake。
CMake基本使用总结
weixin_43604792的博客
01-14 567
CMake 文件名格式和用法 cmake文件的文件名必须是CMakeLists.txt，文件名大小写相关，如果一个工工程中有多个目录，每个目录中都必须有一个CMakeLists.txt文件 语法 示例代码一 编写CMakeLists.txt cmake_minimum_required(version 2.8) # 版本号 project(HELLO) ...
【CMakeLists.txt】CMake C++ 标准配置组合详解
最新发布
weixin_43219667的博客
10-20 535
这个命令用于设置 C++ 编译标准，告诉 CMake 使用 C++17 标准来编译项目。这个设置是现代 CMake 项目中的基本配置，确保代码使用一致的 C++ 标准进行编译。
CMake用法详解 使用方法说明
08-13
CMake 用法详解，简单描述了CMake 的使用方法，通过简单的例子
CMAKE基础使用
liumengyang1992的博客
03-25 620
1、目录结构： 2、顶层cmake内容： cmake_minimum_required(VERSION 3.0) //开头，指定cmake的最低版本要求 set(LIB_DIR ./libs) //设置生成的库的路径 set(OUTPUT_DIR ${CMAKE_CURRENT_SOURCE_DIR}/install) //创建install文件夹 //LIBRARY_OUTPUT_PATH cmake的环境变量，自动把生成的库拷贝到 ${OUTPUT_DIR}/lib文件夹下面 set(LIBRAR
cmake基本用法
Summit的专栏
10-29 1541
cmake基本用法我们编写一个C++单例类，使用cmake构建项目，主要是为了记录一下cmake的基本用法。 首先项目文件夹为DemoProject,我们创建一个main.cpp作为我们的主文件，创建一个子文件夹Singleton,在Singleton中创建Singleton.h和Singleton.cpp作为我们的单例类。代码如下，很简单，就是获取一个单例然后调用它的函数：main.cpp#in
cmake入门使用方法
04-17
对于初学者来说，理解CMake的基本概念和用法是至关重要的。本篇文章将深入浅出地介绍CMake的基本知识，帮助你快速入门。 ### 1. CMake简介 CMake是一个开源的构建系统，它的目标是简化跨平台项目的构建过程。它不...
精选资源
cmake_demo:显示基本 cmake 用法的演示项目
07-12
显示基本 cmake 用法的演示项目 用法 cmake -DCMAKE_BUILD_TYPE=Debug ../ cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_C_FLAGS=-m32 -DCMAKE_CXX_FLAGS=-m32 ../ CFLAGS=-m32 CXXFLAGS=-m32 cmake -DCMAKE_BUILD_...
Cmake的基本使用
weixin_46053662的博客
05-08 2489
这篇文章主要介绍的是CMake相关的语法，如果刚开始接触CMake，并对此有所兴趣的话，建议看看这篇文章：为什么需要CMake？CMake是开源、跨平台的构建工具，可以让我们通过编写简单的配置文件去生成本地的Makefile，这个配置文件是独立于运行平台和编译器的，这样就不用亲自去编写Makefile了，而且配置文件可以直接拿到其它平台上使用，无需修改，非常方便。
CMake 基础使用
zws466460939的专栏
07-19 532
使用Ubuntu系统进行相关学习，具体信息如下。
一文搞定CMake的使用
weixin_63260810的博客
05-13 3992
cmake使用教程
CMAKE基本使用
yinxingtianxia的博客
05-31 388
参考几个有用的博客：
CMake 基本使用
weixin_39354845的博客
01-23 1237
Cmake 使用
cmake基本使用(一)
m0_66518901的博客
10-04 2087
target>：目标名，如 MyApp、MyLib<prop>：属性名，例如 OUTPUT_NAME、VERSION<value>：属性值也可以同时设置多个目标：例子:示例 1：私有宏仅 myapp 编译时启用 DEBUG_MODE#ifdef DEBUG_MODE 仅对 myapp 内的源文件有效示例 2：公共宏mylib 内生效任何链接了 mylib 的目标也会自动启用 USE_FEATURE。
cmake使用方式
qq_62737390的博客
01-17 800
研一上学期的学习和ros打了很多交道，对于ros的功能包的cmakelist的文件感觉理解并不是很深刻，每次只知道应该这样改，但是并不知道为什么。这样当使用别人的功能包的时候就会报错，花很多时间解决，但是其实自己并不是特别理解为什么可以这样解决。所以，昨天大概系统学习了一下cmake，这里记录一下。
【CMake的入门使用】
m0_58235748的博客
07-11 637
CMake 可以编译源代码、制作程序库、产生适配器（wrapper）、还可以用任意的顺序建构执行档。CMake 支持 in-place 建构（二进档和源代码在同一个目录树中）和 out-of-place 建构（二进档在别的目录里），因此可以很容易从同一个源代码目录树中建构出多个二进档。CMake 也支持静态与动态程式库的建构。
CMake的使用
qq_67582098的博客
05-31 2232
cmake的使用
cmake基本项目编写
08-26
<think>我们正在学习如何编写一个基本的CMake项目。根据引用内容，我们可以总结出CMake的基本使用流程和关键概念。 目标：创建一个基本的CMake项目，包含以下步骤： 1. 创建项目目录和源文件 2. 编写CMakeLists.txt文件 3. 配置项目（生成构建系统） 4. 构建项目（编译） 5. 运行可执行文件 下面我们以一个简单的“Hello World”项目为例。 步骤1：创建项目结构 假设项目名为`hello_cmake`，目录结构如下： ``` hello_cmake/ ├── CMakeLists.txt # CMake配置文件 └── src/ └── main.cpp # 源代码 ``` 步骤2：编写源代码（main.cpp） ```cpp #include <iostream> int main() { std::cout << "Hello, CMake!" << std::endl; return 0; } ``` 步骤3：编写CMakeLists.txt 在项目根目录（hello_cmake/）下创建CMakeLists.txt文件，内容如下： ```cmake # 设置CMake最低版本要求 cmake_minimum_required(VERSION 3.10) # 设置项目名称 project(hello_cmake) # 添加可执行目标：将源文件编译为可执行文件 add_executable(hello_cmake src/main.cpp) ``` 步骤4：配置项目（生成构建系统） 在项目根目录下，创建一个构建目录并进入，然后运行cmake命令： ```bash mkdir build cd build cmake .. ``` 以上命令会生成构建系统（例如Makefile）。 步骤5：构建项目（编译） 在build目录下运行构建命令： ```bash cmake --build . # 使用CMake进行构建（跨平台） # 或者使用生成的构建系统（如make） make ``` 步骤6：运行程序 在build目录下运行生成的可执行文件： ```bash ./hello_cmake ``` 输出：`Hello, CMake!` 补充说明： 1. 引用[4]中提供了更简洁的命令： - `cmake -B build`：直接在项目根目录下创建build目录并生成构建系统（无需手动创建build目录） - `cmake --build build -j4`：构建项目，使用4个并行任务 2. 关于CMakeLists.txt的说明： - `cmake_minimum_required`：指定CMake的最低版本，确保兼容性。 - `project(hello_cmake)`：设置项目名称，同时会定义一些变量，如`PROJECT_NAME`。 - `add_executable(target_name source_files)`：指定从源文件生成可执行文件。 3. 引用[3]提到CMake的特点：跨平台，可生成多种构建系统（如Makefile、Visual Studio工程等）。 4. 引用[1]和[2]介绍了CMake的基本流程和编写CMakeLists.txt的简单示例。 5. 引用[5]提到了安装（make install）和测试（make test）的功能，但本示例暂不涉及。 通过以上步骤，我们就完成了一个最基本的CMake项目。 注意：在实际项目中，我们可能还需要设置C++标准、添加头文件路径、链接库等，这些可以在后续学习中逐步掌握。 为了巩固学习，可以尝试以下扩展： 1. 在项目中添加多个源文件（如`src/hello.cpp`和`src/hello.h`），并在`main.cpp`中包含头文件，然后修改CMakeLists.txt以包含新的源文件。 2. 设置C++标准：在CMakeLists.txt中添加`set(CMAKE_CXX_STANDARD 11)`（或其他标准）来指定C++版本。 参考文献： [^1]: 初识CMake，如何编写一个CMake工程（上） [^2]: 如何编写一个cmake [^3]: CMake基础教程（1）什么是cmake [^4]: 用法 cmake -B build [^5]: 初识CMake，如何编写一个CMake工程（下）</think>### CMake基础教程：如何编写一个基本的CMake项目 #### 一、CMake核心概念 1. **CMake是什么** - 跨平台构建工具，可生成Makefile、Visual Studio工程等[^3] - 通过`CMakeLists.txt`文件描述项目构建规则 - 工作流程：`CMakeLists.txt` → 生成构建文件 → 编译项目[^2] 2. **关键文件** | 文件类型 | 作用 | 示例位置 | |------------------|-------------------------------|---------------| | `CMakeLists.txt` | 项目构建规则 | 项目根目录 | | 源文件(.cpp/.h) | 项目源代码 | src目录 | | 构建目录 | 存放生成的构建文件 | build/目录 | #### 二、基础项目搭建步骤 1. **创建项目结构** ```bash my_project/ ├── CMakeLists.txt # CMake配置文件 └── src/ └── main.cpp # C++源代码 ``` 2. **编写最小化CMakeLists.txt** ```cmake # 最低CMake版本要求 cmake_minimum_required(VERSION 3.10) # 设置项目名称和语言 project(MyProject CXX) # 添加可执行文件 add_executable(my_app src/main.cpp) ``` 3. **配置与构建项目** ```bash # 创建构建目录并生成构建文件 cmake -B build # 编译项目（-j4表示4线程并行） cmake --build build -j4 ``` 4. **运行程序** ```bash # Linux/macOS ./build/my_app # Windows .\build\Debug\my_app.exe ``` #### 三、进阶功能示例 1. **添加多个源文件** ```cmake # 查找所有源文件 aux_source_directory(src SOURCES) # 添加可执行文件 add_executable(my_app ${SOURCES}) ``` 2. **设置C++标准** ```cmake set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) ``` 3. **添加头文件路径** ```cmake include_directories(include) # 添加include目录 ``` 4. **安装目标（make install）** ```cmake install(TARGETS my_app RUNTIME DESTINATION bin ) ``` 执行安装：`cmake --install build`[^5] #### 四、项目结构示例（多目录） ``` my_project/ ├── CMakeLists.txt ├── include/ │ └── utils.h ├── src/ │ ├── main.cpp │ └── utils.cpp └── build/ # 自动生成 ``` 对应CMakeLists.txt： ```cmake cmake_minimum_required(VERSION 3.10) project(AdvancedProject) # 包含头文件目录 include_directories(include) # 添加可执行文件 add_executable(app src/main.cpp src/utils.cpp ) # 设置C++标准 target_compile_features(app PRIVATE cxx_std_17) ``` #### 五、常用命令速查 | 命令 | 作用 | |--------------------------|-------------------------------| | `add_executable()` | 创建可执行文件目标 | | `add_library()` | 创建库文件目标 | | `target_link_libraries()`| 链接库到目标 | | `find_package()` | 查找外部依赖包 | | `set()` | 设置变量 | > 最佳实践：始终在`build`目录外构建（out-of-source build）保持源码清洁[^4]
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值