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

Переменные, специфичные для поддержки 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