CMake的简单应用
各种不同的Make 工具遵循着不同的规范和标准,所执行的 Makefile 格式也千差万别。如果软件想跨平台,必须要保证能够在不同平台编译,这就得为每一个Make工具写一次 Makefile ,这将是一件让人抓狂的工作。使用CMake工具就可以很好的解决这个问题。
CMake是一个比make更高级的编译配置工具,它可以根据不同平台、不同的编译器,生成相应的Makefile。通过编写CMakeLists.txt,可以控制生成的Makefile,从而控制编译过程。CMake自动生成的Makefile不仅可以通过make命令构建项目,生成目标文件,还支持安装(make install)、测试安装的程序是否能正确执行(make test,或者ctest)、生成当前平台的安装包(make package)、生成源码包(make package_source)、产生Dashboard显示数据并上传等高级功能,只要在CMakeLists.txt中简单配置,就可以完成很多复杂的功能,包括写测试用例。如果有嵌套目录,子目录下可以有自己的CMakeLists.txt。
在 linux 平台下使用 CMake 生成 Makefile 并编译的流程如下:
1. 编写 CMake 配置文件 CMakeLists.txt 。
2. 执行命令 cmake PATH
或者 ccmake PATH
生成 Makefile。其中, PATH
是 CMakeLists.txt 所在的目录。
3. 使用 make
命令进行编译。
语法
CMake基本语法由命令、注释和空格组成,其中命令是不区分大小写的。符号 #
后面的内容被认为是注释。命令由命令名称、小括号和参数组成,参数之间使用空格进行间隔。变量引用使用 ${VAR} 形式。
command (args ...) #comment
常用命令:
cmake_minimum_required (VERSION 2.8) # CMake 最低版本号要求
project (Demo) # 指定项目的名称
set(SRCS main.cpp ...) # 设置变量
include_directories(/usr/include/jsoncpp) # 添加头文件目录,比如使用的一些lib库
aux_source_directory(. DIR_SRCS) # 查找当前目录下的所有源文件,并将名称保存到 DIR_SRCS 变量
add_subdirectory(math) # 添加 math 子目录
add_executable(Demo main.cc ...) # 指定生成目标,第一个参数为目标文件名
add_library(MathFunctions ${DIR_LIB_SRCS}) # 添加一个库文件
target_link_libraries(Demo MathFunctions) # 添加链接库
cmake --help
cmake --help-command-list
cmake --help-variable-list
示例代码
示例代码1:
1 cmake_minimum_required(VERSION 2.8) # CMake 最低版本号要求 2 3 set(CMAKE_CXX_FLAGS "-std=c++0x") # 设置编译参数 4 include_directories(/usr/include/jsoncpp) # 添加头文件目录 5 6 set(SRCS # 设置变量SRCS,将所有源文件添加到变量SRCS 7 SamsungRequestResolver.cpp 8 SamsungResolverContainer.cpp 9 SamsungResponseResolver.cpp 10 BanCat.cpp 11 main.cpp 12 ) 13 14 add_executable(framework ${SRCS}) # 指定生成目标 15 target_link_libraries(framework jsoncpp hiredis boost_system) # 添加链接库
示例代码2:(来源于参考引用1)
代码目录如下所示,./Demo3目录下有一个main.cc文件和一个math目录。对于这种嵌套目录的情况,需要在目录 ./Demo3 和 ./Demo3/math 下各创建一个CMakeLists.txt。
1 ./Demo3 2 | 3 +--- main.cc 4 | 5 +--- math/ 6 | 7 +--- MathFunctions.cc 8 | 9 +--- MathFunctions.h
父目录中的 CMakeLists.txt :
1 # CMake 最低版本号要求 2 cmake_minimum_required (VERSION 2.8) 3 # 项目信息 4 project (Demo3) 5 # 查找当前目录下的所有源文件 6 # 并将名称保存到 DIR_SRCS 变量 7 aux_source_directory(. DIR_SRCS) 8 # 添加 math 子目录,math目录下的CMakeLists.txt文件和源代码会被处理 9 add_subdirectory(math) 10 # 指定生成目标Demo 11 add_executable(Demo main.cc) 12 # 添加链接库 13 target_link_libraries(Demo MathFunctions)
子目录中的 CMakeLists.txt:
1 # 查找当前目录下的所有源文件 2 # 并将名称保存到 DIR_LIB_SRCS 变量 3 aux_source_directory(. DIR_LIB_SRCS) 4 # 生成链接库 5 add_library(MathFunctions ${DIR_LIB_SRCS})
编译
在编译之前,首先要将CMakeLists.txt文件放在代码目录中。为了方便管理生成的makefile文件、目标文件等文件,最好创建一个build目录专门用来存放这些文件。在代码目录,依次执行以下命令:
mkdir build
cd build
cmake ..
make
参考引用:
1. http://www.hahack.com/codes/cmake/
2. https://www.cnblogs.com/qixianyu/p/6574048.html