如何使用CMake正确添加包含目录

大约一年前，我询问了CMake中的标头依赖性。

最近我意识到问题似乎是CMake认为这些头文件在项目外部。至少在生成Code :: Blocks项目时，头文件不会出现在项目中（源文件会出现）。因此，在我看来，CMake认为这些标头在项目外部，而不在依赖中跟踪它们。

在CMake教程中快速搜索仅指出了include_directories哪些似乎并没有达到我的期望...

向CMake发出信号的正确方法是什么，即特定目录包含要包含的标头，并且应由生成的Makefile跟踪这些标头？

必须做两件事。

首先添加要包含的目录：

target_include_directories(test PRIVATE ${YOUR_DIRECTORY})

如果您使用的是非常老的CMake版本（2.8.10或更早版本）而不支持target_include_directories，则也可以改用旧版include_directories：

include_directories(${YOUR_DIRECTORY})

然后，还必须将头文件添加到当前目标的源文件列表中，例如：

set(SOURCES file.cpp file2.cpp ${YOUR_DIRECTORY}/file1.h ${YOUR_DIRECTORY}/file2.h)
add_executable(test ${SOURCES})

这样，头文件将显示为Makefile中的依赖项，如果生成的话，还将显示在生成的Visual Studio项目中。

如何将这些头文件用于多个目标：

set(HEADER_FILES ${YOUR_DIRECTORY}/file1.h ${YOUR_DIRECTORY}/file2.h)

add_library(mylib libsrc.cpp ${HEADER_FILES})
target_include_directories(mylib PRIVATE ${YOUR_DIRECTORY})
add_executable(myexec execfile.cpp ${HEADER_FILES})
target_include_directories(myexec PRIVATE ${YOUR_DIRECTORY})

首先，您用于include_directories()告诉CMake将目录添加-I到编译命令行中。其次，您在add_executable()或中列出标题add_library()呼叫中。

例如，如果您项目的源位于中src，并且您需要中的标头include，则可以这样操作：

include_directories(include)

add_executable(MyExec
  src/main.c
  src/other_source.c
  include/header1.h
  include/header2.h
)

如果将CMake与其他创建Makefile的方法（例如make或qmake）进行比较，则它更像是一种脚本语言。它不像Python那样酷，但仍然如此。

如果在各种开源项目中查看人们如何包含目录，就没有像“ 正确的方式 ” 这样的东西。但是有两种方法可以做到这一点。

1. 原始的include_directories将目录添加到当前项目以及所有其他后代项目，您将通过一系列add_subdirectory命令将其添加。有时人们会说这种方法是遗留的。

2. 一个更优雅的方法是使用target_include_directories。它允许为特定项目/目标添加目录，而不会（可能）不必要地继承或冲突各种包含目录。还允许执行微妙的配置并为此命令附加以下标记之一。

PRIVATE-仅用于此指定的构建目标

PUBLIC-将其用于指定目标以及与此项目链接的目标

接口 -仅将其用于与当前项目链接的目标

PS：

1. 这两个命令都允许将目录标记为SYSTEM，以提示您指定目录包含警告不是您的公司。

2. 类似的答案是其他命令对target_compile_definitions / add_definitions， target_compile_options / CMAKE_C_FLAGS

加 include_directories("/your/path/here")。

这类似于gcc通过-I/your/path/here/ option。

确保在路径两边加上双引号。其他人没有提及，这让我呆了2天。因此，此答案适用于对CMake还是很陌生的人。

我有同样的问题。

我的项目目录如下：

    --project
    ---Classes
    ----Application
    -----.h and .c files
    ----OtherFolders
    --main.cpp

以及我以前在所有这些文件夹中包括的文件：

    file(GLOB source_files
            "*.h"
            "*.cpp"
            "Classes/*/*.cpp"
            "Classes/*/*.h"
    )

    add_executable(Server ${source_files})

它完全有效。