[TOC]

常用命令

常用命令 命令解析 示例说明
INCLUDE_DIRECTORIES( “dir1” “dir2” … ) 头文件路径，相当于编译器参数 -Idir1 -Idir2 include_directories(“${PROJECT_BINARY_DIR}”)
LINK_DIRECTORIES(“dir1” “dir2”) 库文件路径。注意： 由于历史原因，相对路径会原样传递给链接器。 尽量使用FIND_LIBRARY而避免使用这个。
AUX_SOURCE_DIRECTORY( “sourcedir” variable) 收集目录中的文件名并赋值给变量
ADD_EXECUTABLE 可执行程序目标
ADD_LIBRARY 库目标
ADD_CUSTOM_TARGET 自定义目标
ADD_DEPENDENCIES( target1 t2 t3 ) 目标target1依赖于t2 t3
ADD_DEFINITIONS( “-Wall -ansi”) 本意是供设置 -D… /D… 等编译预处理需要的宏定义参数，对比 REMOVE_DEFINITIONS()
TARGET_LINK_LIBRARIES( target-name lib1 lib2 …) 设置单个目标需要链接的库
LINK_LIBRARIES( lib1 lib2 …) 设置所有目标需要链接的库
SET_TARGET_PROPERTIES( … ) 设置目标的属性 OUTPUT_NAME, VERSION, ….
MESSAGE(…)
INSTALL( FILES “f1” “f2”DESTINATION . ) DESTINATION 相对于 ${CMAKE_INSTALL_PREFIX}
SET( VAR value [CACHE TYPE DOCSTRING [FORCE]])
LIST( APPEND|INSERT|LENGTH|GET| REMOVE_ITEM|REMOVE_AT|SORT …) 列表操作
STRING( TOUPPER|TOLOWER|LENGTH| SUBSTRING|REPLACE|REGEX …) 字符串操作
SEPARATE_ARGUMENTS( VAR ) 转换空格分隔的字符串到列表
FILE( WRITE|READ|APPEND|GLOB| GLOB_RECURSE|REMOVE|MAKE_DIRECTORY …) 文件操作
FIND_FILE 注意 CMAKE_INCLUDE_PATH
FIND_PATH 注意 CMAKE_INCLUDE_PATH
FIND_LIBRARY 注意 CMAKE_LIBRARY_PATH
FIND_PROGRAM
FIND_PACKAGE 注意 CMAKE_MODULE_PATH
EXEC_PROGRAM( bin [work_dir] ARGS <..> [OUTPUT_VARIABLE var] [RETURN_VALUE var] ) 执行外部程序
OPTION( OPTION_VAR “description” [initial value] )