一、概述
CMake中经常会使用 target_**()
相关命令,target_**()
命令支持通过 PUBLIC
,PRIVATE
和 INTERFACE
关键字来控制传播。本文主要介绍下这三个关键字的区别。
二、解释
以 target_link_libraries(A B)
命令为例,从理解的角度解释:
PRIVATE
依赖项 B 仅链接到目标 A,若有 C 链接了目标 A,C 不链接依赖项 B 。INTERFACE
依赖项 B 并不链接到目标 A,若有 C 链接了目标 A,C 会链接依赖项 B 。PUBLIC
依赖项 B 链接到目标 A,若有 C 链接了目标 A,C 也会链接依赖项 B 。
从使用的角度解释,若有 C 链接了目标 A :
- 如果依赖项 B 仅用于目标 A 的实现,且不在头文件中提供给 C 使用,使用
PRIVATE 。
- 如果依赖项 B 不用于目标 A 的实现,仅在头文件中作为接口提供给 C 使用,使用
INTERFACE 。
- 如果依赖项 B 不仅用于目标 A 的实现,而且在头文件提供给 C 使用,使用
PUBLIC 。
例 子
举一个简单的例子说明一下
add_library(C c.cpp)
add_library(D d.cpp)
add_library(B b.cpp)
target_link_libraries(B PUBLIC C)
target_link_libraries(B PRIVATE D)
add_executable(A a.cpp)
target_link_libraries(A B)
因为 C 是 B 的 PUBLIC 依赖项,所以其会被传播到 A 。
因为 D 是 B 的 PRIVATE 依赖项,所以其不会传播到 A 。
三、补充
这里补充下使用 target_**()
相关命令,有无 target
的区别。
以 target_include_directories()
命令为例,include_directories(dir)
是一个全局设置,其会将 dir
添加到当前 CMakeLists 文件中每个目标的 INCLUDE_DIRECTORIES
属性中。即当前 CMakeLists 文件其下所有的子目录都会添加 dir 目录。
因此,建议使用有 target
的命令来减少不必要或多余的目录包含和链接。
(SAW:Game Over!)