[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 表示后面的将以字符串的形式添加到属性的后面。