CMAKE_NINJA_OUTPUT_PATH_PREFIX

Новое в версии 3.6.

Укажите генераторам Ninja Generators, чтобы добавить префикс к каждому пути вывода в build.ninja. К префиксу добавляется конечный слеш, если его нет.

Это полезно, когда сгенерированный файл ninja предназначен для встраивания в качестве subninja файла в проект super ninja. Например, команда:

cd super-build-dir &&
cmake -G Ninja -S /path/to/src -B sub -DCMAKE_NINJA_OUTPUT_PATH_PREFIX=sub/
#                                 ^^^---------- these match -----------^^^

генерирует каталог сборки с его корневым каталогом (CMAKE_BINARY_DIR) в super-build-dir/sub. Путь к каталогу сборки заканчивается префиксом пути вывода. Это делает его пригодным для использования в отдельном файле super-build-dir/build.ninja с директивой такого типа:

subninja sub/build.ninja

Правило auto-regeneration в super-build-dir/build.ninja должно иметь зависимость только по порядку от sub/build.ninja.

Новое в версии 3.27: Генератор Ninja Multi-Config поддерживает эту переменную.

Примечание

Когда CMAKE_NINJA_OUTPUT_PATH_PREFIX задано, сгенерированный CMake проектом не может использоваться как автономный проект. Не заданы никакие целевые задачи по умолчанию.

Значение CMAKE_NINJA_OUTPUT_PATH_PREFIX должно совпадать с одним или несколькими компонентами пути в конце CMAKE_BINARY_DIR, в противном случае поведение не определено. Однако эта необходимость не проверяется автоматически.

© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.30/variable/CMAKE_NINJA_OUTPUT_PATH_PREFIX.html