Come aggiungere correttamente le directory include con CMake

Circa un anno fa ho chiesto informazioni sulle dipendenze delle intestazioni in CMake .

Di recente mi sono reso conto che il problema sembrava essere che CMake considerasse quei file di intestazione esterni al progetto. Almeno, quando si genera un progetto Code :: Blocks i file di intestazione non vengono visualizzati all'interno del progetto (i file di origine lo fanno). Pertanto, mi sembra che CMake consideri tali intestazioni esterne al progetto e non le tiene traccia delle dipendenze.

Una rapida ricerca nel tutorial di CMake ha indicato solo include_directoriesche non sembra fare quello che desidero ...

Qual è il modo corretto di segnalare a CMake che una determinata directory contiene intestazioni da includere e che tali intestazioni devono essere tracciate dal Makefile generato?

Due cose devono essere fatte.

Per prima cosa aggiungi la directory da includere:

target_include_directories(test PRIVATE ${YOUR_DIRECTORY})

Nel caso in cui tu sia bloccato con una versione CMake molto vecchia (2.8.10 o precedente) senza supporto target_include_directories, puoi include_directoriesinvece usare l'eredità :

include_directories(${YOUR_DIRECTORY})

Quindi è anche necessario aggiungere i file di intestazione all'elenco dei file di origine per la destinazione corrente, ad esempio:

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

In questo modo, i file di intestazione verranno visualizzati come dipendenze nel Makefile e, ad esempio, nel progetto Visual Studio generato, se ne viene generato uno.

Come utilizzare quei file di intestazione per diversi target:

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

Per prima cosa, usi include_directories()per dire a CMake di aggiungere la directory -Ialla riga di comando della compilazione. In secondo luogo, elenchi le intestazioni nel tuo add_executable()o add_library()chiama.

Ad esempio, se le fonti del tuo progetto sono presenti srce hai bisogno di intestazioni include, puoi farlo in questo modo:

include_directories(include)

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

CMake è più simile a un linguaggio di script se lo confronta con altri modi per creare Makefile (ad esempio make o qmake). Non è molto bello come Python, ma comunque.

Non esiste un " modo corretto " se si guarda in vari progetti open source come le persone includono le directory. Ma ci sono due modi per farlo.

1. La grezza include_directory aggiunge una directory al progetto corrente e a tutti gli altri progetti discendenti che verranno aggiunti tramite una serie di comandi add_subdirectory . A volte le persone dicono che tale approccio è eredità.

2. Un modo più elegante è con target_include_directories . Permette di aggiungere una directory per uno specifico progetto / target senza (forse) eredità o scontro inutili di varie directory include. Consenti anche di eseguire anche una configurazione sottile e aggiungi uno dei seguenti marcatori per questo comando.

PRIVATO : utilizzare solo per questo target di build specificato

PUBBLICO : utilizzalo per target specificato e per target che si collegano a questo progetto

INTERFACCIA : utilizzalo solo per obiettivi che si collegano al progetto corrente

PS:

1. Entrambi i comandi consentono di contrassegnare una directory come SISTEMA per suggerire che non sono gli affari che le directory specificate conterranno avvisi.

2. Una risposta simile è con altre coppie di comandi target_compile_definitions / add_definitions , target_compile_options / CMAKE_C_FLAGS

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

Questo sarà simile alla chiamata gcccon -I/your/path/here/opzione.

Assicurati di inserire doppie virgolette attorno al percorso. Altre persone non lo hanno menzionato e mi ha fatto rimanere bloccato per 2 giorni. Quindi questa risposta è per le persone che sono molto nuove in CMake e molto confuse.

Ho avuto lo stesso problema.

La mia directory di progetto era così:

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

E cosa ho usato per includere i file in tutte quelle cartelle:

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

    add_executable(Server ${source_files})

E ha funzionato totalmente.