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

最新推荐文章于 2023-07-19 15:00:28 发布
最新推荐文章于 2023-07-19 15:00:28 发布
阅读量349 收藏
点赞数
分类专栏： cmake快速入门 文章标签： c++ 服务器 linux cmake
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_29407397/article/details/127685040
版权

cmake 变量引用的方式

前面我们已经提到了，使用${}进行变量的引用。在 IF 等语句中，==是直接使用变量名而不通过${}取值==
如下定义SRC

project(t5)

set(SRC  main.c)
message("custom var==" ${SRC})

编译过程如下:

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
-- The C compiler identification is GNU 9.4.0
-- The CXX compiler identification is GNU 9.4.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
custom var==main.c
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build

cmake 自定义变量的方式

主要有隐式定义和显式定义两种，前面举了一个隐式定义的例子，就是 PROJECT 指令，他会隐式的定义<projectname>_BINARY_DIR 和<projectname>_SOURCE_DIR 两个变量。
显式定义的例子我们前面也提到了，使用 SET 指令，就可以构建一个自定义变量了。

cmake 常用变量

BINARY_DIR

CMAKE_BINARY_DIR
PROJECT_BINARY_DIR
<projectname>_BINARY_DIR

这三个变量指代的内容是一致的，如果是 in source 编译，指得就是工程顶层目录，如果是 out-of-source 编译，指的是工程编译发生的目录。PROJECT_BINARY_DIR 跟其他指令稍有区别，现在，你可以理解为他们是一致的。
例如我们CMakeLists.txt:

project(t5)

set(SRC  main.c)
message("custom var==" ${SRC})
message("CMAKE_BINARY_DIR==" ${CMAKE_BINARY_DIR})
message("PROJECT_BINARY_DIR==" ${PROJECT_BINARY_DIR})
message("<projectname>_BINARY_DIR==" ${t5_BINARY_DIR})

如下目录结构,

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5# tree
.
├── CMakeLists.txt
├── build
└── main.c

1 directory, 2 files

in source 和out of source 的结果如下:
in source

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5# cmake .
custom var==main.c
CMAKE_BINARY_DIR==/mnt/d/study/lwstudy/cmake/t5
PROJECT_BINARY_DIR==/mnt/d/study/lwstudy/cmake/t5
<projectname>_BINARY_DIR==/mnt/d/study/lwstudy/cmake/t5
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5#

out-of-source

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
custom var==main.c
CMAKE_BINARY_DIR==/mnt/d/study/lwstudy/cmake/t5/build
PROJECT_BINARY_DIR==/mnt/d/study/lwstudy/cmake/t5/build
<projectname>_BINARY_DIR==/mnt/d/study/lwstudy/cmake/t5/build
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build#

SOURCE_DIR

CMAKE_SOURCE_DIR
PROJECT_SOURCE_DIR
<projectname>_SOURCE_DIR

这三个变量指代的内容是一致的，不论采用何种编译方式，都是工程顶层目录。也就是在 in source 编译时，他跟 CMAKE_BINARY_DIR 等变量一致。PROJECT_SOURCE_DIR 跟其他指令稍有区别，现在，你可以理解为他们是一致的。
如下CMakeLists.txt

project(t5)

set(SRC  main.c)
message("custom var==" ${SRC})
message("CMAKE_SOURCE_DIR==" ${CMAKE_SOURCE_DIR})
message("PROJECT_SOURCE_DIR==" ${PROJECT_SOURCE_DIR})
message("<projectname>_SOURCE_DIR==" ${t5_SOURCE_DIR})

in source

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5# cmake .
custom var==main.c
CMAKE_SOURCE_DIR==/mnt/d/study/lwstudy/cmake/t5
PROJECT_SOURCE_DIR==/mnt/d/study/lwstudy/cmake/t5
<projectname>_SOURCE_DIR==/mnt/d/study/lwstudy/cmake/t5
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5#

out in source

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
custom var==main.c
CMAKE_SOURCE_DIR==/mnt/d/study/lwstudy/cmake/t5
PROJECT_SOURCE_DIR==/mnt/d/study/lwstudy/cmake/t5
<projectname>_SOURCE_DIR==/mnt/d/study/lwstudy/cmake/t5
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build#

CMAKE_CURRENT_SOURCE_DIR

指的是当前处理的 CMakeLists.txt 所在的路径，比如上面我们提到的 src 子目录。
如CMakeLists.txt文件:

project(t5)

message("CMAKE_CURRENT_SOURCE_DIR==" ${CMAKE_CURRENT_SOURCE_DIR})

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
CMAKE_CURRENT_SOURCE_DIR==/mnt/d/study/lwstudy/cmake/t5
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build#

CMAKE_CURRRENT_BINARY_DIR

如果是 in-source 编译，它跟 CMAKE_CURRENT_SOURCE_DIR 一致，如果是 out-ofsource 编译，他指的是 target 编译目录。
使用我们上面提到的 ADD_SUBDIRECTORY(src bin)可以更改这个变量的值。
使用 SET(EXECUTABLE_OUTPUT_PATH <新路径>)并不会对这个变量造成影响，它仅仅修改了最终目标文件存放的路径。

CMAKE_CURRENT_LIST_FILE

输出调用这个变量的 CMakeLists.txt 的完整路径

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
CMAKE_CURRENT_LIST_FILE==/mnt/d/study/lwstudy/cmake/t5/CMakeLists.txt
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build#

CMAKE_CURRENT_LIST_LINE

输出这个变量所在的行

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
CMAKE_CURRENT_LIST_LINE==14
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build#

CMAKE_MODULE_PATH

这个变量用来定义自己的 cmake 模块所在的路径。如果你的工程比较复杂，有可能会自己编写一些 cmake 模块，这些 cmake 模块是随你的工程发布的，为了让 cmake 在处理CMakeLists.txt 时找到这些模块，你需要通过 SET 指令，将自己的 cmake 模块路径设置一下。在第9节会涉及

比如
SET(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)这时候你就可以通过 INCLUDE 指令来调用自己的模块了。

EXECUTABLE_OUTPUT_PATH 和 LIBRARY_OUTPUT_PATH

分别用来重新定义最终结果的存放目录，前面我们已经提到了这两个变量。

PROJECT_NAME

返回通过 PROJECT 指令定义的项目名称

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
PROJECT_NAME==t5
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build#

cmake 调用环境变量的方式

使用$ENV{NAME}指令就可以调用系统的环境变量了。 比如 MESSAGE(STATUS “HOME dir: $ENV{HOME}”)

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
HOME dir==/root
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build#

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

set(ENV{XXX} 123)
message("XXX value==" $ENV{XXX})

运行结果:

root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build# cmake ..
XXX value==123
-- Configuring done
-- Generating done
-- Build files have been written to: /mnt/d/study/lwstudy/cmake/t5/build
root@BIH-L-55661:/mnt/d/study/lwstudy/cmake/t5/build#

1, 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})

2, CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE
将工程提供的头文件目录始终至于系统头文件目录的前面，当你定义的头文件确实跟系统发生冲突时可以提供一些帮助。

3, CMAKE_INCLUDE_PATH 和 CMAKE_LIBRARY_PATH 我们在上一节已经提及。

系统信息

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
7,CMAKE_SYSTEM_PROCESSOR，处理器名称，比如 i686.
8,UNIX，在所有的类 UNIX 平台为 TRUE，包括 OS X 和 cygwin
9,WIN32，在所有的 win32 平台为 TRUE，包括 cygwin

主要的开关选项

  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()添加。

小结：

本章介绍了一些较常用的 cmake 变量，这些变量仅仅是所有 cmake 变量的很少一部分，目前 cmake 的英文文档也是比较缺乏的，如果需要了解更多的 cmake 变量，更好的方式是阅读一些成功项目的 cmake 工程文件，比如 KDE4 的代码。

刘大望
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
cmake常用常量和变量(六)
霜叶的博客
02-08 1678
1、cmake 变量引用的方式 前面我们已经提到了，使用${}进行变量的引用。在 IF 等语句中，是直接使用变量名而不 通过${}取值 2、cmake定义变量的方式 cmake主要有隐式定义和显式定义两种 2.1、隐式定义 前面举了一个隐式定义的例子，就是 PROJECT 指令，他会隐式的定义<projectname>_BINARY_DIR 和<projectname>_SOURCE_DIR 两个变 量。 2.2、显示定义 使用 SET 指令，就可以构建一个自定义变量了
CMake之内置变量
u010378559的博客
03-24 332
CMAKE_INSTALL_PREFIX：指定安装位置前缀，在install的时候使用。在设置完之后，执行install时可以通过DESTINATION安装在该变量指定的位置。
【02】CMake中变量的设置
m0_51586788的博客
07-08 1650
从源码编译 OpenCV 时都会用到 CMake 的内容，并且还经常通过 CMake 来为 OpenCV 项目进行配置。配置的过程中，如何向用户展示必要的参数以及屏蔽一些局部使用的参数显得十分重要。变量的属性与 C/C++ 语言类似，也有局部变量、全局变量的说法，此处的全局变量最正确的说法应该是缓存变量，表示为记录在文件中的变量。通常这些变量是能够被用户自定义修改的，例如在安装 OpenCV 的时候，使用cmake-gui的时候就会看到。一般通过修改这些变量，即可实现用户的自定义配置需求。
CMake快速上手
KaylerSang的博客
07-19 102
CMake是C++跨平台开发最常用的工具之一。本文旨在通过介绍CMake的基本语法，帮助快速上手CMake，完成基本的C++跨平台项目构建。
CMake变量专题：掌握常用变量和环境变量，助你轻松打造无懈可击工程
Lion_Long的博客
02-22 1563
这篇文章将深入探讨CMake中的常用变量和环境变量，以帮助读者掌握这些关键概念，从而提升对CMake项目管理的技能。我们将详细解析常用变量的定义、用法和最佳实践，使读者能够充分利用这些变量来优化项目结构和提高工作效率。同时，我们也将专注于讨论常用环境变量的作用和应用，帮助读者理解如何在CMake中正确配置和管理项目的环境设置。通过本文的阅读，读者将能够轻松理解和应用CMake中的常用变量和环境变量，从而打造更加高效、无懈可击的工程。
CMake实战-20200708.pdf
03-31
CMake的变量和环境变量包括： 1. CMake 变量引用方式 2. CMake 自定义变量的方式 3. CMake 常用变量 4. CMake 调用环境变量的方式 5. 系统信息 6. 主要的开关选项 CMake的常用指令包括： 1. 基本指令 2. INSTALL ...
Linux服务器下常用应用环境安装,nginxtomcatmysqlantjdk配置.pdf
10-27
5. **配置环境变量**：编辑`/etc/profile`文件，将`JAVA_HOME`、`CLASSPATH`和`PATH`添加到系统环境变量中，确保系统可以在任何路径下使用Java命令。 6. **验证安装**：通过`java -version`命令检查Java版本，确认...
Linux服务器下常用应用环境安装,nginxtomcatmysqlantjdk配置归类.pdf
01-14
4. 设置环境变量，编辑 `/etc/profile` 文件，在 `export PATH` 之前增加以下内容： ``` JAVA_HOME=/app/jdk1.6.0_26 CLASSPATH=.:$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar PATH=$JAVA_HOME/bin:$PATH ``` 5...
cmakelist教程，在ubuntu环境中使用C++
12-21
* 环境变量使用 $ENV{} 方式取值，使用 SET(ENV{VAR} VALUE) 赋值指令 * 参数使用括弧括起，参数之间使用空格或分号分开 常用命令: * cmake_minimum_required (VERSION 3.0) - 指定 cmake 的最小版本 * project...
cmake 构建多文件多目录项目教程
04-26
cmake 构建多文件多目录项目教程 cmake 是一个功能强大且灵活的构建工具，广泛应用于 C++ 项目的构建和管理。...通过学习和掌握 cmake 的常用环境变量、函数和构建方法，可以轻松地构建复杂的多文件多目录项目。
cmakelist 定义变量
jacke121的专栏
03-31 5825
自定义变量： SET(opencv_dir "/mnt/d/android/OpenCV-3.4.8-android-sdk") 调用： INCLUDE_DIRECTORIES(${opencv_dir}/sdk/native/jni/include) SET(OpenCV_LIB ${opencv_dir}/sdk/native/libs/arm64-v8a/libopencv_java3.so) 打印出自定义变量： 语法：MESSAGE("include folder: "${inc
CMake(四)：变量
jjjstephen的博客
01-10 3413
cmake系统学习
CMake总结(未必正确，请勿参考)
liangshui999的博客
05-29 845
常用的常量 工程源文件目录 PROJECT_SOURCE_DIR CMAKE_SOURCE_DIR 工程编译目录 PROJECT_BINARY_DIR CMAKE_BINARY_DIR 当前处理的 CMakeLists.txt 所在的路径 CMAKE_CURRENT_SOURCE_DIR 和CMAKE_CURRENT_SOURCE_DIR对应的 CMAKE_CURRRENT_BINARY_DIR 当前正在处理的CMakeLists的全路径。Full path to the list
CMAKE小知识
$好记性还是要多记录$
06-22 2316
cmake and CMakeLists.txt
CMake - 两种变量原理
搬砖
10-29 1005
本文转载自：https://www.cnblogs.com/ncuneugcj/p/9756324.html 目录[TOC]1、两种变量的定义参考2、两种变量的作用域原理及使用1、Normal Variables（1）、包含 add_subdirectory()、function()。（本质是值拷贝）（2）、**包含 include()、macro() **（本质有点类似 c 中的 #include 预处理含义）2、Cache Variables参考: 摘要: 本文记录一下 CMake 变量的定义、原理
cmake 常用变量和常用环境变量
weixin_30246221的博客
09-05 794
cmake 常用变量和常用环境变量 一.cmake 变量引用的方式 　　前面我们已经提到了,使用${ }进行变量的引用。在 IF 等语句中,是直接使用变量名而不通过${ }取值. 二.cmake 自定义变量的方式 　　主要有隐式定义和显式定义两种,前面举了一个隐式定义的例子,就是 PROJECT 指令,他会隐式的定义“<projectname>_BINARY_DIR ”和...
cmake的使用--变量使用超详细详解
热门推荐
AndrewYZWang的博客
08-26 1万+
Variables 为有用的参数命名 Variable Basics 像其他编程语言一样，变量是CMake工作的基石。使用set()命令进行变量的命名，变量对大小写敏感。 set(varName value... [PARENT_SCOPE]) In CMake, a variable has a particular scope, much like how variables in other languages have scope limited to a particular function,
CMake Tutorial1_2 将CMake变量传递给代码源文件
程序员Link
05-28 1616
一 内容 在 CMake Tutorial1_1 最简单的例子 基础上修改。 主要说明 如何将CMake的变量值传递给代码源文件。 关于 project命令，其语法如下： project(<PROJECT-NAME> [<language-name>...]) project(<PROJECT-NAME> [VERSION <major>[.<minor>[.<patch>[.<tweak>]]]
cMake
书香水墨
12-11 1048
一、cMake常用指令 指令 描述 cmake_minimum_required(version) 设置cmake的最低版本 project(name) 设置项目名称 set(key, value) 设置变量 option(<option_variable> " " [NO|OFF]) 为用户提供选项为ON或OFF 的选项。如果未提供初始值，则使用OFF。...
cmake 打赢内置变量
最新发布
10-25
3. CMAKE_INCLUDE_PATH：环境变量，非cmake变量，使用set命令进行设置。 4. CMAKE_LIBRARY_PATH：环境变量，非cmake变量，使用set命令进行设置。 5. CMAKE_CURRENT_SOURCE_DIR：当前处理的CMakeLists.txt所在的路径...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

刘大望

谢谢你请的咖啡

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值