新手写CMakeLists.txt简直就是实力劝退，各种命令让很多人头大，如何写一个最基础的CMakeLists.txt呢？本文从一个实例出发，教你编写的基本流程。

CMakeLists.txt的基本结构

编写CMakeLists.txt最常用的功能就是调用其他的.h头文件和.so/.a库文件，将.cpp/.c/.cc文件编译成可执行文件或者新的库文件。

命令的官方网站：CMake Reference Documentation

最常用的命令如下(仅供后期查询，初期不需要细看)：

# 本CMakeLists.txt的project名称
# 会自动创建两个变量，PROJECT_SOURCE_DIR和PROJECT_NAME
# ${PROJECT_SOURCE_DIR}：本CMakeLists.txt所在的文件夹路径
# ${PROJECT_NAME}：本CMakeLists.txt的project名称
project(xxx)# 获取路径下所有的.cpp/.c/.cc文件，并赋值给变量中
aux_source_directory(路径 变量)# 给文件名/路径名或其他字符串起别名，用${变量}获取变量内容
set(变量 文件名/路径/...)# 添加编译选项
add_definitions(编译选项)# 打印消息
message(消息)# 编译子文件夹的CMakeLists.txt
add_subdirectory(子文件夹名称)# 将.cpp/.c/.cc文件生成.a静态库
# 注意，库文件名称通常为libxxx.so，在这里只要写xxx即可
add_library(库文件名称 STATIC 文件)# 将.cpp/.c/.cc文件生成可执行文件
add_executable(可执行文件名称 文件)# 规定.h头文件路径
include_directories(路径)# 规定.so/.a库文件路径
link_directories(路径)# 对add_library或add_executable生成的文件进行链接操作
# 注意，库文件名称通常为libxxx.so，在这里只要写xxx即可
target_link_libraries(库文件名称/可执行文件名称 链接的库文件名称)

通常一个CMakeLists.txt需按照下面的流程：

project(xxx)                                          #必须add_subdirectory(子文件夹名称)                         #父目录必须，子目录不必add_library(库文件名称 STATIC 文件)                    #通常子目录(二选一)
add_executable(可执行文件名称 文件)                     #通常父目录(二选一)include_directories(路径)                              #必须
link_directories(路径)                                 #必须target_link_libraries(库文件名称/可执行文件名称 链接的库文件名称)       #必须

除了这些之外，就是些set变量的语句，if判断的语句，或者其他编译选项的语句，但基本结构都是这样的。

实例

我以自己曾经写的一段实际代码为例，来讲解究竟该怎么写CMakeLists。

实例地址：

GitHub：https://github.com/yngzMiao/protobuf-parser-tool

实例的功能是生成和解析proto文件，分为C++和python版本。其中，C++版本就是采用CMakeLists.txt编写的，目录结构如下：

|---example_person.cpp
|---proto_pb2|--Person.pb.cc|--Person.pb.h
|---proto_buf|---General_buf_read.h|---General_buf_write.h
|---protobuf|---bin|---...|---include|---...|---lib|---...

目录结构含义：

protobuf：Google提供的相关解析库和头文件，被proto_pb2文件夹内引用；
proto_pb2：封装的Person结构和Person相关的处理函数，被proto_buf文件夹内引用；
proto_buf：封装的read和write函数，被example_persom.cpp文件引用。

也就是说：

example_person.cpp–>proto_buf文件夹–>proto_pb2文件夹–>protobuf文件夹

步骤

CMakeLists.txt的创建

在需要进行编译的文件夹内编写CMakeLists.txt，即含有.cpp/.c/.cc的文件夹内：

即目录结构如下：

|---example_person.cpp
|---CMakeLists.txt
|---proto_pb2|--Person.pb.cc|--Person.pb.h|--CMakeLists.txt
|---proto_buf|---General_buf_read.h|---General_buf_write.h
|---protobuf|---bin|---...|---include|---...|---lib|---...

CMakeLists.txt的编写

本项目的CMakeLists.txt的文件数量是2个，目录层次结构为上下层关系。通常的解决方案，就是将下层目录编译成一个静态库文件，让上层目录直接读取和调用，而上层目录就直接生成一个可执行文件。

上层CMakeLists.txt的内容为：

cmake_minimum_required(VERSION 3.0)
project(example_person)# 如果代码需要支持C++11，就直接加上这句
SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++0x")
# 如果想要生成的可执行文件拥有符号表，可以gdb调试，就直接加上这句
add_definitions("-Wall -g")# 设置变量，下面的代码都可以用到
set(GOOGLE_PROTOBUF_DIR ${PROJECT_SOURCE_DIR}/protobuf)
set(PROTO_PB_DIR ${PROJECT_SOURCE_DIR}/proto_pb2)
set(PROTO_BUF_DIR ${PROJECT_SOURCE_DIR}/proto_buf)# 编译子文件夹的CMakeLists.txt
add_subdirectory(proto_pb2)# 规定.h头文件路径
include_directories(${PROJECT_SOURCE_DIR}${PROTO_PB_DIR} ${PROTO_BUF_DIR}
)# 生成可执行文件
add_executable(${PROJECT_NAME} example_person.cpp )# 链接操作
target_link_libraries(${PROJECT_NAME}general_pb2)

如果是初学者，这一段可能看不到两个地方，第一是链接操作的general_pb2，第二是按照上文的CMakeLists.txt的流程，并没有规定link_directories的库文件地址啊，这是什么道理？

这两个其实是一个道理，add_subdirectory起到的作用！

当运行到add_subdirectory这一句时，会先将子文件夹进行编译，而libgeneral_pb2.a是在子文件夹中生成出来的库文件。子文件夹运行完后，父文件夹就已经知道了libgeneral_pb2.a这个库，因而不需要link_directories了。

同时，另一方面，在add_subdirector之前set的各个变量，在子文件夹中是可以调用的！

下层CMakeLists.txt的内容为：

project(general_pb2)aux_source_directory(${PROJECT_SOURCE_DIR} PB_FILES)add_library(${PROJECT_NAME} STATIC ${PB_FILES})include_directories(${PROJECT_SOURCE_DIR}${GOOGLE_PROTOBUF_DIR}/include
)link_directories(${GOOGLE_PROTOBUF_DIR}/lib/)target_link_libraries(${PROJECT_NAME}protobuf
)

在这里，GOOGLE_PROTOBUF_DIR是上层CMakeLists.txt中定义的，libprotobuf.a是在${GOOGLE_PROTOBUF_DIR}/lib/目录下的。

显然可见，这就是一个标准的CMakeLixts.txt的流程。

CMakeLists.txt的编译

一般CMakeLists.txt是，在最顶层创建build文件夹，然后编译。即：

mkdir build && cd build
cmake ..
make

最终生成可执行文件example_person。

可以通过以下命令来运行该可执行文件：

./example_person

【CMake】CMakeLists.txt的超傻瓜手把手教程（附实例源码）相关推荐

JavaScript实现shortestCommonSupersequence最短公共超序列算法（附完整源码）
JavaScript实现shortestCommonSupersequence最短公共超序列算法(附完整源码) longestCommonSubsequence.js完整源代码 shortestCom ...
正点原子提供免费开源的的连接机智云平台开发教程和实例源码
相信使用过云平台开发物联网产品的同学对国内领先的机智云平台都不陌生了.2017年6月,正点原子与机智云正式签订战略合作,推出机智云系列教程,所有正点原子的开发板都可以轻松连云了,几小时搞定远程控制. ...
C++shortest common supersequence最短公共超序列算法的实现(附完整源码)
C++shortest common supersequence最短公共超序列算法的实现 C++shortest common supersequence最短公共超序列算法的实现的完整源码(定义,实现 ...
在线预览word、excel、pdf、txt、png等功能实现(附简单源码)
项目过程中,有时候我们需要对一些附件进行预览的操作,这里讲述一下实现过程,首先如标题所写的预览格式,预览word和excel是利用POI生成临时文件即把word或者excel生成html文件然后再通过 ...
alexa skill+自定义oauth2服务完整版教程(保姆级图文教程附demo源码)
文章目录前言一.alexa skill是什么? 二.开发步骤 1.注册账号 2.创建技能 3.创建函数技能绑定函数部署oauth2 为技能配置账号,开启oauth2认证 alexa app 开 ...
微信小程序中引用FontAwesome字体最完整教程附下载源码
目的:在小程序实现,FontAwesome.省去制作图标,引用图标的烦恼主要步骤,下载>转码>合并样式>引用样式,不会的可下载源码 1.到Font Awesome官网下载字体包 ...
WPF Visifire.Charts4.6.1使用教程附含源码
原因: 前段时间,公司项目中用到Visifire.Charts4.5.6控件,项目中要求随时可以控制动画效果,用于在大屏上面展示,很酷炫. 过程: 但是没有源码,于是写了一个方法用动画去控制数量动态增 ...
html 地球页面代码,纯CSS3实现地球自转实现代码(图文教程附送源码)
最终成果: 素材:两张图片, espaco.jpg(1600*1000) terra.jpg(900*450) 第一步,形成静态图(地球背景全屏,地球大小为450px*450px,地球位置为上下左右居 ...
抖音最近很火的烟花表白视频制作教程附模板源码
抖音最近很火的烟花表白视频,估计有些朋友也在直播间刷到过,刷礼物才能制作,这些开直播的就是在赚银浪,因浪可以提现的. 这里给大家分享4个模板,2个烟花的适合表白,2个美女的适合装x,里面的文字,图片都 ...

【CMake】CMakeLists.txt的超傻瓜手把手教程（附实例源码）

CMakeLists.txt的基本结构

实例

步骤

CMakeLists.txt的创建

CMakeLists.txt的编写

CMakeLists.txt的编译

【CMake】CMakeLists.txt的超傻瓜手把手教程（附实例源码）相关推荐

最新文章

热门文章