Cmake Practice学习笔记
PROJECT指令:
PROJEXT(projectname [CXX] [C] [Java] )
例如:PROJECT (HELLO)
功能:用来定义工程名称,并可指定工程支持的语言,支持列表可以忽略,默认支持所有语言。
该指令使用后隐式的定义了两个变量:
<projectname>_BINARY_DIR
,表示编译路径,等价于HELLO_BINARY_DIR
<projectname>_SOURCE_DIR
,表示**工程路径,**等价于HELLO_SOURCE_DIR
此外,cmake系统默认预定义了:
PROJECT_BINARY_DIR
,等价于HELLO_BINARY_DIR
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})
功能:用来向终端输出用户定义的信息
信息的类型包括三类:
SEND_ERROR
:产生错误,生成过程被跳过。SATUS
:输出前缀为“—”的信息。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
指令来重新定义一下两个变量来指定最终目标二进制的位置:
EXECUTABLE_OUTPUT_PATH
:最终可执行文件的位置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
**可以修改目录