一、cmake的常用命令
基本语法规则:
- 1.cmake变量使用${}方式取值,但是在IF控制语句中是直接使用变量名。
- 2.环境变量使用$ENV{}方式取值,使用SET(ENV{VAR} VALUE)赋值。
- 3.指令不区分大小写,一般推荐使用大写。
- eg:指令(参数1 参数2…) 参数使用括弧括起,参数之间使用空格或分号分开。
二、常用命令列表:
1.PROJECT
PROJECT(projectname [CXX] [C] [Java])
指定工程名称,并可指定工程支持的语言。支持语言列表可忽略,默认支持所有语言
- 2.SET
SET(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])
定义变量(可以定义多个VALUE,如SET(SRC_LIST main.c util.c reactor.c)) - 3.MESSAGE
MESSAGE([SEND_ERROR | STATUS | FATAL_ERROR] “message to display” …)
向终端输出用户定义的信息或变量的值,SEND_ERROR:产生错误,生成过程被跳过;STATUS:输出前缀为—的信息;FATAL_ERROR:立即终止所有cmake过程 - 4.ADD_EXECUTABLE
ADD_EXECUTABLE(bin_file_name ${SRC_LIST})
生成可执行文件 - 5.ADD_LIBRARY
ADD_LIBRARY(libname [SHARED | STATIC | MODULE] [EXCLUDE_FROM_ALL] SRC_LIST)
生成动态库或静态库 , SHARED 动态库;STATIC 静态库;MODULE 在使用dyld的系统有效,若不支持dyld,等同于SHARED;EXCLUDE_FROM_ALL 表示该库不会被默认构建 - 6.SET_TARGET_PROPERTIES
设置输出的名称,设置动态库的版本和API版本 - 7.CMAKE_MINIMUM_REQUIRED
CMAKE_MINIMUM_REQUIRED(VERSION version_number [FATAL_ERROR])
声明CMake的版本要求
-
- 8.ADD_SUBDIRECTORY
ADD_SUBDIRECTORY(src_dir [binary_dir] [EXCLUDE_FROM_ALL])
向当前工程添加存放源文件的子目录,并可以指定中间二进制和目标二进制的存放位置
9.EXCLUDE_FROM_ALL含义:将这个目录从编译过程中排除
- 8.ADD_SUBDIRECTORY
-
-
10.
INCLUDE_DIRECTORIES
-
10.
INCLUDE_DIRECTORIES
- INCLUDE_DIRECTORIES([AFTER | BEFORE] [SYSTEM] dir1 dir2 … )
- 11.LINK_DIRECTORIES
LINK_DIRECTORIES(dir1 dir2 …)
添加非标准的共享库搜索路径 - 12.TARGET_LINK_LIBRARIES
TARGET_LINK_LIBRARIES(target lib1 lib2 …)
为target添加需要链接的共享库 - 13.ADD_DEFINITIONS
向C/C++编译器添加-D定义
ADD_DEFINITIONS(-DENABLE_DEBUG -DABC),参数之间用空格分隔 - 14.ADD_DEPENDENCIES
ADD_DEPENDENCIES(target-name depend-target1 depend-target2 …)
定义target依赖的其他target,确保target在构建之前,其依赖的target已经构建完毕 - 15.AUX_SOURCE_DIRECTORY
AUX_SOURCE_DIRECTORY(dir VAR)
发现一个目录下所有的源代码文件并将列表存储在一个变量中,把当前目录下的所有源码文件名赋给变量DIR_HELLO_SRCS -
16.EXEC_PROGRAM
EXEC_PROGRAM(Executable [dir where to run] [ARGS <args>][OUTPUT_VARIABLE <var>] [RETURN_VALUE <value>])
用于在指定目录运行某个程序(默认为当前CMakeLists.txt所在目录),通过ARGS添加参数,通过OUTPUT_VARIABLE和RETURN_VALUE获取输出和返回值 17.INCLUDE -
INCLUDE(file [OPTIONAL]) 用来载入CMakeLists.txt文件
-
INCLUDE(module [OPTIONAL])用来载入预定义的cmake模块
-
OPTIONAL参数的左右是文件不存在也不会产生错误
-
可以载入一个文件,也可以载入预定义模块(模块会在CMAKE_MODULE_PATH指定的路径进行搜索)
-
载入的内容将在处理到INCLUDE语句时直接执行
-
18.FIND_
-
FIND_FILE(<VAR> name path1 path2 …) VAR变量代表找到的文件全路径,包含文件名
-
FIND_LIBRARY(<VAR> name path1 path2 …) VAR变量代表找到的库全路径,包含库文件名
-
FIND_PATH(<VAR> name path1 path2 …) VAR变量代表包含这个文件的路径
-
FIND_PROGRAM(<VAR> name path1 path2 …) VAR变量代表包含这个程序的全路径
-
FIND_PACKAGE(<name> [major.minor] [QUIET] [NO_MODULE] [[REQUIRED | COMPONENTS] [componets …]])
-
用来调用预定义在CMAKE_MODULE_PATH下的Find<name>.cmake模块,你也可以自己定义Find<name>模块,通过SET(CMAKE_MODULE_PATH dir)将其放入工程的某个目录供工程使用