CMake学习笔记

超、凢脫俗 2022-07-25 21:29 157阅读 0赞

由于在Linux下写程序的话，需要用到很多库，如果工程较大的话，编译命令可能会很长，将编译的工作交给CMake是一个比较好的选择。

我在Linux下用CLion这个IDE，它用到的是CMake管理项目的编译工作。这些笔记是我看网上别人的笔记的时候记下来的。网上那篇笔记《CMake Practice》写得不错。

### cmake语法 ###

变量名大小写相关，文件名大小写也相关，指令大小写无关。指令和变量推荐使用大写。

例如：

set(src_list main.c) != set(SRC_LIST main.c)
    set(src_list main.c) != set(src_list MAIN.C)
    set(src_list main.c) == SET(src_list main.c)

### 一些常用的变量 ###

EXECTABLE\_OUTPUT\_PATH: 这个变量是指定编译出来的可执行文件的输出路径

LIBRARY\_OUTPUT\_PATH: 这个变量指定编译出来的库文件的输出路径

< porjectname>\_BINARY\_DIR: 编译所在目录

< porjectname>\_SOURCE\_DIR: 源代码所在目录

### 一些常用的指令 ###

INCLUDE\_DIRECTORIES(dir1 dir2 …):头文件的搜索路径

LINK\_DIRECTORIES(dir1 dir2 …):添加非标准的共享库搜索路径

TARGET\_LINK\_LIBRARIES(target library1 …):这个指令可以用来为 target 添加需要链接的共享库

用这三个指令就可以实现包含头文件，包含动态链接库的功能，但是这样需要将路径指定，一旦换了环境，很可能需要很多更改。那么我们可以用下面这些更高级的指令来完成我们需要的任务。  
FIND\_PATH():

export CMAKE_INCLUDE_PATH=/usr/include/hello
    FIND_PATH(myHeader hello.h)
    IF(myHeader)
    INCLUDE_DIRECTORIES(${myHeader})
    ENDIF(myHeader)
    这里我们没有指定路径,但是,cmake 仍然可以帮我们找到 hello.h 存放的路径,就是因为我们设置了环境变量 CMAKE_INCLUDE_PATH。

我们还可以在FIND\_PATH()里面制定搜索路径：

FIND_PATH(myHeader NAMES hello.h PATHS /usr/include /usr/include/hello)

FIND\_LIBRARY():用法同FIND\_PATH()，找到后用LINK\_DIRECTORIES()

### cmake变量 ###

1.  cmake变量引用的方式:
    
    前面我们已经提到了,使用$\{\}进行变量的引用。在IF等语句中,是直接使用变量名而不通过$\{\}取值
2.  cmake自定义变量：
    
    主要有隐式定义和显式定义两种
    
     *  PROJECT 指令,他 会隐式的定义< projectname>\_BINARY\_DIR 和< projectname>\_SOURCE\_DIR 两个变 量。
     *  使用 SET 指令

### 编写FIND\_PACKAGE() ###

用来调用预定义在 CMAKE\_MODULE\_PATH 下的 Find< name>.cmake 模块,你也可以自己 定义Find< name>模块,这样可以使每个CMakeLists.txt更短小，更易读。  
FIND\_PACKAGE()区分参数的大小写。

FIND_PACKAGE(MySQL) != FIND_PACKAGE(mysql)