cmake 常用变量和常用环境变量

参考:CMake学习笔记二:cmake 常用变量和常用环境变量

1 cmake 变量引用的方式

使用 ${} 进行变量的引用。在 IF 等语句中,是直接使用变量名而不通过 ${} 取值。

2 cmake 自定义变量的方式

主要有隐式定义和显式定义两种,举一个隐式定义的例子,就是 PROJECT()指令,他会隐式的定义<projectname>_BINARY_DIR 和<projectname>_SOURCE_DIR 两个变量。
而显式定义的例子,可以使用 SET 指令,就可以构建一个自定义变量了。

3.cmake 常用变量

对于整个项目:

  • PROJECT_BINARY_DIR(工程编译发生的目录):如果是 in source 编译,这个变量指得就是工程顶层目录,如果是 out-of-source 编译,指的是工程编译发生的目录。另外 <projectname>_BINARY_DIR 和 CMAKE_BINARY_DIR 跟这个变量指代的内容是一致的。
  • PROJECT_SOURCE _DIR(工程顶层目录):不论采用何种编译方式,都是工程顶层目录。也就是在 in source 编译时,他跟 PROJECT_BINARY_DIR 等变量一致。另外 <projectname>_SOURCE_DIR 和 CMAKE_SOURCE_DIR 跟这个变量指代的内容是一致的。
    【是最上层的CMakeLists.txt所在目录吗?】

一个项目中可以包含多个子项目,每个子项目都包含一个CMakeLists.txt。下面变量用于表示当前操作的是哪个CMakeLists.txt:

  • CMAKE_CURRRENT_BINARY_DIR(当前子项目编译发生的目录):如果是 in-source 编译,它跟 CMAKE_CURRENT_SOURCE_DIR 一致,如果是 out-ofsource 编译,他指的是 target 编译目录。使用 ADD_SUBDIRECTORY(src bin) 可以更改这个变量的值。

  • CMAKE_CURRENT_SOURCE_DIR(当前子项目顶层目录):指的是当前处理的 CMakeLists.txt 所在的目录。

  • CMAKE_CURRENT_LIST_FILE:输出调用这个变量的 CMakeLists.txt 的完整路径(包括CMakeLists.txt)。

  • CMAKE_CURRENT_LIST_LINE:输出这个变量所在的行(一个整数)

一些路径的设置:

  • EXECUTABLE_OUTPUT_PATH 和 LIBRARY_OUTPUT_PATH:前者用来重新定义目标二进制可执行文件的存放位置,后者用来重新定义目标链接库文件的存放位置。
  • PROJECT_NAME:返回通过 PROJECT 指令定义的项目名称。
  • CMAKE_MODULE_PATH:这个变量用来定义自己的 cmake 模块所在的路径。如果你的工程比较复杂,有可能会自己编写一些 cmake 模块,这些 cmake 模块是随你的工程发布的,为了让 cmake 在处理CMakeLists.txt 时找到这些模块,你需要通过 SET 指令,将自己的 cmake 模块路径设置一下。比如
    SET(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)
    这时候你就可以通过 INCLUDE 指令来调用自己的模块了。

4 cmake 调用环境变量的方式

调用环境变量的方式是:\(ENV{NAME},比如\)ENV{HOME}

设置环境变量的方式是:SET(ENV{变量名} 值)

5 系统信息

1,CMAKE_MAJOR_VERSION,CMAKE 主版本号,比如 2.4.6 中的 2
2,CMAKE_MINOR_VERSION,CMAKE 次版本号,比如 2.4.6 中的 4
3,CMAKE_PATCH_VERSION,CMAKE 补丁等级,比如 2.4.6 中的 6
4,CMAKE_SYSTEM,系统名称,比如 Linux-2.6.22
5,CMAKE_SYSTEM_NAME,不包含版本的系统名,比如 Linux
6,CMAKE_SYSTEM_VERSION,系统版本,比如 2.6.22

6 主要的开关选项

1,CMAKE_ALLOW_LOOSE_LOOP_CONSTRUCTS

用来控制 IF ELSE 语句的书写方式。

2,BUILD_SHARED_LIBS

这个开关用来控制默认的库编译方式,如果不进行设置,使用 ADD_LIBRARY 并没有指定库类型的情况下,默认编译生成的库都是静态库。

如果 SET(BUILD_SHARED_LIBS ON)后,默认生成的为动态库。

3,CMAKE_C_FLAGS

设置 C 编译选项,也可以通过指令 ADD_DEFINITIONS()添加。

4,CMAKE_CXX_FLAGS

设置 C++编译选项,也可以通过指令 ADD_DEFINITIONS()添加。

7.编译选项

CMAKE_C_FLAGS   # c编译选项
CMAKE_CXX_FLAGS # c++编译选项
# 在CMAKE_CXX_FLAGS编译选项后追加-std=c++11
set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")

CMAKE_BUILD_TYPE 编译类型(Debug, Release)
# 设定编译类型为debug,调试时需要选择debug。相当于gcc中的-g选项
set(CMAKE_BUILD_TYPE Debug)  
# 设定编译类型为release,发布时需要选择release
set(CMAKE_BUILD_TYPE Release)

CMAKE_C_COMPILER:指定C编译器
CMAKE_CXX_COMPILER:指定C++编译器
EXECUTABLE_OUTPUT_PATH:可执行文件输出的存放路径
LIBRARY_OUTPUT_PATH:库文件输出的存放路径
posted @ 2022-11-04 15:54  好人~  阅读(594)  评论(0编辑  收藏  举报