¿Cuál es la diferencia entre include_directories y target_include_directories en CMake?

Tengo una estructura de directorio para mi código C ++ que es así:

|
|->include
|->src

Estoy escribiendo un archivo CMakeLists.txt para mi código. Quiero entender la diferencia entre include_directoriesy target_include_directoriesen CMake.

¿Cuál es la diferencia entre su uso y para agregar mi ruta de archivo de inclusión cuál debo usar?

include_directories(x/y)afecta el alcance del directorio. Todos los objetivos en esta CMakeList, así como aquellos en todos los subdirectorios agregados después del punto de su llamada, tendrán la ruta x/yagregada a su ruta de inclusión.

target_include_directories(t x/y)tiene alcance objetivo: se agrega x/ya la ruta de inclusión para el objetivo t.

Desea el primero si todos sus objetivos usan los directorios de inclusión en cuestión. Desea el último si la ruta es específica de un objetivo, o si desea un control más preciso de la visibilidad de la ruta. Este último viene del hecho de que target_include_directories()es compatible con los PRIVATE, PUBLICy INTERFACEcalificadores.

Además de lo que dice correctamente la respuesta de Angew , otra diferencia muy importante entre include_directoriesy target_include_directorieses que, cuando se usa con PUBLICo INTERFACE, este último llena la INTERFACE_INCLUDE_DIRECTORIESpropiedad del objetivo. Esta propiedad es útil cuando otro objetivo utiliza target_link_librariespara vincular al objetivo original, ya que el objetivo de vinculación tendrá automáticamente los directorios de inclusión agregados. Ver ejemplo .

Esta característica importante está bastante bien oculta en la documentación: target_include_directories menciona la población INTERFACE_INCLUDE_DIRECTORIES, cuya documentación dice:

Cuando las dependencias de destino se especifican utilizando target_link_libraries () , CMake leerá esta propiedad de todas las dependencias de destino para determinar las propiedades de compilación del consumidor.

Como dijo @Angew, la diferencia es:

1, include_directories () es accesible para todos los archivos en el árbol de origen 2, target_include_directories () es accesible solo para un destino específico cuando se compila.