CMake：我们可以为不构成可执行文件或 lib 的特定文件集指定包含目录吗？

Question

如果我有这个源代码树：

C:\app:
    src:
        CMakeLists.txt
        main.cpp --> #include "acme/header_only_lib/api.h"

D:\3rdparty\acme\header_only_lib:
    api.h --> #include "detail.h"
    detail.h 

不使用符号链接技巧，也不向 3rdparty 文件夹添加文件，如果我必须在 main.cpp 中保留 #include "acme/header_only_lib/api.h"，我应该如何在 CMake 中指定包含目录，以便 api.h 可以看到 detail.h，没有添加D:\3rdparty\acme\header_only_lib的全局包含目录？ header-only-lib 既不是可执行文件也不是库目标，我无法修改它的代码。我也不想通过添加D:\3rdparty\acme\header_only_lib 来污染我的全局包含目录，因为里面的文件名太常见了，很容易与其他库/未来代码发生冲突。

是否有一个 CMake 机制，我可以说： 仅对于D:\3rdparty\acme\header_only_lib\api.h，添加D:\3rdparty\acme\header_only_lib 作为包含目录？

Answer 1

要将目录添加到包含目录的全局列表中，请使用例如

include_directories( ${CMAKE_SOURCE_DIR}/3rdparty )

请注意，您不应将绝对路径（如D:\）硬编码到您的 CMakeLists.txt 中，因为这会使您无法在任何其他位置构建您的项目。 CMake 提供了像 ${CMAKE_SOURCE_DIR} 和 ${CMAKE_BINARY_DIR} 这样的变量来达到这个目的。

如果您只想将目录添加到构建的特定部分的包含目录列表中，请使用例如

target_include_directories( app PRIVATE ${CMAKE_SOURCE_DIR}/3rdparty )

这将添加目录仅为目标（可执行文件/库）app。

请注意，如果您的 acme/header_only_lib 应该与 app 二进制文件一起安装，则此方法将不起作用，因为您的 acme 标头需要在客户端计算机上“看到”彼此，即如果它们驻留在acme/header_only_lib 子目录中但没有子目录相互寻址，则不太可能。这将需要您的客户（不使用 您的 CMakeLists.txt 进行构建）将 acme/header_only_lib 添加到包含路径中以使您的标头库正常工作——您不应该这样做。

Answer 2

使用include_directories 或target_include_directories：

include_directories("D:\3rdparty")

如果您只想对 main 目标进行此更改，则使用 target_include_directories 或：

add_executable(main main.cpp)
target_include_directories(main PUBLIC "D:\3rdparty")

那你可以#include "acme/header_only_lib/api.h" 或#include <acme/header_only_lib/api.h>

仅标头库

如果您只想为header-only-lib 执行此操作，您需要在其 CMake 文件中执行此操作。首先将库添加为INTERFACE，没有源文件：

add_library(header-only INTERFACE) 

然后包含它的目录：

target_include_directories(header-only INTERFACE include-dir-for-header-only) 

然后将其链接到主要目标

find_library(HeaderOnly
    NAMES header-only
    HINTS "D:\3rdparty\path-to-lib"
)
target_link_libraries(main header-only)