cmake 变量引用的方式:
使用${}进行变量的引用。在 IF 等语句中,是直接使用变量名而不
通过${}取值。
cmake自定义变量的方式
隐式定义例子:<project_name>_BINARY_DIR和<project_name>_SOURCE_DIR
显式定义:使用set
cmake常用变量:
1.CMAKE_BINARY_DIR PROJECT_BINARY_DIR _BINARY_DIR 这三个变量指代的内容是一致的,如果是 in source 编译,指得就是工程顶层目录,如果是 out-of-source 编译,指的是工程编译发生的目录。PROJECT_BINARY_DIR 跟其他 指令稍有区别,现在,你可以理解为他们是一致的。
2.CMAKE_SOURCE_DIR PROJECT_SOURCE_DIR <project_name>_SOURCE_DIR 这三个变量指代的内容是一致的,不论采用何种编译方式,都是工程顶层目录。 也就是在 in source 编译时,他跟 CMAKE_BINARY_DIR 等变量一致。 PROJECT_SOURCE_DIR 跟其他指令稍有区别。
-
CMAKE_CURRENT_SOURCE_DIR指的是当前处理的 CMakeLists.txt 所在的路径。 -
CMAKE_CURRRENT_BINARY_DIR如果是 in-source 编译,它跟CMAKE_CURRENT_SOURCE_DIR一致,如果是 out-of-source 编译,他指的是 target 编译目录。 使用ADD_SUBDIRECTORY(src bin)可以更改这个变量的值。 使用SET(EXECUTABLE_OUTPUT_PATH <新路径>)并不会对这个变量造成影响,它仅仅修改了最终目标文件存放的路径。 -
CMAKE_CURRENT_LIST_FILE输出调用这个变量的 CMakeLists.txt 的完整路径 -
CMAKE_CURRENT_LIST_LINE输出这个变量所在的行 -
CMAKE_MODULE_PATH这个变量用来定义自己的 cmake 模块所在的路径。如果你的工程比较复杂,有可能会自己 编写一些 cmake 模块,这些 cmake 模块是随你的工程发布的,为了让 cmake 在处理 CMakeLists.txt 时找到这些模块,你需要通过 SET 指令,将自己的 cmake 模块路径设 置一下。 比如SET(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)这时候你就可以通过 INCLUDE 指令来调用自己的模块了。 -
EXECUTABLE_OUTPUT_PATH和LIBRARY_OUTPUT_PATH分别用来重新定义最终结果的存放目录,前面我们已经提到了这两个变量。 -
PROJECT_NAME返回通过 PROJECT 指令定义的项目名称。
cmake 调用环境变量的方式
使用$ENV{NAME}指令就可以调用系统的环境变量了。 比如 MESSAGE(STATUS “HOME dir: $ENV{HOME}”)
设置环境变量的方式是: SET(ENV{变量名} 值)
-
CMAKE_INCLUDE_CURRENT_DIR自动添加CMAKE_CURRENT_BINARY_DIR和CMAKE_CURRENT_SOURCE_DIR到当前处理 的 CMakeLists.txt。相当于在每个 CMakeLists.txt 加入:INCLUDE_DIRECTORIES(${CMAKE_CURRENT_BINARY_DIR} ${CMAKE_CURRENT_SOURCE_DIR}) -
CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE将工程提供的头文件目录始终至于系统头文件目录的前面,当你定义的头文件确实跟系统发生冲突时可以提供一些帮助。 -
CMAKE_INCLUDE_PATH和CMAKE_LIBRARY_PATH。
系统信息
-
CMAKE_MAJOR_VERSION,CMAKE 主版本号 -
CMAKE_MINOR_VERSION,CMAKE 次版本号 -
CMAKE_PATCH_VERSION,CMAKE 补丁等级 -
CMAKE_SYSTEM,系统名称,比如 Linux-2.6.22 -
CMAKE_SYSTEM_NAME,不包含版本的系统名,比如 Linux -
CMAKE_SYSTEM_VERSION,系统版本,比如 2.6.22 -
CMAKE_SYSTEM_PROCESSOR,处理器名称,比如 i686. -
UNIX,在所有的类 UNIX 平台为 TRUE,包括 OS X 和 cygwin
-
WIN32,在所有的 win32 平台为 TRUE,包括 cygwin
主要的开关选项:
-
CMAKE_ALLOW_LOOSE_LOOP_CONSTRUCTS,用来控制IF ELSE语句的书写方式 -
BUILD_SHARED_LIBS这个开关用来控制默认的库编译方式,如果不进行设置,使用 ADD_LIBRARY 并没有指定库 类型的情况下,默认编译生成的库都是静态库。 如果 SET(BUILD_SHARED_LIBS ON)后,默认生成的为动态库。 -
CMAKE_C_FLAGS设置C编译选项,也可以通过指令ADD_DEFINITIONS()添加。 -
CMAKE_CXX_FLAGS设置 C++编译选项,也可以通过指令ADD_DEFINITIONS()添加。