CMake使用介绍

最近，公司的代码编译从直接使用 GNU make 转向了 cmake.

下面介绍一下cmake 的使用

1)  cmake 的基本语法

cmake 可以看作一种脚本语言，它的一些语法和其他一下脚本语言（bash, python等）是相似的。

1.1 命令：

基本格式为

command(param)

命令可大写或者小写  (case-insensitive)

1.1 变量

引用变量 var的值： ${var}

给变量赋值：

  set(Foo a b c) 

或者

 set(Foo a;b;c)

Foo 的值为 a b c (一个 list)

$ENV{name} --》得到环境变量的值

2. 流程控制：

2.1 if 语句

# some_command will be called if the variable's value is not:# empty, 0, N, NO, OFF, FALSE, NOTFOUND, or -NOTFOUND.if(var)   some_command(...)endif(var) 

2. loop:

set(VAR a b c)  # loop over a, b,c with the variable fforeach(f ${VAR})    message(${f})endforeach(f) 

3. 宏和函数

# define a macro hellomacro(hello MESSAGE)    message(${MESSAGE})endmacro(hello)# call the macro with the string "hello world"hello("hello world")# define a function hellofunction(hello MESSAGE)    message(${MESSAGE})endfunction(hello) 

下面举个例子来说明如何使用 cmake.

下面的例子中, 我们用 cmake 来生成静态库,动态库, 并使用生成的库文件.

代码树如下:

.├── CMakeLists.txt├── FooFunctions│   ├── CMakeLists.txt│   ├── inc│   │   └── foo.h│   └── src│       └── foo.c├── MathFunctions│   ├── CMakeLists.txt│   ├── inc│   │   └── mysqrt.h│   └── src│       └── mysqrt.c└── tutorial.c

tutorial.c 是测试代码,  FooFunctions 下的文件生成共享库, mathFunctions 下的代码生成静态库.

top-level CMakeList.txt 如下:

cmake_minimum_required (VERSION 2.6)  2 project (Tutorial)  3   4 set(CMAKE_BUILD_TYPE Debug)  5   6 #message(status "PROJECT_SOURCE_DIR = ${PROJECT_SOURCE_DIR}")  7 #message(status "PROJECT_BINARY_DIR = ${PROJECT_BINARY_DIR}")  8 #message(status "CMAKE_SOURCE_DIR = ${CMAKE_SOURCE_DIR}")  9 #message(status "CMAKE_BINARY_DIR = ${CMAKE_BINARY_DIR}") 10  11 include_directories ("${PROJECT_SOURCE_DIR}/MathFunctions/inc") 12 include_directories("${PROJECT_SOURCE_DIR}/FooFunctions/inc") 13 add_subdirectory (MathFunctions) 14 add_subdirectory(FooFunctions) 15  16 add_executable(Tutorial tutorial.c) 17 target_link_libraries (Tutorial MathFunctions m FooFunctions) 18 set_target_properties(Tutorial PROPERTIES RUNTIME_OUTPUT_DIRECTORY ../BIN)

解释如下:

1) set(CMAKE_BUILD_TYPE Debug)

设置debug模式,也就是 gcc 加上 -g 选项

也可以用

set(CMAKE_C_FLAGS   ${CMAKE_C_FLAGS} "-g -Wall")

或者命令行设置：

cmake -DCMAKE_BUILD_TYPE=Debug/Release  dir

2) include_directories

设置头文件的搜索路径.  相当于 C_FLAGS 加上 "-I"

3)add_executable

设置生成的可执行文件

4) add_subdirectory  
设置包含 其它 CMakeLists.txt的目录.

一般,需要单独变成一个库的代码,都要有一个    CMakeLists.txt

5)target_link_libraries

设置要 link到可执行文件的库

6)set_target_properties

这里是设置可执行文件的位置

然后再看一下 FooFunctions 下的 CMakeLists.txt:

 set(shared_src src/foo.c)  2 add_library(FooFunctions SHARED ${shared_src})  3 include_directories("${PROJECT_SOURCE_DIR}/FooFunctions/inc")  4 set_target_properties(FooFunctions PROPERTIES LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/LIB)  5 set_target_properties(FooFunctions PROPERTIES VERSION 1.1 SOVERSION 1)

第二行是设置库为共享库, 最后一行设置生成的共享库版本:VERSION: build version; SOVERSION: API version

比如，最后生成的共享库如下:

$ ls LIB/ -ltotal 12lrwxrwxrwx 1 charles charles   20 Feb 20 01:38 libFooFunctions.so -> libFooFunctions.so.1lrwxrwxrwx 1 charles charles   22 Feb 20 01:38 libFooFunctions.so.1 -> libFooFunctions.so.1.1-rwxrwxr-x 1 charles charles 7726 Feb 20 01:38 libFooFunctions.so.1.1

MathFunctions 下的  CMakeLists.txt如下:

  1 add_library(MathFunctions src/mysqrt.c)  2 set_target_properties(MathFunctions PROPERTIES ARCHIVE_OUTPUT_DIRECTORY ${CM    AKE_BINARY_DIR}/LIB)

第一行是设置静态库

每一个 CMakeLists.txt 都会生成一组 Makefile文件.

其中主要的是 Makefile, link.txt 和 flags.make

link.txt 是用来生成可执行文件或者库的命令. flags.make 则是命令选项.

比如, top-level CMakeLists.txt 的 link.txt 为:

charles@mikiehara:~/Code/cmake_tutorial/cmake/CMakeFiles/Tutorial.dir$ cat link.txt /usr/bin/gcc  -g    CMakeFiles/Tutorial.dir/tutorial.c.o  -o ../BIN/Tutorial -rdynamic LIB/libMathFunctions.a -lm LIB/libFooFunctions.so.1.1 -Wl,-rpath,/home/charles/Code/cmake_tutorial/cmake/LIB 

flags.make  为:

charles@mikiehara:~/Code/cmake_tutorial/cmake/CMakeFiles/Tutorial.dir$ cat flags.make # CMAKE generated file: DO NOT EDIT!# Generated by "Unix Makefiles" Generator, CMake Version 2.8# compile C with /usr/bin/gccC_FLAGS = -g -I/home/charles/Code/cmake_tutorial/MathFunctions/inc -I/home/charles/Code/cmake_tutorial/FooFunctions/inc   C_DEFINES =