CMake 中的 PUBLIC，PRIVATE，INTERFACE

一、概述

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 的命令来减少不必要或多余的目录包含和链接。

转载：CMake 中的 PUBLIC，PRIVATE，INTERFACE - 简书

（SAW：Game Over！）