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
Добавлена в версии 3.10: Разные типы зависимостей 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
© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.31/module/CMakeGraphVizOptions.html