首页 > 极客资料 博客日记

CMake 属性之全局属性

2024-10-09 19:00:03极客资料围观18次

文章CMake 属性之全局属性分享给大家，欢迎收藏极客之家，专注分享技术知识

【写在前面】

CMake 的全局属性是指在 CMake 配置过程中，对整个项目范围生效的设置。

这些属性不同于目标 ( Target ) 属性或目录 ( Directory ) 属性，后者仅对特定的目标或目录生效。

【正文开始】

CMake 全局范围的属性有( CMake 3.30 )：

定义全局属性：

define_property(<GLOBAL | DIRECTORY | TARGET | SOURCE |
                 TEST | VARIABLE | CACHED_VARIABLE>
                 PROPERTY <name> [INHERITED]
                 [BRIEF_DOCS <brief-doc> [docs...]]
                 [FULL_DOCS <full-doc> [docs...]]
                 [INITIALIZE_FROM_VARIABLE <variable>])

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

示例：

# 定义一个名为 GLOBAL_PROPERTY_TEST 的全局属性
define_property(GLOBAL 
    # 全局属性的名称
    PROPERTY GLOBAL_PROPERTY_TEST
    # 简短的文档说明
    BRIEF_DOCS "A global property test"
    # 完整的文档说明
    FULL_DOCS "A global property test"
)

设置全局属性：

set_property(<GLOBAL                      |
              DIRECTORY [<dir>]           |
              TARGET    [<target1> ...]   |
              SOURCE    [<src1> ...]
                        [DIRECTORY <dirs> ...]
                        [TARGET_DIRECTORY <targets> ...] |
              INSTALL   [<file1> ...]     |
              TEST      [<test1> ...]     |
              CACHE     [<entry1> ...]    >
             [APPEND] [APPEND_STRING]
             PROPERTY <name> [<value1> ...])

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

GLOBAL 范围是唯一的，不接受名称。

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

示例：

# 设置全局属性 GLOBAL_PROPERTY_TEST 为 ON
set_property(GLOBAL PROPERTY GLOBAL_PROPERTY_TEST ON)

获取全局属性：

get_property(<variable>
             <GLOBAL             |
              DIRECTORY [<dir>]  |
              TARGET    <target> |
              SOURCE    <source>
                        [DIRECTORY <dir> | TARGET_DIRECTORY <target>] |
              INSTALL   <file>   |
              TEST      <test>   |
              CACHE     <entry>  |
              VARIABLE           >
             PROPERTY <name>
             [SET | DEFINED | BRIEF_DOCS | FULL_DOCS])

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

GLOBAL 范围是唯一的，不接受名称。

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

示例：

# 获取全局属性 GLOBAL_PROPERTY_TEST 的值，并将结果存储在变量 IS_GLOBAL 中
get_property(IS_GLOBAL GLOBAL PROPERTY GLOBAL_PROPERTY_TEST)

其中，有一个专用于获取 CMake 全局属性 命令：

get_cmake_property(<var> <property>)

从 CMake 实例获取全局属性。 <property> 的值存储在变量<var> 中。如果未找到该属性，<var> 将被设置为 NOTFOUND。有关可用属性，请参阅 cmake-properties(7) 手册。

除了全局属性，此命令（出于历史原因）还支持 VARIABLES 和 MACROS 目录属性。它还支持一个特殊的 COMPONENTS 全局属性，该属性列出了提供给 install() 命令的组件。

示例：

# 获取当前 CMake 角色，并将结果存储在变量 ROLE 中
get_cmake_property(ROLE CMAKE_ROLE)

最后完整测试一遍：

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

# 定义一个名为 GLOBAL_PROPERTY_TEST 的全局属性
define_property(GLOBAL 
    # 全局属性的名称
    PROPERTY GLOBAL_PROPERTY_TEST
    # 简短的文档说明
    BRIEF_DOCS "A global property test"
    # 完整的文档说明
    FULL_DOCS "A global property test"
)

# 设置全局属性 GLOBAL_PROPERTY_TEST 为 ON
set_property(GLOBAL PROPERTY GLOBAL_PROPERTY_TEST ON)

# 获取全局属性 GLOBAL_PROPERTY_TEST 的值，并将结果存储在变量 IS_GLOBAL 中
get_property(IS_GLOBAL GLOBAL PROPERTY GLOBAL_PROPERTY_TEST)

# 打印变量 IS_GLOBAL 的值，用于确认全局属性是否已设置
message("IS_GLOBAL: ${IS_GLOBAL}")

# 获取当前 CMake 角色，并将结果存储在变量 ROLE 中
get_cmake_property(ROLE CMAKE_ROLE)

# 打印变量 ROLE 的值，用于显示当前 CMake 角色
message("ROLE: ${ROLE}")

CMake 输出如下：

image

【结语】

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

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


版权声明：本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：jacktools123@163.com进行投诉反馈，一经查实，立即删除！

标签：

上一篇：python——celery异常consumer: Cannot connect to redis://127.0.0.1:6379/1: MISCONF Redis is configured to save RDB snapshots, but it is currently not able to persist on disk.
下一篇：大模型应用开发初探 : 基于Coze创建Agent

相关文章

最新发布

点击排行

本站推荐

标签云