get_property --Cmakelist之中

get_property 是 CMake 中用于获取目标、目录、变量或文件等属性的命令。它可以提取某个特定属性的值，以便在构建脚本的其他地方使用。

语法

get_property(<variable> <TYPE> <name> PROPERTY <property-name> [SET | DEFINED | BRIEF_DOCS | FULL_DOCS]) 

• <variable>: 存储提取的属性值的变量名称。
• <TYPE>: 指定要获取属性的对象类型，常用类型有 TARGET、SOURCE、DIRECTORY、GLOBAL、CACHE 等。
• <name>: 对象的名称，比如目标名、源文件名、目录名等。
• PROPERTY: 指定要查询的属性名称。
• [SET | DEFINED | BRIEF_DOCS | FULL_DOCS]: 可选参数，表示是否检查属性是否已设置、已定义，或获取属性的简短或详细文档。

常见类型

1. TARGET: 获取与目标（如可执行文件或库）相关的属性。
2. SOURCE: 获取与源文件相关的属性。
3. DIRECTORY: 获取与目录相关的属性。
4. CACHE: 获取缓存变量的属性。
5. GLOBAL: 获取全局属性。

常见属性

• INCLUDE_DIRECTORIES: 获取目标的头文件搜索路径。
• LINK_LIBRARIES: 获取目标的链接库。
• COMPILE_DEFINITIONS: 获取编译定义。
• COMPILE_OPTIONS: 获取编译选项。
• POSITION_INDEPENDENT_CODE: 获取是否启用了位置无关代码（通常用于库）。

使用示例

获取目标的包含目录

get_property(INCLUDE_DIRS TARGET MyApp PROPERTY INCLUDE_DIRECTORIES) 
message("MyApp's include directories: ${INCLUDE_DIRS}") 

这段代码获取目标 MyApp 的包含目录，并将其存储在 INCLUDE_DIRS 变量中，随后通过 message() 输出该值。

检查属性是否已设置

get_property(IS_SET TARGET MyApp PROPERTY INCLUDE_DIRECTORIES SET) 
if(IS_SET) 
    message("MyApp has include directories set.") 
else() 
    message("MyApp does not have include directories set.") 
endif() 

这里，SET 用来检查属性 INCLUDE_DIRECTORIES 是否已为目标 MyApp 设置。

获取源文件的编译选项

get_property(COMPILE_OPTS SOURCE main.cpp PROPERTY COMPILE_OPTIONS) 
message("main.cpp compile options: ${COMPILE_OPTS}") 

这段代码获取 main.cpp 的编译选项。

获取全局属性

get_property(GLOBAL_PROP GLOBAL PROPERTY USE_FOLDERS) 
message("Global property USE_FOLDERS: ${GLOBAL_PROP}") 

获取全局属性 USE_FOLDERS，它决定是否使用文件夹组织构建目标。

总结

get_property 命令非常灵活，可以帮助你在 CMake 项目中动态获取目标、源文件、目录、全局等对象的属性，使构建过程更加可控和灵活。