当前位置：网站首页 > C++编程 > 正文

cmake入门实战（cmake使用方法）

C++编程 来源： 网络 编辑：小编 更新时间：2026-04-03 11:00:05 浏览量：1



cmake是编译配置工具，当多个人用不同的语言或者编译器开发一个项目，最终要输出一个可执行文件或者共享库（dll，so等等），就需要用CMake！所有操作都是通过编译CMakeLists.txt来完成。

  1. 绝大多数的linux系统已经安装了CMake；
  2. Windows或某些没有安装过的linux系统，去http://www.cmake.org/HTML/Download.html 可以下载安装；

1、步骤一，写一个HelloWord

 
  
2、步骤二，写CMakeLists.txt
 
  
 
  
3、步骤三、使用cmake，生成makefile文件
 
  
 
  
4、使用make命令编译
 
  
 
  
5、最终生成了Hello的可执行程序
 
  
可以用来指定工程的名字和支持的语言，默认支持所有语言
 
  
PROJECT (HELLO) 指定了工程的名字，并且支持所有语言—建议
 
  
PROJECT (HELLO CXX) 指定了工程的名字，并且支持语言是C++
 
  
PROJECT (HELLO C CXX) 指定了工程的名字，并且支持语言是C和C++
 
  
该指定隐式定义了两个CMAKE的变量
 
  
_BINARY_DIR，本例中是 HELLO_BINARY_DIR
 
  
_SOURCE_DIR，本例中是 HELLO_SOURCE_DIR
 
  
MESSAGE关键字就可以直接使用者两个变量，当前都指向当前的工作目录，后面会讲外部编译
 
  
问题：如果改了工程名，这两个变量名也会改变
 
  
解决：又定义两个预定义变量：PROJECT_BINARY_DIR和PROJECT_SOURCE_DIR，这两个变量和HELLO_BINARY_DIR，HELLO_SOURCE_DIR是一致的。所以改了工程名也没有关系
 
  
用来显示的指定变量的
 
  
SET(SRC_LIST main.cpp) SRC_LIST变量就包含了main.cpp
 
  
也可以 SET(SRC_LIST main.cpp t1.cpp t2.cpp)
 
  
向终端输出用户自定义的信息
 
  
主要包含三种信息：
 
  
     
   
  • SEND_ERROR，产生错误，生成过程被跳过。
    •  
   
  • SATUS，输出前缀为—的信息。
    •  
   
  • FATAL_ERROR，立即终止所有 cmake 过程.
    •  
  
 
  
生成可执行文件
 
  
ADD_EXECUTABLE(hello ${SRC_LIST}) 生成的可执行文件名是hello，源文件读取变量SRC_LIST中的内容
 
  
也可以直接写 ADD_EXECUTABLE(hello main.cpp)
 
  
上述例子可以简化的写成
 
  
注意：工程名的 HELLO 和生成的可执行文件 hello 是没有任何关系的
 
  
     
   
  • 变量使用${}方式取值，但是在 IF 控制语句中是直接使用变量名 
    •  
   
  • 指令(参数 1 参数 2…) 参数使用括弧括起，参数之间使用空格或分号分开。 以上面的 ADD_EXECUTABLE 指令为例，如果存在另外一个 func.cpp 源文件 
    就要写成：ADD_EXECUTABLE(hello main.cpp func.cpp)或者ADD_EXECUTABLE(hello main.cpp;func.cpp)
     
    •  
   
  • 指令是大小写无关的，参数和变量是大小写相关的。但，推荐你全部使用大写指令 
    •  
  
 
  
     
   
  • SET(SRC_LIST main.cpp) 可以写成 SET(SRC_LIST “main.cpp”)，如果源文件名中含有空格，就必须要加双引号
    •  
   
  • ADD_EXECUTABLE(hello main) 后缀可以不行，他会自动去找.c和.cpp，最好不要这样写，可能会有这两个文件main.cpp和main
    •  
  
 
  
     
   
  • 上述例子就是内部构建，他生产的临时文件特别多，不方便清理
    •  
   
  • 外部构建，就会把生成的临时文件放在build目录下，不会对源文件有任何影响强烈使用外部构建方式
    •  
  
 
  
 
  
1、建立一个build目录，可以在任何地方，建议在当前目录下
 
  
2、进入build，运行cmake … 当然…表示上一级目录，你可以写CMakeLists.txt所在的绝对路径，生产的文件都在build目录下了
 
  
3、在build目录下，运行make来构建工程
 
  
注意外部构建的两个变量
 
  
1、HELLO_SOURCE_DIR 还是工程路径
 
  
2、HELLO_BINARY_DIR 编译路径 也就是 /root/cmake/bulid
 
  
     
   
  • 为工程添加一个子目录 src，用来放置工程源代码
    •  
   
  • 添加一个子目录 doc，用来放置这个工程的文档 hello.txt
    •  
   
  • 在工程目录添加文本文件 COPYRIGHT, README
    •  
   
  • 在工程目录添加一个 runhello.sh 脚本，用来调用 hello 二进制
    •  
   
  • 将构建后的目标文件放入构建目录的 bin 子目录
    •  
   
  • 将 doc 目录 的内容以及 COPYRIGHT/README 安装到/usr/share/doc/cmake/
    •  
  
 
  
每个目录下都要有一个CMakeLists.txt说明
 
  
 
  
外层CMakeLists.txt
 
  
 
  
src下的CMakeLists.txt
 
  
 
  
ADD_SUBDIRECTORY 指令
 
  
ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
 
  
     
   
  • 这个指令用于向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置 
    •  
   
  • EXCLUDE_FROM_ALL函数是将写的目录从编译中排除，如程序中的example 
    •  
   
  • ADD_SUBDIRECTORY(src bin) 
    将 src 子目录加入工程并指定编译输出(包含编译中间结果)路径为bin 目录
     
    如果不进行 bin 目录的指定，那么编译结果(包括中间结果)都将存放在build/src 目录
     
    •  
  
 
  
更改二进制的保存路径
 
  
SET 指令重新定义 EXECUTABLE_OUTPUT_PATH 和 LIBRARY_OUTPUT_PATH 变量 来指定最终的目标二进制的位置
 
  
思考：加载哪个CMakeLists.txt当中
 
  
哪里要改变目标存放路径，就在哪里加入上述的定义，所以应该在src下的CMakeLists.txt下写
 
  
     
   
  • 一种是从代码编译后直接 make install 安装
    •  
   
  • 一种是打包时的指定 目录安装。 
    
       
     
    • 简单的可以这样指定目录：make install DESTDIR=/tmp/test
      •  
     
    • 稍微复杂一点可以这样指定目录：https://blog.csdn.net/weixin_/article/details/configure –prefix=/usr
      •  
    
     
    •  
  
 
  
使用CMAKE一个新的指令：INSTALL
 
  
INSTALL的安装可以包括：二进制、动态库、静态库以及文件、目录、脚本等
 
  
使用CMAKE一个新的变量：CMAKE_INSTALL_PREFIX
 
  
 
  
安装文件COPYRIGHT和README
 
  
INSTALL(FILES COPYRIGHT README DESTINATION share/doc/cmake/)
 
  
FILES：文件
 
  
DESTINATION：
 
  
1、写绝对路径
 
  
2、可以写相对路径，相对路径实际路径是：${CMAKE_INSTALL_PREFIX}/ 
   
 
  
CMAKE_INSTALL_PREFIX 默认是在 /usr/local/
 
  
cmake -DCMAKE_INSTALL_PREFIX=/usr 在cmake的时候指定CMAKE_INSTALL_PREFIX变量的路径
 
  
安装脚本runhello.sh
 
  
PROGRAMS：非目标文件的可执行程序安装(比如脚本之类)
 
  
INSTALL(PROGRAMS runhello.sh DESTINATION bin)
 
  
说明：实际安装到的是 /usr/bin
 
  
安装 doc 中的 hello.txt
 
  
     
   
  • 一、是通过在 doc 目录建立CMakeLists.txt ，通过install下的file 
    •  
   
  • 二、是直接在工程目录通过 
    INSTALL(DIRECTORY doc/ DESTINATION share/doc/cmake)
     
    •  
  
 
  
DIRECTORY 后面连接的是所在 Source 目录的相对路径
 
  
注意：abc 和 abc/有很大的区别
 
  
目录名不以/结尾：这个目录将被安装为目标路径下的
 
  
目录名以/结尾：将这个目录中的内容安装到目标路径
 
  
安装过程
 
  
cmake …
 
  
make
 
  
make install
 
  
任务：
 
  
１，建立一个静态库和动态库，提供 HelloFunc 函数供其他程序编程使用，HelloFunc 向终端输出 Hello World 字符串。
 
  
２，安装头文件与共享库。
 
  
静态库和动态库的区别
 
  
     
   
  • 静态库的扩展名一般为“.a”或“.lib”；动态库的扩展名一般为“.so”或“.dll”。
    •  
   
  • 静态库在编译时会直接整合到目标程序中，编译成功的可执行文件可独立运行
    •  
   
  • 动态库在编译时不会放到连接的目标程序中，即可执行文件无法单独运行。
    •  
  
 
  
 
  
hello.h中的内容
 
  
 
  
hello.cpp中的内容
 
  
 
  
项目中的cmake内容
 
  
 
  
lib中CMakeLists.txt中的内容
 
  
 
  
ADD_LIBRARY
 
  
ADD_LIBRARY(hello SHARED ${LIBHELLO_SRC})
 
  
     
   
  • hello：就是正常的库名，生成的名字前面会加上lib，最终产生的文件是libhello.so
    •  
   
  • SHARED，动态库 STATIC，静态库
    •  
   
  • ${LIBHELLO_SRC} ：源文件
    •  
  
 
  
同时构建静态和动态库
 
  
 
  
SET_TARGET_PROPERTIES
 
  
这条指令可以用来设置输出的名称，对于动态库，还可以用来指定动态库版本和 API 版本
 
  
同时构建静态和动态库
 
  
 
  
动态库的版本号
 
  
一般动态库都有一个版本号的关联
 
  
 
  
CMakeLists.txt 插入如下
 
  
 
  
VERSION 指代动态库版本，SOVERSION 指代 API 版本。
 
  
安装共享库和头文件
 
  
本例中我们将 hello 的共享库安装到/lib目录，
 
  
将 hello.h 安装到/include/hello 目录
 
  
 
  
注意：
 
  
安装的时候，指定一下路径，放到系统下
 
  
 
  
使用外部共享库和头文件
 
  
准备工作，新建一个目录来使用外部共享库和头文件
 
  
 
  
main.cpp
 
  
 
  
解决：make后头文件找不到的问题
 
  
PS：include 
   
     这样include是可以，这么做的话，就没啥好讲的了 
   
 
  
关键字：INCLUDE_DIRECTORIES 这条指令可以用来向工程添加多个特定的头文件搜索路径，路径之间用空格分割
 
  
在CMakeLists.txt中加入头文件搜索路径
 
  
INCLUDE_DIRECTORIES(/usr/include/hello)
 
  
感谢：
 
  
网友：zcc720的提醒
 
  
解决：找到引用的函数问题
 
  
报错信息：undefined reference to `HelloFunc()’
 
  
关键字：LINK_DIRECTORIES 添加非标准的共享库搜索路径
 
  
指定第三方库所在路径，LINK_DIRECTORIES(/home/myproject/libs)
 
  
关键字：TARGET_LINK_LIBRARIES 添加需要链接的共享库
 
  
TARGET_LINK_LIBRARIES的时候，只需要给出动态链接库的名字就行了。
 
  
在CMakeLists.txt中插入链接共享库，主要要插在executable的后面
 
  
查看main的链接情况
 
  
 
  
链接静态库
 
  
 
  
特殊的环境变量 CMAKE_INCLUDE_PATH 和 CMAKE_LIBRARY_PATH
 
  
注意：这两个是环境变量而不是 cmake 变量，可以在linux的bash中进行设置
 
  
我们上面例子中使用了绝对路径INCLUDE_DIRECTORIES(/usr/include/hello)来指明include路径的位置
 
  
我们还可以使用另外一种方式，使用环境变量export CMAKE_INCLUDE_PATH=/usr/include/hello
 
  
补充：生产debug版本的方法：cmake … -DCMAKE_BUILD_TYPE=debug
到此这篇cmake入门实战（cmake使用方法）的文章就介绍到这了,更多相关内容请继续浏览下面的相关推荐文章，希望大家都能在编程的领域有一番成就！ 
  

                            


                            

                                
  • 
                                    
                                    上一篇：
                                    
                                    git pull 和git fetch的区别（gitfetch与gitpull的区别简书）
                                    
                                    
                                
    • 
                                
  • 
                                    
                                    下一篇：
                                    
                                    excel文件比较工具（excel文件工具在哪）
                                    
                                    
                                
    • 
                            
    

                            
                            
    
                                
    
                                    版权声明：
                                    
    
                                        
                                        本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
                                        
                                        
    
                                         
                                        如若内容造成侵权、违法违规、事实不符，请将相关资料发送至xkadmin@xkablog.com进行投诉反馈，一经查实，立即处理！
                                        
                                    

    
                                    
    转载请注明出处，原文链接：https://www.xkablog.com/cjjbc/42908.html
    
                                
    
                            
    
                            
                        
    
                        
    
                            
    
                                
                                
                                
                                    # Cmake
                                
                                
                                    # 方法
                                
                                
                                    # 使用
                                
                                
                                    # 实战
                                
                                
                                    # 入门
                                
                                
                            
    
                        
    

                        
                        
                        
    
                            
    相关文章：
    
                        
                        
  • 
                                git pull 和git fetch的区别（gitfetch与gitpull的区别简书）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                ad20原理图怎么生成pcb（ad20原理图如何生成pcb）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                cnns认证机构（nps认证机构）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                wacc和apv和fte的比较（apc和fitc）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                重绘幅度cfg（重绘幅度是哪里）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                excel文件比较工具（excel文件工具在哪）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                apc和aps是什么（apc+aps）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                tcp工具安卓版（tcp工具 安卓）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                cnn神经网络算法（cnn神经网络可以用来预测吗）2026-04-03 11:00:05
                        
    • 
                        
                        
  • 
                                tp9950芯片引脚功能（tpic6b595引脚功能）2026-04-03 11:00:05
                        
    • 
                        
                        
    
                        
                    
    
                
    
            
    
        
    
        
    
    

    


    
    ❮
    全屏图片
    ❯