CMakeGraphVizOptions

Встроенная поддержка Graphviz в CMake.

Генерация файлов Graphviz

CMake может генерировать файлы Graphviz, отображающие зависимости между целевыми объектами в проекте, а также внешними библиотеками, к которым осуществляется привязка.

При запуске CMake с опцией --graphviz=foo.dot, он генерирует:

• файл foo.dot, показывающий все зависимости в проекте
• файл foo.dot.<target> для каждой цели, отображающий, от каких других целей она зависит
• файл foo.dot.<target>.dependers для каждой цели, отображающий, какие другие цели зависят от неё

Эти файлы .dot можно преобразовать в изображения с помощью команды dot из пакета Graphviz:

dot -Tpng -o foo.png foo.dot

Различные типы зависимостей PUBLIC, INTERFACE и PRIVATE представлены как сплошные, пунктирные и штрихпунктирные линии.

Переменные, специфичные для поддержки Graphviz

Полученные графики могут быть очень большими. Внешний вид и содержимое сгенерированных графиков можно контролировать с помощью файла CMakeGraphVizOptions.cmake. Этот файл сначала ищется в CMAKE_BINARY_DIR, а затем в CMAKE_SOURCE_DIR. Если найден, переменные, заданные в нём, используются для настройки параметров сгенерированных файлов Graphviz.

GRAPHVIZ_GRAPH_NAME

Имя графика.

• Обязательно: НЕТ
• По умолчанию: значение CMAKE_PROJECT_NAME

GRAPHVIZ_GRAPH_HEADER

Заголовок, написанный в верхней части файлов Graphviz.

• Обязательно: НЕТ
• По умолчанию: “node [ fontsize = “12” ];”

GRAPHVIZ_NODE_PREFIX

Префикс для каждого узла в файлах Graphviz.

• Обязательно: НЕТ
• По умолчанию: “node”

GRAPHVIZ_EXECUTABLES

Установить в FALSE, чтобы исключить исполняемые файлы из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_STATIC_LIBS

Установить в FALSE, чтобы исключить статические библиотеки из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_SHARED_LIBS

Установить в FALSE, чтобы исключить динамические библиотеки из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_MODULE_LIBS

Установить в FALSE, чтобы исключить модульные библиотеки из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_INTERFACE_LIBS

Установить в FALSE, чтобы исключить интерфейсные библиотеки из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_OBJECT_LIBS

Установить в FALSE, чтобы исключить библиотеки объектов из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_UNKNOWN_LIBS

Установить в FALSE, чтобы исключить неизвестные библиотеки из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_EXTERNAL_LIBS

Установить в FALSE, чтобы исключить внешние библиотеки из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_CUSTOM_TARGETS

Установить в TRUE, чтобы включить пользовательские целевые объекты в сгенерированные графики.

• Обязательно: НЕТ
• По умолчанию: FALSE

GRAPHVIZ_IGNORE_TARGETS

Список регулярных выражений для имён целевых объектов, которые следует исключить из сгенерированных графиков.

• Обязательно: НЕТ
• По умолчанию: пусто

GRAPHVIZ_GENERATE_PER_TARGET

Установить в FALSE, чтобы не генерировать графики для каждой отдельной цели foo.dot.<target>.

• Обязательно: НЕТ
• По умолчанию: TRUE

GRAPHVIZ_GENERATE_DEPENDERS

Установить в FALSE, чтобы не генерировать графики зависимостей foo.dot.<target>.dependers.

• Обязательно: НЕТ
• По умолчанию: TRUE