Cmake 入门
前言
- CMake是一个比make更高级的编译配置工具，它可以根据不同平台、不同的编译器，生成相应的Makefile或者vcproj项目
- 通过编写CMakeLists.txt，可以控制生成的Makefile，从而控制编译过程。CMake自动生成的Makefile不仅可以通过make命令构建项目生成目标文件，还支持安装（make install）、测试安装的程序是否能正确执行（make test，或者ctest）、生成当前平台的安装包（make package）、生成源码包（make package_source）、产生Dashboard显示数据并上传等高级功能，只要在CMakeLists.txt中简单配置，就可以完成很多复杂的功能，包括写测试用例。
- 如果有嵌套目录，子目录下可以有自己的CMakeLists.txt。
下载
下载网页
https://cmake.org/download/
下载地址
https://cmake.org/files/v3.9/cmake-3.9.2-win64-x64.msi
示例
结构
├── build
├── include
| └── add.h
└── src
├── add.c
└── main.c
── CMakeLists.txt
代码
- add.h
int add(int a,int b);
- add.c
#include "../include/add.h"
int add(int a,int b)
{
return a+b;
}
- main.c
#include "../include/add.h"
#include <stdio.h>
int main(int argc,char** argv)
{
int reslut=add(3,4);
printf("结果 %d ",reslut);
return 0;
}
- CMakeLists.txt
#1.cmake verson，指定cmake版本
cmake_minimum_required(VERSION 2.6)
#2.project name，指定项目的名称，一般和项目的文件夹名称对应
PROJECT(main)
#包含的头文件目录
INCLUDE_DIRECTORIES(
include
)
#指定源文件目录
AUX_SOURCE_DIRECTORY(src DIR_SRCS)
MESSAGE(STATUS "开始构建")
#设置
SET(TEST_MATH ${DIR_SRCS})
ADD_EXECUTABLE(${PROJECT_NAME} ${TEST_MATH})
- CMake命令是大小写不敏感的，你可以用大写，也可以用小写，也可以混写。
- ${CMAKE_CURRENT_SOURCE_DIR}表示CMakeLists.txt所在的目录
语法
-
注释
变量：使用set命令显式定义及赋值，在非if语句中，使用${}引用，if中直接使用变量名引用；
后续的set命令会清理变量原来的值；command (args ...)
命令不分大小写，参数使用空格分隔，使用双引号引起参数中空格set(var a;b;c) <=> set(var a b c)
定义变量var并赋值为a;b;c这样一个string listAdd_executable(${var}) <=> Add_executable(a b c)
变量使用${xxx}引用条件语句：
if(var) #var 非empty 0 N No OFF FALSE... #非运算使用NOT
else()/elseif() … endif(var)
循环语句
Set(VAR a b c)
Foreach(f ${VAR}) …Endforeach(f)循环语句
WHILE() … ENDWHILE()
内部变量
- CMAKE_C_COMPILER：指定C编译器
- CMAKE_CXX_COMPILER：
- CMAKE_C_FLAGS：编译C文件时的选项，如-g；也可以通过add_definitions添加编译选项
- EXECUTABLE_OUTPUT_PATH：可执行文件的存放路径
- LIBRARY_OUTPUT_PATH：库文件路径
- CMAKE_BUILD_TYPE:：build 类型(Debug, Release, ...)，CMAKE_BUILD_TYPE=Debug
- BUILD_SHARED_LIBS：Switch between shared and static libraries
命令
- project (HELLO) #指定项目名称，生成的VC项目的名称；
使用${HELLO_SOURCE_DIR}表示项目根目录
- include_directories：指定头文件的搜索路径，相当于指定gcc的-I参数
include_directories (${HELLO_SOURCE_DIR}/Hello) #增加Hello为include目录
- link_directories：动态链接库或静态链接库的搜索路径，相当于gcc的-L参数
link_directories (${HELLO_BINARY_DIR}/Hello) #增加Hello为link目录
- add_subdirectory：包含子目录
add_subdirectory (Hello)
- add_executable：编译可执行程序，指定编译，好像也可以添加.o文件
add_executable (helloDemo demo.cxx demo_b.cxx) #将cxx编译成可执行文件——
- add_definitions：添加编译参数
add_definitions(-DDEBUG)将在gcc命令行添加DEBUG宏定义；
add_definitions( “-Wall -ansi –pedantic –g”)
- target_link_libraries：添加链接库,相同于指定-l参数
target_link_libraries(demo Hello) #将可执行文件与Hello连接成最终文件demo
- add_library:
add_library(Hello hello.cxx) #将hello.cxx编译成静态库如libHello.a
add_custom_target:
message( status|fatal_error, “message”):
在指定目录下搜索一个库, 保存在变量MY_LIB中
find_ibrary(MY_LIB libmylib.a ./)
- set_target_properties( ... ):
lots of properties... OUTPUT_NAME, VERSION,....
- link_libraries( lib1 lib2 ...):
All targets link with the same set of libs
