新手写CMakeLists.txt简直就是实力劝退,各类命令让不少人头大,如何写一个最基础的CMakeLists.txt呢?本文从一个实例出发,教你编写的基本流程。python
本文附实例的源码地址。
c++
编写CMakeLists.txt
最经常使用的功能就是调用其余的.h头文件和.so/.a库文件,将.cpp/.c/.cc文件编译成可执行文件或者新的库文件。git
命令的官方网站:CMake Reference Documentationgithub
最经常使用的命令以下(仅供后期查询,初期不须要细看):web
# 本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需按照下面的流程:svg
project(xxx) #必须 add_subdirectory(子文件夹名称) #父目录必须,子目录没必要 add_library(库文件名称 STATIC 文件) #一般子目录(二选一) add_executable(可执行文件名称 文件) #一般父目录(二选一) include_directories(路径) #必须 link_directories(路径) #必须 target_link_libraries(库文件名称/可执行文件名称 连接的库文件名称) #必须
除了这些以外,就是些set变量的语句,if判断的语句,或者其余编译选项的语句,但基本结构都是这样的。函数
我以本身曾经写的一段实际代码为例,来说解究竟该怎么写CMakeLists
。网站
实例地址:ui
码云:https://gitee.com/yngzMiao/protobuf-parser-tool调试
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 |---...
目录结构含义:
Google
提供的相关解析库和头文件,被proto_pb2
文件夹内引用;Person
结构和Person
相关的处理函数,被proto_buf
文件夹内引用;read
和write
函数,被example_persom.cpp
文件引用。也就是说:
example_person.cpp
–>proto_buf
文件夹–>proto_pb2
文件夹–>protobuf
文件夹
在须要进行编译的文件夹内编写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
的文件数量是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是,在最顶层建立build文件夹,而后编译。即:
mkdir build && cd build cmake .. make
最终生成可执行文件example_person
。
能够经过如下命令来运行该可执行文件:
./example_person