前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >CMake使用总结

CMake使用总结

作者头像
bear_fish
发布于 2018-09-19 03:33:55
发布于 2018-09-19 03:33:55
1.8K00
代码可运行
举报
运行总次数:0
代码可运行

https://www.mawenbao.com/note/cmake.html

总结CMake的常用命令,并介绍有用的CMake资源。

CMake意为cross-platform make,可用于管理c/c++工程。CMake解析配置文件CMakeLists.txt生成Makefile,相比直接用Makefile管理工程,CMake更灵活和简单。

简单的例子

一个完整的Demo可参考这里

假设当前目录的结构为

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
./a.cpp
./b.cpp

./include/common.h
./include/defines.h

./other/c.cpp
./other/d.cpp

./lib/libB.a
./lib/libBd.a
./lib/libA.so
./lib/libAd.so
./lib/libB.so
./lib/libBd.so
./lib/libC.so
./lib/libCd.so

使用下面的CMakeLists.txt文件,目标是编译当前目录和./other目录下的所有源文件,并链接./lib目录下的相应库文件到最终的可执行文件./bin/hello(或./bin/hellod)。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
cmake_minimum_required(VERSION 2.8)
project(helloworld)

set(CMAKE_VERBOSE_MAKEFILE on)
set(CMAKE_CXX_COMPILER "g++")
set(CMAKE_CXX_FLAGS "-Wall")
set(CMAKE_CXX_FLAGS_DEBUG "-g3")
set(CMAKE_CXX_FLAGS_RELEASE "-O2")
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

aux_source_directory(./ SRC_LIST)
aux_source_directory(./other OTHER_SRC_LIST)
list(APPEND SRC_LIST ${OTHER_SRC_LIST})

include_directories(${PROJECT_SOURCE_DIR}/include)
link_directories(${PROJECT_SOURCE_DIR}/lib)

if(${CMAKE_BUILD_TYPE} MATCHES "debug")
    add_executable(hellod ${SRC_LIST})
    target_link_libraries(hellod Ad Bd.a Cd.so)
else()
    add_executable(hello ${SRC_LIST})
    target_link_libraries(hello A B.a C.so)
endif()

执行命令cmake -DCMAKE_BUILD_TYPE=debug .生成Makefile,make之后生成./bin/hellod(调试版本),或执行cmake .最后生成./bin/hello。

常用的CMake变量

详细内容请参考CMake Useful Variables

  • PROJECT_SOURCE_DIR 工程的源文件目录,通常是包含CMakeLists.txt(有Project命令的)的目录。

自定义变量

可在命令行下向CMake传递自定义变量

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
cmake -DMY_VAR=hello .

然后在CMakeLists.txt中使用,注意大小写。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
message(${MY_VAR})

构建类型

cmake默认支持多种构建类型(build type),每种构建类型都有专门的编译参数变量,详情见下表[1]:

CMAKE_BUILD_TYPE

对应的c编译选项变量

对应的c++编译选项变量

None

CMAKE_C_FLAGS

CMAKE_CXX_FLAGS

Debug

CMAKE_C_FLAGS_DEBUG

CMAKE_CXX_FLAGS_DEBUG

Release

CMAKE_C_FLAGS_RELEASE

CMAKE_CXX_FLAGS_RELEASE

RelWithDebInfo

CMAKE_C_FLAGS_RELWITHDEBINFO

CMAKE_CXX_FLAGS_RELWITHDEBINFO

MinSizeRel

CMAKE_C_FLAGS_MINSIZEREL

CMAKE_CXX_FLAGS_MINSIZEREL

在CMakeLists.txt中可以自定义编译选项变量

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
set(CMAKE_CXX_FLAGS_RELEASE "-O2")

然后运行cmake的时候,传入相应的构建类型即可

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
cmake -DCMAKE_BUILD_TYPE=Release

常用命令

详情可参考对应版本的CMake文档

检查CMake版本

cmake版本至少为2.8

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
cmake_minimum_required(VERSION 2.8)

定义工程名称

工程名为helloworld

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
project(helloworld)

查找源文件

查找当前目录下所有的源文件并保存到SRC_LIST变量里

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
aux_source_directory(. SRC_LIST)

查找src目录下所有以cmake开头的文件并保存到CMAKE_FILES变量里

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
file(GLOB CMAKE_FILES "src/cmake*")

file命令同时支持目录递归查找

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
file(GLOB_RECURSE CMAKE_FILES "src/cmake*")

按照官方文档的说法,不建议使用file的GLOB指令来收集工程的源文件,原文解释如下

We do not recommend using GLOB to collect a list of source files from your source tree. If no CMakeLists.txt file changes when a source is added or removed then the generated build system cannot know when to ask CMake to regenerate.

大意就是,GLOB收集的源文件增加或删除,而CMakeLists.txt没有发生修改时,CMake不能识别这些文件。其实,当CMakeLists.txt使用aux_source_directory和file glob查找工程源文件时,如果添加或删除源文件,都需要重新运行CMake。

set命令

经常配合set命令使用的CMake变量,使用set(variable value)进行设置。

  • CMAKE_VERBOSE_MAKEFILE on 输出详细的编译和链接信息
  • CMAKE_CXX_COMPILER "g++" c++编译器
  • CMAKE_CXX_FLAGS "-Wall" c++编译器参数
    • CMAKE_CXX_FLAGS_DEBUG 除CMAKE_CXX_FLAGS外,debug版本的额外编译器参数
    • CMAKE_CXX_FLAGS_RELEASE 除CMAKE_CXX_FLAGS外,release版本的额外编译器参数
  • EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin 可执行文件的输出目录
  • LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib 链接库的输出目录

set命令还可以设置自定义变量,比如

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
set(MY_GREETINGS "hello world")

包含目录和链接目录

./include./abc加入包含目录列表

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
include_directories(
    ./include
    ./abc
)

./lib加入编译器链接阶段的搜索目录列表

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
link_directories(
    ./lib
)

添加生成目标

使用SRC_LIST源文件列表里的文件生成一个可执行文件hello

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
add_executable(hello ${SRC_LIST})

使用SRC_LIST源文件列表里的文件生成一个静态链接库libhello.a

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
add_library(hello STATIC ${SRC_LIST})

使用SRC_LIST源文件列表里的文件生成一个动态链接库libhello.so

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
add_library(hello SHARED ${SRC_LIST})

将若干库文件链接到生成的目标hello(libhello.a或libhello.so)

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
target_link_libraries(hello A B.a C.so)

需要注意的是,target_link_libraries里库文件的顺序符合gcc链接顺序的规则,即被依赖的库放在依赖它的库的后面,比如上面的命令里,libA.so可能依赖于libB.a和libC.so,如果顺序有错,链接时会报错。还有一点,B.a会告诉CMake优先使用静态链接库libB.a,C.so会告诉CMake优先使用动态链接库libC.so,也可直接使用库文件的相对路径或绝对路径。使用绝对路径的好处在于,当依赖的库被更新时,make的时候也会重新链接。

自定义链接选项

有时候需要自定义链接选项,比如需要单独对B.a使用--whole-archive选项,可以

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
target_link_libraryies(hello A -Wl,--whole-archive B.a -Wl,--no-whole-archive C.so)

自定义Makefile目标

运行下面的whatever目标make whatever,会先创建一个目录./hello,然后将当前目录的a.txt拷贝到新建的./hello目录里。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
add_custom_command(
    OUTPUT ./hello/a.txt
    COMMAND mkdir -p ./hello 
            cp a.txt ./hello
    DEPENDS a.txt
)
add_custom_target(whatever DEPENDS ./hello/a.txt)

自定义目标还可以使用add_dependencies命令加入到其他目标的依赖列表里,当执行make demo时,whatever目标会被自动调用。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
add_executable(demo ${SRC_LIST})
add_dependencies(demo whatever)

其他常用命令

包含其他目录的CMakeLists.txt

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
include(/path/to/another/CMakeLists.txt)

if命令

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
if(${CMAKE_BUILD_TYPE} MATCHES "debug")
    ...
else()
    ...
endif()

list命令

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
list(APPEND SRC_LIST 
    a.cpp
    b.cpp
)

list(REMOVE_ITEM SRC_LIST
    a.cpp
)

更多的例子

自定义Makefile目标的完整例子

下面的CMakeLists.txt添加一个自定义目标proto,该目标在编译工程前,会先调用protobuf程序编译先生成Google Protocol Buffers的消息解析器。

代码语言:javascript
代码运行次数:0
运行
AI代码解释
复制
cmake_minimum_required(VERSION 2.6)
project(protobuf-demo)

# compile proto files
set(PROTO_IN  news.proto)
set(PROTO_SRC news.pb.cc)
set(PROTO_OUT news.pb.h news.pb.cc proto/)

add_custom_command(
    OUTPUT ${PROTO_OUT}
    COMMAND protoc --cpp_out . --java_out . ${PROTO_IN}
    DEPENDS ${PROTO_IN}
)
add_custom_target(proto DEPENDS ${PROTO_OUT})

aux_source_directory(. SRC_LIST)
list(APPEND SRC_LIST
    ${PROTO_SRC}
)

set(CMAKE_CXX_COMPILER "g++")
set(CMAKE_CXX_FLAGS "-Wall")
set(CMAKE_VERBOSE_MAKEFILE on)

add_executable(demo ${SRC_LIST})
add_dependencies(demo proto)
target_link_libraries(demo protobuf)

阅读资料

  1. CMake文档列表
  2. CMake常用变量列表
  3. CMake入门教程
  4. CMake Useful Variables: Compilers and Tools,引用于2014-05-06。 
本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2017年05月02日,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
1 条评论
热度
最新
这个不错 相当于一个私有云一样
这个不错 相当于一个私有云一样
回复回复点赞举报
推荐阅读
【腾讯云的1001种玩法】如何利用腾讯云搭建分布式应用
赵伟成
2016/12/20
3.7K0
【腾讯云的1001种玩法】如何利用腾讯云搭建分布式应用
Syncthing就是我要的同步备份软件
最开始的时候,我在路由器上开启 Samba,每次编辑完项目就手动拷贝到路由器硬盘里,麻烦程度可想而知,后来又用了 Google Drive/One Drive,又因为它们的网络不理想,就又放弃使用了。其实就是很简单的需求,自动备份、速度快,然后去找了一下,发现一堆人推荐用 Rsync,这货我只在 VPS 上用过,拿来做镜像同步,但是要做实时同步,不好配置。
气象学家
2020/06/17
4.5K0
Syncthing就是我要的同步备份软件
【腾讯云的1001种玩法】30分钟搭建 Wordpress 网站
rublog
2017/04/24
3.3K0
【腾讯云的1001种玩法】30分钟搭建 Wordpress 网站
​利用腾讯云轻量应用服务器Nextcloud应用镜像快速搭建私有同步云盘
Nextcloud是一款开源免费的云存储网盘软件,可以帮助您快速便捷地搭建一套属于自己或团队共享的云同步网盘,从而实现跨平台跨设备文件同步、共享、版本控制、团队协作等功能。
青阳
2021/03/22
13.7K1
​利用腾讯云轻量应用服务器Nextcloud应用镜像快速搭建私有同步云盘
【腾讯云的1001种玩法】一个小白的自学建站史(菜鸟建站入门)
王启航
2017/03/01
18.3K3
【腾讯云的1001种玩法】一个小白的自学建站史(菜鸟建站入门)
Windows系统必备!3分钟学会自建云盘FileBrowser,轻松实现远程管理
在当今分布式办公和多地协作的场景下,便捷的文件管理工具变得尤为重要。FileBrowser 是一款开源、轻量级的文件管理工具,支持通过浏览器远程管理文件。本文将介绍如何通过内网穿透技术搭建 FileBrowser 服务器,使其能够实现远程访问与管理,方便您在任何时间、任何地点高效管理文件。
用户7160553
2024/11/28
3150
Windows系统必备!3分钟学会自建云盘FileBrowser,轻松实现远程管理
mac软件这样使用,你知道几个。(技术创作101训练营)
听了腾讯云社区的授课,加上工作之后,将会使用到windows笔记本作为办公电脑。在此就想着把平时在mac上使用的软件整理一下,能帮到自己的软件分享给大家。
崔笑颜
2020/09/21
1.3K0
【玩转腾讯云】三.云端轻松构建部署WordPress网站应用
②选择自定义配置——计费模式为“按量付费”——地域选择“北京”——可用区选择“随机可用区”——网络选择“默认”即可
一只特立独行的兔先生
2020/04/02
5.5K0
【玩转腾讯云】三.云端轻松构建部署WordPress网站应用
CasaOS使用Docker安装SyncThing文件同步工具打造私人网盘
本文主要介绍如何在CasaOS系统小主机内使用docker安装可跨网络、跨平台进行文件的同步神器SyncThing,并结合cpolar内网穿透工具配置公网地址,轻松实现随时随地远程访问本地部署的SyncThing web页面进行同步管理与相关配置操作。
命运之光
2024/09/25
3040
CasaOS使用Docker安装SyncThing文件同步工具打造私人网盘
【对象存储COS】使用COS自动数据备份,解放硬盘空间
视频,照片,录音......诸如此类的文件在手机电脑里,永远是不断增多,不断占用的东西,每次空间告急时,都要花一大片时间去整理,删除照片释放这宝贵的空间,“这个删,这个删不删呢?可能以后要用......”,挑选照片还真是一个费时费力还费心的活。
Ar-Sr-Na
2024/06/03
3410
利用腾讯云函数实现有道云笔记自动签到
有道云笔记是由有道公司推出了一款笔记软件。每天签到就可以领取3-5mb的空间。但是呢,有时候会忘了签到,所以我就在网上找了一段python的代码,通过腾讯云函数实现每天的自动签到。 准备:电脑,Chrome浏览器,你的账号密码,一个腾讯云账号,一段代码(下载地址在右侧或者文章底部) 那么教程开始 打开Chrome浏览器,并打开有道云笔记官网(note.youdao.com),右上角点击登录
叮当叮
2020/04/20
8.4K3
利用腾讯云函数实现有道云笔记自动签到
【技术种草】体验腾讯云 搭建一个自己的个人网站哦
1、我们首先打开腾讯云(已经有云服务器的大佬可以略过本节,新用户需要先注册登录后实名认证),点击云服务器,然后再点击立即选购,选购一台我们需要的云服务器。
老孙
2021/11/29
3.7K0
【腾讯云的1001种玩法】Hello Hexo之静态博客搭建+自动部署
饶文津
2017/04/13
4.9K0
【玩转腾讯云】3分钟打造个人专属云盘,速度吊打某云盘
②选择自定义配置——计费模式为“按量付费”——地域选择“北京”——可用区选择“随机可用区”——网络选择“默认”即可
一只特立独行的兔先生
2020/04/06
43.4K12
【玩转腾讯云】3分钟打造个人专属云盘,速度吊打某云盘
【腾讯云的1001种玩法】JavaWeb项目部署指南
本文主要介绍了一种通过脚本自动化部署Java Web应用到Tomcat服务器的方法。主要包括准备工作、部署过程和总结。首先,通过下载和安装Java和Tomcat,使用脚本工具(如Shell和PowerShell)进行部署。然后,通过修改配置文件,使Tomcat支持Web应用的访问。最后,总结了这种方法的优缺点,并给出了一些建议。
葛尧
2017/03/30
5.4K1
搭建免费的文件自动同步服务器,无公网IP外网远程访问【Syncthing私人云盘】
在数据爆炸的当下,每天都会产生海量的数据,这些数据可能是我们手机里新拍的照片、工作接收的文件档案、随手编辑写下的文档、或者新下载的视频等等,这些数据很快就能填满容量堪忧的智能设备(手机、平板等)。正因如此,云存储一时间风头无两,不仅能让这些海量的数据有地方安身,还能随时分享给需要的人。但大厂的云盘总是问题多多,只能自建云盘保平安。
洁洁
2023/10/10
1.6K0
搭建免费的文件自动同步服务器,无公网IP外网远程访问【Syncthing私人云盘】
腾讯云Linux服务器搭建一个WordPress博客
看到网络上很多人买了腾讯云服务器后却不知道怎么搭建WordPress博客,看了一下腾讯云出的WordPress教程,我觉得对新手来说难度还是太大了,所以就根据自己的建站经历写了一篇,本文采用腾讯云服务器CVM+宝塔管理面板+WordPress的方式搭建,力求简单易懂,希望能帮助到需要的朋友们。
主机优惠教程
2019/05/28
17.9K3
腾讯云Linux服务器搭建一个WordPress博客
幻兽帕鲁服务器数据备份(云备份)
搭建幻兽帕鲁个人服务器,最近不少用户碰到内存不足、游戏坏档之类的问题。将游戏存档进行云备份,不占用服务器空间,需要时支持快速恢复。
lucia
2024/01/23
9.7K32
使用开源同步工具 Syncthing 控制你的数据
如今,我们的一些最重要的财产 —— 从家人和朋友的照片和视频到财务和医疗文件 —— 都是数据。即便是云存储服务的迅猛发展,我们仍有对隐私和个人数据缺乏控制的担忧。从棱镜监控计划到谷歌让 APP 开发者扫描你的个人邮件,这些新闻的报道应该会让我们对我们个人信息的安全性有所顾虑。
用户8639654
2021/10/25
2.4K0
【腾讯云的1001种玩法】几种在腾讯云建立WordPress的方法(Linux)(二)
ZNing
2017/02/27
7.3K0
推荐阅读
相关推荐
【腾讯云的1001种玩法】如何利用腾讯云搭建分布式应用
更多 >
LV.1
互联网算法工程师
目录
  • 简单的例子
  • 常用的CMake变量
    • 自定义变量
    • 构建类型
  • 常用命令
    • 检查CMake版本
    • 定义工程名称
    • 查找源文件
    • set命令
    • 包含目录和链接目录
    • 添加生成目标
    • 自定义链接选项
    • 自定义Makefile目标
    • 其他常用命令
  • 更多的例子
    • 自定义Makefile目标的完整例子
  • 阅读资料
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档