Como adicionar corretamente diretórios de inclusão com o CMake

Há cerca de um ano, perguntei sobre dependências de cabeçalho no CMake .

Percebi recentemente que o problema parecia ser que o CMake considerava esses arquivos de cabeçalho externos ao projeto. Pelo menos, ao gerar um projeto Code :: Blocks, os arquivos de cabeçalho não aparecem no projeto (os arquivos de origem). Portanto, parece-me que o CMake considera esses cabeçalhos externos ao projeto e não os rastreia nas dependências.

Uma pesquisa rápida no tutorial do CMake apenas apontou para o include_directoriesque parece não fazer o que eu desejo ...

Qual é a maneira correta de sinalizar ao CMake que um diretório específico contém cabeçalhos a serem incluídos e que esses cabeçalhos devem ser rastreados pelo Makefile gerado?

Duas coisas devem ser feitas.

Primeiro adicione o diretório a ser incluído:

target_include_directories(test PRIVATE ${YOUR_DIRECTORY})

Caso você esteja com uma versão CMake muito antiga (2.8.10 ou anterior) sem suporte target_include_directories, também poderá usar o legado include_directories:

include_directories(${YOUR_DIRECTORY})

Em seguida, você também deve adicionar os arquivos de cabeçalho à lista dos arquivos de origem do destino atual, por exemplo:

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

Dessa forma, os arquivos de cabeçalho aparecerão como dependências no Makefile e também, por exemplo, no projeto do Visual Studio gerado, se você gerar um.

Como usar esses arquivos de cabeçalho para vários destinos:

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})

Primeiro, você include_directories()pode dizer ao CMake para adicionar o diretório -Ià linha de comando da compilação. Segundo, você lista os cabeçalhos na sua chamada add_executable()ou add_library().

Por exemplo, se as fontes do seu projeto estiverem dentro srce você precisar de cabeçalhos include, poderá fazer o seguinte:

include_directories(include)

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

O CMake é mais como uma linguagem de script se comparada com outras maneiras de criar Makefile (por exemplo, make ou qmake). Não é muito legal como o Python, mas ainda assim.

Não existe uma " maneira adequada " se procurar em vários projetos de código aberto como as pessoas incluem diretórios. Mas existem duas maneiras de fazer isso.

1. Os include_directories brutos anexarão um diretório ao projeto atual e a todos os outros projetos descendentes que você anexará por meio de uma série de comandos add_subdirectory . Às vezes, as pessoas dizem que essa abordagem é legada.

2. Uma maneira mais elegante é com o target_include_directories . Ele permite anexar um diretório para um projeto / destino específico sem (talvez) herança desnecessária ou conflito de vários diretórios de inclusão. Também permita executar uma configuração sutil e acrescente um dos seguintes marcadores a este comando.

PRIVATE - use apenas para este destino de construção especificado

PUBLIC - use-o para o destino especificado e para destinos vinculados a este projeto

INTERFACE - use-o apenas para destinos vinculados ao projeto atual

PS:

1. Ambos os comandos permitem marcar um diretório como SYSTEM para dar uma dica de que não é da sua conta que os diretórios especificados contenham avisos.

2. Uma resposta semelhante é com outros pares de comandos target_compile_definitions / add_definitions , target_compile_options / CMAKE_C_FLAGS

Adicionar include_directories("/your/path/here").

Isso será semelhante a chamar gcccom a -I/your/path/here/opção

Coloque aspas duplas no caminho. Outras pessoas não mencionaram isso e isso me deixou presa por 2 dias. Portanto, esta resposta é para pessoas que são muito novas no CMake e muito confusas.

Eu tive o mesmo problema.

Meu diretório de projeto era assim:

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

E o que eu costumava incluir os arquivos em todas essas pastas:

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

    add_executable(Server ${source_files})

E funcionou totalmente.