Cmake之 target_include_directories

发布时间 2023-06-13 19:41:22作者: merlindu
target_include_directories 是 CMake 中用于指定目标(target)的头文件搜索路径的命令。
它的语法如下:
target_include_directories(target
    [SYSTEM] [BEFORE]
    <INTERFACE|PUBLIC|PRIVATE> [items1...]
    [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

 

 

其中,`target` 是目标名称,可以是库或可执行文件的名称。
`SYSTEM` 表示这些头文件是系统头文件,`BEFORE` 表示这些路径将被添加到其他路径之前。`INTERFACE`、`PUBLIC` 和 `PRIVATE` 是指定这些路径的可见性。它们的含义如下:
- `INTERFACE`:这些路径只会被添加到目标的接口中,不会被添加到目标自身的编译选项中。
- `PUBLIC`:这些路径会被添加到目标自身的编译选项中,同时也会被添加到目标的接口中。
- `PRIVATE`:这些路径只会被添加到目标自身的编译选项中,不会被添加到目标的接口中。
`items` 是头文件搜索路径,可以是绝对路径或相对路径。如果是相对路径,会相对于当前 CMakeLists.txt 文件所在的目录进行解析。
 
 
用法:
function(my_include_public)
  target_include_directories(${CURRENT_LIBRARY} PUBLIC ${ARGN})
endfunction()

function(my_include_private)
  target_include_directories(${CURRENT_LIBRARY} PRIVATE ${ARGN})
endfunction()

function(my_include_interface)
  target_include_directories(${CURRENT_LIBRARY} INTERFACE ${ARGN})
endfunction()