Cmake Practice学习笔记

Cmake Practice学习笔记

PROJECT指令：

PROJEXT(projectname [CXX] [C] [Java] )

例如：PROJECT (HELLO)

功能：用来定义工程名称，并可指定工程支持的语言，支持列表可以忽略，默认支持所有语言。

该指令使用后隐式的定义了两个变量：

1. <projectname>_BINARY_DIR，表示编译路径，等价于HELLO_BINARY_DIR
2. <projectname>_SOURCE_DIR，表示**工程路径，**等价于HELLO_SOURCE_DIR

此外，cmake系统默认预定义了：

1. PROJECT_BINARY_DIR，等价于HELLO_BINARY_DIR
2. PROJECT_SOURCE_DIR，等价于HELLO_SOURCE_DIR

两者区别在于：PROJECT永远指向当前工程名字，而另一种方法在修改工程名以后要全部修改，建议用PROJECT

SET指令

SET(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])

例如：SET(SRC_LIST main.c)

功能：SET命令可以用来显示定义变量，在cmake中引用变量的方式是**${}**;

MWSSAGE指令

MESSAGE([SEND_ERROR | STATUS | FATAL_ERROR] "message to display"...)

例如：MESSAGE(STATUS "This is BINARY dir " ${HELLO_BINARY_DIR})

功能：用来向终端输出用户定义的信息

信息的类型包括三类：

1. SEND_ERROR：产生错误，生成过程被跳过。
2. SATUS：输出前缀为“—”的信息。
3. FATAL_ERROR：立即终止cmake过程。

ADD_EXECUTABLE指令

ADD_EXECUTABLE(可执行文件,src1,src2,src3...);

例如：ADD_EXECUTABLE(hello ${SRC_LIST})

功能：定义这个工程生成一个名为hello的可执行文件，相关源文件是SRC_LIST中定义的源文件列表

ADD_SUBDIRECTORY 指令

ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])

例如：ADD_SUBDIRECTORY(src bin)

功能：用于向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置。EXCLUDE_FROM_ALL将这个目录从编译过程中排除。

我们可以使用SET指令来重新定义一下两个变量来指定最终目标二进制的位置：

1. EXECUTABLE_OUTPUT_PATH：最终可执行文件的位置
2. LIBRARY_OUTPUT_PATH：最终库的位置

例如：

SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

注意：在哪里ADD_EXECUTABLE或 ADD_LIBRARY，如果需要改变目标存放路径，就在哪里加入上述的定义。

INSTALL指令

目标文件的安装：INSTALL(TARGETS targets...)。

普通文件的安装：INSTALL(FILES files...)

非目标文件的可执行文件的安装：INSTALL(PROGRAMS files...)

目录的安装：INSTALL(DIRECTORY dirs...)

功能：将编译好的文件安装到用户的目录中，通过变量**CMAKE_INSTALL_PREFIX**可以修改目录