CMake 属性之目录属性

已于 2024-10-09 23:24:37 修改
阅读量400 收藏 6
点赞数 16
分类专栏： CMake 开发之旅 文章标签： cmake c++
于 2024-10-09 23:23:56 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u011283226/article/details/142798512
版权

 【写在前面】

        CMake 的目录属性是指在特定目录（及其子目录）范围内有效的设置。

        这些属性不同于全局变量或目标（Target）属性，它们提供了一种机制，允许开发者为项目中的不同部分定义不同的构建行为。

        通过目录属性，你可以指定编译器选项、包含路径、预处理定义等，而无需在每个目标或文件中重复这些设置。

【正文开始】

        CMake 目录范围的属性有( CMake 3.30 )：

        定义目录属性：
define_property( <DIRECTORY>
                 PROPERTY <name> [INHERITED]
                 [BRIEF_DOCS <brief-doc> [docs...]]
                 [FULL_DOCS <full-doc> [docs...]]
                 [INITIALIZE_FROM_VARIABLE <variable>])

在范围内定义一个属性，用于 set_property() 和 get_property() 命令。它主要用于定义属性的初始化或继承方式。从历史上看，该命令还将文档与属性相关联，但这不再被视为主要用例。

        示例： 

# 定义一个名为 CURRENT_DIRECTORY 的目录属性
define_property(DIRECTORY 
    # 目录属性的名称
    PROPERTY CURRENT_DIRECTORY
    # 简短的文档说明
    BRIEF_DOCS "The current directory"
    # 详细的文档说明
    FULL_DOCS "The current directory"
)
         设置目录属性：    
set_property(<[DIRECTORY <dirs> ...] [TARGET_DIRECTORY <targets> ...]>
             [APPEND] [APPEND_STRING]
             PROPERTY <name> [<value1> ...])

在范围的零个或多个对象上设置一个属性。

DIRECTORY 范围默认为当前目录，但其他目录（已由 CMake 处理）可以按完整路径或相对路径命名。相对路径被视为相对于当前源目录。另请参阅 set_directory_properties() 命令。

在 3.19 版本加入: <dir> 可以引用一个二进制目录。

如果给出 APPEND 选项，列表将附加到任何现有的属性值（除了忽略和不附加空值）。如果给出 APPEND_STRING 选项，字符串将作为字符串附加到任何现有属性值，即它会产生更长的字符串而不是字符串列表。当使用 APPEND 或 APPEND_STRING 以及定义为支持 INHERITED 行为的属性时（请参阅 :command:define_property），在找到要附加到的初始值时不会发生继承。如果该属性尚未在指定范围内直接设置，则该命令的行为就好像没有给出 APPEND 或 APPEND_STRING 一样。

        示例：

# 设置当前目录属性为当前源代码目录
set_property(DIRECTORY PROPERTY CURRENT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR})

        其中，有一个专用于设置目录属性的命令：

set_directory_properties(PROPERTIES prop1 value1 [prop2 value2] ...)

在键值对中设置当前目录及其子目录的属性。

另请参阅 set_property(DIRECTORY) 命令。

         获取目录属性：
get_property(<[DIRECTORY <dir> | TARGET_DIRECTORY <target>]>
             PROPERTY <name>
             [SET | DEFINED | BRIEF_DOCS | FULL_DOCS])

从范围内的一个对象获取一个属性。

DIRECTORY 作用域默认为当前目录，但另一个目录（已由 CMake 处理）可能由完整或相对路径命名为“<dir>”。相对路径被视为相对于当前源目录。另请参阅 get_directory_property() 命令。

在 3.19 版本加入: <dir> 可以引用一个二进制目录。

如果给出了 SET 选项，变量将被设置为一个布尔值，指示该属性是否已被设置。如果给出了 DEFINED 选项，变量将被设置为一个布尔值，指示该属性是否已被定义，例如使用 define_property 命令。 如果给出了``BRIEF_DOCS`` 或``FULL_DOCS``，那么该变量将被设置为一个字符串，其中包含所请求属性的文档。如果为尚未定义的属性请求文档，则返回“NOTFOUND”。

        示例：

# 获取当前目录属性
get_property(CURRENT_DIR DIRECTORY PROPERTY CURRENT_DIRECTORY)

        其中，有一个专用于获取目录属性的命令：

get_directory_property(<variable> [DIRECTORY <dir>] <prop-name>)

将目录范围的属性存储在命名的``<variable>``中。

DIRECTORY 参数指定从中检索属性值的另一个目录，而不是当前目录。相对路径被视为相对于当前源目录。 CMake 必须已经知道该目录，或者通过调用 add_subdirectory 添加它或者是顶级目录。

在 3.19 版本加入: <dir> 可以引用一个二进制目录。

如果没有为指定的目录范围定义该属性，则返回一个空字符串。对于 INHERITED 属性，如果在指定的目录范围内找不到该属性，则搜索将链接到父范围，如 define_property() 命令所述。

get_directory_property(<variable> [DIRECTORY <dir>]
                       DEFINITION <var-name>)

从目录中获取变量定义。这种形式对于从另一个目录获取变量定义很有用。

         示例：

# 添加预处理定义，定义宏TEST_DEFINED的值为1
add_compile_definitions(TEST_DEFINED=1)

# 获取当前目录的属性COMPILE_DEFINITIONS，即定义的宏
get_directory_property(DEFS COMPILE_DEFINITIONS) 

# 打印获取到的定义信息
message("DEFS: ${DEFS}")

        最后完整测试一遍： 

# 要求 CMake 最低版本为 3.16
cmake_minimum_required(VERSION 3.16)

# 定义一个名为 CURRENT_DIRECTORY 的目录属性
define_property(DIRECTORY 
    # 目录属性的名称
    PROPERTY CURRENT_DIRECTORY
    # 简短的文档说明
    BRIEF_DOCS "The current directory"
    # 详细的文档说明
    FULL_DOCS "The current directory"
)

# 设置当前目录属性为当前源代码目录
set_property(DIRECTORY PROPERTY CURRENT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR})

# 获取当前目录属性
get_property(CURRENT_DIR DIRECTORY PROPERTY CURRENT_DIRECTORY)

# 打印当前目录信息
message("CURRENT_DIR: ${CURRENT_DIR}")

# 添加预处理定义，定义宏TEST_DEFINED的值为1
add_compile_definitions(TEST_DEFINED=1)

# 获取当前目录的属性COMPILE_DEFINITIONS，即定义的宏
get_directory_property(DEFS COMPILE_DEFINITIONS) 

# 打印获取到的定义信息
message("DEFS: ${DEFS}")

# 将库目录链接到当前目录下的lib目录
link_directories(${CMAKE_CURRENT_SOURCE_DIR}/lib)

# 获取链接目录属性
get_property(LINK_DIR DIRECTORY PROPERTY LINK_DIRECTORIES)

# 获取源目录属性
get_property(S_DIR DIRECTORY PROPERTY SOURCE_DIR)

# 打印链接目录和源目录信息
message("LINK_DIR: ${LINK_DIR} S_DIR: ${S_DIR}")

# 设置当前目录及其子目录的编译器标志  
set_directory_properties(PROPERTIES COMPILE_FLAGS "-Wall -Wextra")

# 获取当前目录的编译标志
get_directory_property(COMPILE_FLAGS COMPILE_FLAGS)

# 打印获取到的编译标志信息
message("COMPILE_FLAGS: ${COMPILE_FLAGS}")

         CMake 输出如下：

【结语】

        项目链接(多多star呀..⭐_⭐)：

        Github 地址：https://github.com/mengps/LearnCMake

梦起丶
关注
专栏目录
CMake 属性之目标属性
梦起丶的博客
10-08 546
CMake 可以通过属性来存储信息。它就像是一个变量，但它被附加到一些其他的实体上，像是一个目录或者是一个目标。一个全局的属性可以是一个有用的非缓存的全局变量。在 CMake 的众多属性中，目标属性 () 扮演着尤为重要的角色，它们直接关联到最终生成的可执行文件、库文件等构建产物。更直观一点，如果把目标类比为，那么目标属性则类似。
CMake 属性之全局属性
最新发布
梦起丶的博客
10-09 460
【写在前面】CMake 的全局属性是指在 CMake 配置过程中，对整个项目范围生效的设置。这些属性不同于目标 ( Target ) 属性或目录 ( Directory ) 属性，后者仅对特定的目标或目录生效。
CMake（八）：属性
jjjstephen的博客
01-15 1463
cmake系统学习
cmake进阶：目录属性之 INCLUDE_DIRECTORIES说明二
wojiaxiaohuang2014的博客
05-08 482
父目录的 INCLUDE_DIRECTORIES 填充 子目录的 INCLUDE_DIRECTORIES 属性
cmake进阶：目录属性说明一
wojiaxiaohuang2014的博客
05-07 374
cmake进阶：目录属性
cmake进阶：目标属性
wojiaxiaohuang2014的博客
05-08 315
cmake进阶：目标属性
CMake 目标属性 DEFINE_SYMBOL
程序员Link
06-09 1311
目录一 set_target_properties二 DEFINE_SYMBOL三 举例四 参考 一 set_target_properties > Targets can have properties that affect how they are built. 目标可能具有影响其构建方式的属性。 语法 set_target_properties(target1 target2 ... PROPERTIES prop1 value1
cmake属性 INSTALL_RPATH
flying_ant2018的博客
09-02 5886
cmake属性INSTALL_RPATH
cmake设置属性
weixin_39875125的博客
03-10 218
cmake使用知识
cmake进阶：目录属性之 INCLUDE_DIRECTORIES说明一
wojiaxiaohuang2014的博客
05-07 995
cmake进阶：目录属性之 INCLUDE_DIRECTORIES
CMake添加引用多个子目录多个CMakeLists同时编译
09-10
首先，一个CMake项目通常由一个顶级的`CMakeLists.txt`文件开始，它负责定义项目的全局属性和包含其他子目录。在顶级`CMakeLists.txt`中，你需要使用`add_subdirectory()`命令来添加子目录。这个命令告诉CMake去查找...
cmake 构建多文件多目录项目教程
04-26
cmake 构建多文件多目录项目教程 cmake 是一个功能强大且灵活的构建工具，广泛应用于 C++ 项目的构建和管理。下面是 cmake 构建多文件多目录项目的相关知识点： 一、cmake 的常用环境变量 cmake 提供了许多环境...
Professional CMake pdf
02-01
1. **CMakeLists.txt 文件**：这是CMake项目中最核心的文件之一，用于描述项目的构建规则。 - **基本语法**：使用命令关键字来组织构建逻辑，如`add_executable()`、`add_library()`等。 - **变量与缓存**：CMake...
VSCode构建cmake工程
01-20
在工程根目录下的`.vscode`文件夹内创建三个JSON配置文件：`c_cpp_properties.json`、`launch.json`和`tasks.json`。 `c_cpp_properties.json`文件用于设置C/C++的编译器路径、标准以及包含路径等。以下是一个基本...
【C语言系统编程】【第三部分：网络编程】3.2 数据传输和协议
10-03 1502
在进行网络编程时，有时需要设计并实现自定义协议，以满足特定应用的需求。自定义协议设计需要考虑到数据的传输、安全、效率等多方面因素。清晰性：协议应具有清晰的语法和语义，使开发者能快速理解和实现。扩展性：协议应允许未来的功能扩展，而不破坏现有功能。安全性：数据传输过程中应考虑加密和校验，以保证数据不被篡改。高效性：应尽可能减少网络带宽占用，提升数据传输效率。容错性：协议应能处理各种网络异常情况，如数据丢失、重复和延迟。
使用socket编程来实现一个简单的C/S模型（TCP协议）
caiji0169的博客
10-02 1715
下图是基于TCP协议的客户端/服务器程序的一般流程：服务器调用socket()、bind()、listen()完成初始化后，调用accept()阻塞等待，处于监听端口的状态，客户端调用socket()初始化后，调用connect()发出SYN段并阻塞等待服务器应答，服务器应答一个SYN-ACK段，客户端收到后从connect()返回，同时应答一个ACK段，服务器收到后从accept()返回。数据传输的过程：建立连接后，TCP协议提供全双工的通信服务，但是一般的客户端/服务器程序的流程是由客户端主动发起请求，
将脚本编译为pyd文件
cdinten的专栏
10-01 448
Python虽然作为一种解释性语言，通常是使用解释器处理脚本的方式完成工作，但是也具有和很多其他诸如C、C#语言等类似的方式，可以将.py文件编译为*.pyd文件，即Python动态链接库文件。关于动态链接库的优缺点这里就不展开细说了，具体介绍如何编译及使用。要将Python文件编译成.pyd文件，可以使用Cython，以下是基本的操作步骤。
windows C++-创建数据流代理(三)
苏洛的博客
10-08 284
控制流指的是程序中操作的执行顺序。 控制流是通过使用条件语句、循环等控制结构调节的。 此外，数据流指的是一种编程模型，在这种模型中，只有当所有需要的数据都可用时，才会进行计算。 数据流编程模型与消息传递这一概念相关，其中程序的独立组件通过发送消息相互通信。 异步代理同时支持控制流和数据流编程模型。 尽管控制流模型适用于许多情况，但数据流模型也适用于其他一些情况，例如，当代理接收数据并执行基于该数据的有效负载的操作时。
第 21 章 一条记录的多幅面孔——事务的隔离级别与 MVCC
weixin_45740473的博客
10-02 1033
并发的事务在运行过程中会出现一些可能的引发一致性问题SQL 标准中有4种隔离级别版本链ReadView。
cmake设置hlsl文件编译输出目录属性
06-09
在CMake中，可以使用`set_source_files_properties`函数来设置特定源文件的属性，包括编译输出目录属性。对于HLSL文件，可以使用以下方法设置编译输出目录属性： ```cmake set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_OUTPUT_HEADER_FILE_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}") set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_OUTPUT_OBJECT_FILE_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}") ``` 在这个示例中，我们使用`set_source_files_properties`函数来设置`myshader.hlsl`文件的编译输出目录属性，将输出目录设置为`${CMAKE_CURRENT_BINARY_DIR}`，即CMake的构建目录。`VS_SHADER_OUTPUT_HEADER_FILE_DIRECTORY`属性用于设置HLSL编译器生成的头文件的输出目录，`VS_SHADER_OUTPUT_OBJECT_FILE_DIRECTORY`属性用于设置编译器生成的二进制文件的输出目录。 需要注意的是，在设置编译输出目录属性之前，需要确保CMake已经找到了正确的HLSL编译器。可以使用`find_program`函数来查找编译器，并将路径保存到变量中，例如： ```cmake find_program(HLSL_COMPILER_PATH fxc.exe PATHS "C:/Program Files (x86)/Windows Kits/10/bin/x64") if(NOT HLSL_COMPILER_PATH) message(FATAL_ERROR "Could not find HLSL compiler (fxc.exe)") endif() set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_TYPE PixelShader) set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_MODEL 4.0) set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_ENTRYPOINT main) set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_OUTPUT_HEADER_FILE_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}") set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_OUTPUT_OBJECT_FILE_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}") set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_VARIABLE_NAME "MyShader") set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_DISABLE_OPTIMIZATIONS ON) set_source_files_properties(myshader.hlsl PROPERTIES VS_SHADER_ENABLE_DEBUG ON) ``` 在这个示例中，我们使用`find_program`函数查找HLSL编译器，并将路径保存到`HLSL_COMPILER_PATH`变量中。然后，我们使用`set_source_files_properties`函数设置`myshader.hlsl`文件的属性，包括编译器参数、编译输出目录属性等。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

打赏作者

梦起丶

您的鼓励和支持是我创作最大动力

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

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

打赏作者

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

抵扣说明：

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

余额充值