[cmake] ---- set_property

简介: [cmake] ---- set_property

1 研究set_property的背景

在开发过程碰到需要在上级目录中构建,而源代码又分别写在下级目录的情况,同时又要根据不同的情况选择性地添加不同的源代码进行编译,所以考虑将需要编译的源代码放到一个 cmake 列表中。但是set()对应生成的变量都是局部变量(即不同的目录下不共用),于是使用set_property()命令。

2 需要使用set_property设置全局属性的简单demo

我这里假设在 main() 函数下调用一个 show_system() 函数用于显示当前系统的名称。程序整体结构如下:

$ tree
├── CMakeLists.txt              
├── linux
│   ├── CMakeLists.txt
│   ├── property.c
│   └── property.h
├── main.c
└── win
    ├── CMakeLists.txt
    ├── property.c
    └── property.h

main.c源码,main.c 程序很简单,就调用子目录下定义的函数。

#include <stdio.h>
 
#include <property.h>
 
int main()
{
    show_system();
 
    return 0;
}

property.c 源码,property.c在 linux 和 win 的实现都一样。

#include <stdio.h>
 
#include "property.h"
 
void show_system()
{
    printf("This is linux\n");    // in linux
    printf("This is windows\n");  // in win
}

根目录下的 CMakeLists.txt

cmake_minimum_required (VERSION 3.13.0)
 
project (property_test VERSION 0.0.4)
 
# 设置全局属性 SOURCE_LIST
set_property( GLOBAL APPEND PROPERTY SOURCE_LIST)
 
# 如果是 Linux 系统,选择编译 linux 目录
IF (CMAKE_SYSTEM_NAME MATCHES "Linux")
    include_directories (linux)
    add_subdirectory (linux)
 
# Window 系统下选择编译 win 目录
ELSEIF (CMAKE_SYSTEM_NAME MATCHES "Windows")
    include_directories (win)
    add_subdirectory (win)
ENDIF (CMAKE_SYSTEM_NAME MATCHES "Linux")
 
# 将 SOURCE_LIST 的内容保存到 SRC_LIST 中
get_property(SRC_LIST GLOBAL PROPERTY SOURCE_LIST )
 
message("src list:" ${SRC_LIST})
 
# build exec
SET(exename "property")
add_executable (${exename} ${SRC_LIST} main.c)

子目录下的CMakeLists.txt

file(GLOB_RECURSE SRC_LIST "*.cpp" "*.c")    # 查找当前目录下所有 .cpp 和 .c 文件
set_property( GLOBAL APPEND PROPERTY SOURCE_LIST ${SRC_LIST})   # 将这些文件路径附加到 SOURCE_LIST 后面

因为 aux_source_directory 命令生成的是源文件的相对路径,传递到上一层之后无法正常使用,所以这里选择 file() 命令来查找源文件,它会生成文件的绝对路径。注意 file() 是递归查找的,也就是说子目录下的源代码也会被找到。

这里 SRC_LIST 是局部变量,只在本目录生效,所以每个 CMakeLists.txt 都可以正常使用,而 SOURCE_LIST 则是全局变量。

3 set_property语法

set_property() 命令,用于在给定范围内设置一个对象的属性。

命令格式:

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> ...])
 
 # 其基本格式为:
 set_property(<Scope> [APPEND] [APPEND_STRING] PROPERTY <name> [value...])

第一个参数必须是属性的范围(Scope),后面 [APPEND | APPEND_STRING] 可选,表示属性是可扩展的列表。PROPERTY 是标识,后面接属性名称,其值可选。Scope 有多种选择可以是:

Scope Description 相似命令
GLOBAL 属性在全局范围内有效,属性名称需唯一
DIRECTORY 在指定目录内有效,可以是相对路径也可以是绝对路径 set_directory_properties
TARGET 设置指定 TARGET 的属性 set_target_properties
SOURCE 属性对应零个或多个源文件。默认情况下,源文件属性仅对添加在同一目录 (CMakeLists.txt) 中的目标可见。 set_source_files_properties
INSTALL 属性对应零个或多个已安装的文件路径。这些可供 CPack 使用以影响部署。
TEST 属性对应零个或多个现有测试。 set_tests_properties
CACHE 属性对应零个或多个缓存现有条目。

在3.18 版本之后,SOURCE 可以通过设置选项 DIRECTORY/TARGET_DIRECTORY 来时属性在其他目录中可见。

  • DIRECTORY :源文件属性将在每个 目录的范围内有效,CMake 必须已经知道这些目录中的每一个,或者通过调用 add_subdirectory() 添加它们,或者它是顶级源目录。相对路径被视为相对于当前源目录。3.19 版本之后可以引用二进制目录。
  • TARGET_DIRECTORY :源文件属性将在创建任何指定 的每个目录范围中有效, 必须已经存在。
    PROPERTY 是必需的参数,后面接属性的名称,其余的参数对应的是属性的值,以分号分隔。

APPEND 和 APPEND_STRING 是可选参数,如果设置了,那么后面的 … 将以列表的形式附加到指定属性的后面。APPEND_STRING 表示后面的 将以字符串的形式添加到属性的后面。

目录
相关文章
|
5月前
|
存储 Cloud Native Linux
CMake学习之set
CMake学习之set
关于 CMake编译出出现错误“Could not find compiler set in environment variable RC:” 的解决方法
关于 CMake编译出出现错误“Could not find compiler set in environment variable RC:” 的解决方法
关于 CMake编译出出现错误“Could not find compiler set in environment variable RC:” 的解决方法
问题集锦:使用CMake部署Qt应用程序:set_target_properties、get_target_property
问题集锦:使用CMake部署Qt应用程序:set_target_properties、get_target_property
223 0
|
Android开发 C语言
CMake Error: CMAKE_C_COMPILER not set, after EnableLanguage
最近要编译FFMPEG,但是一真报这个错,我用的是deepin系统。android studio 3.1.2。cmake,gcc,g++都已经安装了,但是编译就过不去,总是报这个错 CMake Error: CMAKE_C_COMPILER not set, after EnableLanguage 很是恼火啊。
10457 0
|
25天前
|
存储 自然语言处理 C++
map和set的简单介绍
map和set的简单介绍
20 1
|
1月前
|
存储 安全 Java
java集合框架及其特点(List、Set、Queue、Map)
java集合框架及其特点(List、Set、Queue、Map)
|
3月前
|
JavaScript 前端开发 定位技术
JavaScript 中如何代理 Set(集合) 和 Map(映射)
JavaScript 中如何代理 Set(集合) 和 Map(映射)
50 0
|
3月前
|
存储 安全 Java
Map和Set(JAVA)
Map和Set(JAVA)
50 1
|
3月前
|
编译器 C++ 容器
【C++学习手札】基于红黑树封装模拟实现map和set
【C++学习手札】基于红黑树封装模拟实现map和set
|
16天前
|
存储 JavaScript 前端开发
set和map的区别
set和map的区别
17 4