C++ header files layout в проекте и в деплойменте.

Почему просто не сделать -Ipath/to/common?

Да тоже вроде как геморрой на пустом месте. А если таких common несколько, то большой геморрой. :)

Если у библиотеки есть зависимость от другой, то первой надо сказать, где лежит вторая. Может и геморройно, но вполне логично.

В GCC, например, правят инклюды перед их установкой, но мне кажется это костыльным.

Ок. Я так понял, это и есть общепринятый подход. Спасибо.

Например так:

include/
    module1.h
    module2.h
src/
    ...
    module2/
        module2.cpp (#include <module1.h>)

А в cmake-проект тогда надо вписывать:

add_library(common STATIC ../../include/common.h aaa.cpp bbb.cpp)

Тоже думал, но не созрел.

Не, буду-таки прописывать как xaizek посоветовал. В конце концов, пишу же я target_link_libraries(), вот аккурат над ним будет include_directories().

Это решается объявлением переменной на нужном уровне.

set(PUBLIC_HEADER_DIR ${CMAKE_CURRENT_SOURCE_DIR}

А потом в коде модуля:

add_library(common STATIC ${PUBLIC_HEADER_DIR}/include/common.h aaa.cpp bbb.cpp)

Оформлять каждый подпроект в виде либы с инклудами лежащими в директории вида:

root/subproject/include/subproject

В местах включения использовать как стороннее api:

#include <subproject/api.hpp>

В CMake файлах, либо сразу использовать find модули для api - это идеальный вариант, но потребует написания find модуля на каждый подпроект, зато проще потом будет выдрать api из дерева в отдельную библиотеку. Либо, просто прописывать инклуды в виде примерно:

include_directories("${CMAKE_SOURCE_DIR}/subproject/include")

Никаких относительных путей, хотя можешь попробовать и вспомнить меня если поделка взлетит и придётся её саппортить.

Смотри в сторону target_include_directories(PRIVATE/PUBLIC) и target_link_libraries(PRIVATE/PUBLIC)

Использовать подход, к примеру, принятый в Qt. Держать отдельную директорию с однострочными линками на реальный код:

include/foo/foo.h

#include "../../impl/.foo.h"

В настоящем foo.h использовать другие модули по системным путям:

impl/foo.h

#include <bar/bar.h>

В деталях реализации пользоваться относительными путями:

impl/foo.cpp

#include "foo.h"
#include "foo_private.h"

impl/foo_private.h

#include "foo.h"

При установке копировать содержимое include/foo/* с заменой файлов на те, на которые они ссылаются.