(target_)link_libraries 和 (target_)include_directories 之间的区别

Dor*_*ian 3 c++ cmake

我正在为一个使用 CMake 的大型 C++ 项目而苦苦挣扎。现在我正在尝试添加一个依赖项(一个预编译和安装的库),但我不确定添加的位置、包含的内容以及链接它的位置。

特别是,我想知道以下命令之间的区别:

  • include_directories
  • target_include_directories
  • link_libraries
  • target_link_libraries

另外,当我需要使用以下命令时:

  • find_package
  • add_library

我知道它与仅标头库等有关,但我找不到易于理解和简洁的解释。

另外,我应该如何处理以下情况:

包含的库需要例如 Boost,但核心项目不需要。如何避免使整个CMakeLists.txt文件和二进制文件膨胀,并且仍然使用预编译库?(我认为这也是这个问题的一部分)

eer*_*ika 16

*include_directories用于向编译器提供包含目录的列表。当使用预处理器包含文件时,将在这些目录中搜索该文件。

*link_libraries用于向链接器提供库(对象档案)列表。如果链接的项是 cmake 目标,并且具有指定的包含目录,则无需使用*include_directories.

这些target_*版本仅适用于作为操作数给出的目标。非目标版本适用于目录中的所有目标。target_*应该尽可能使用这些版本(即几乎总是)。

find_package用于从外部资源(即项目外部)搜索 cmake 设置。如果要链接库而不在项目的子目录中包含库的源,则使用find_package. 从低层的角度来看,find_package(Foo)寻找一个cmake模块FindFoo.cmake并执行该模块。该模块的目的是生成可用于包含相应依赖项的 cmake 变量或目标。

add_library与 类似add_executable,不同之处在于它为库添加了目标,而不是可执行文件。库目标可以用作 中的项link_libraries,并且它们的依赖项默认是可传递的。

我知道它与仅标头库等有关,

所有这些都与一般的图书馆有关。除了*include_directories还用于指定项目自身头文件的包含目录,而不仅仅是库的头文件。


包含的库需要例如 Boost,但核心项目不需要。如何避免使整个 CMakeLists.txt 文件和二进制文件膨胀,并且仍然使用预编译库?

如果find_package 模块为库创建了一个 cmake 目标( using add_library(... IMPORTED)),它本身指定了依赖项的依赖项,那么只需使用 using 与其链接link_libraries,cmake 负责与依赖项的链接。目标的包含目录也是如此。

旧的 cmake 模块不一定提供目标,在这种情况下,您可能需要编写自己的模块以避免使项目配置膨胀。