Spec-Zone.ru › CMake 3.31

CMP0116

Добавлена в версии 3.20.

Генераторы Ninja преобразуют DEPFILE из add_custom_command().

В CMake 3.19 и ниже, файлы, переданные в аргумент DEPFILE команды add_custom_command(), передавались напрямую в переменную Ninja depfile без разрешения путей. Это означало, что если команда add_custom_command() вызывалась из подкаталога (созданного командой add_subdirectory()), аргумент DEPFILE должен был быть либо абсолютным путем, либо путем, относительным к CMAKE_BINARY_DIR, а не к CMAKE_CURRENT_BINARY_DIR. Кроме того, над файлами, указанными в DEPFILE, не производилось никаких преобразований, что означало, что пути внутри DEPFILE имели те же ограничения.

Начиная с CMake 3.20, аргумент DEPFILE является относительным к CMAKE_CURRENT_BINARY_DIR (если он не является абсолютным), а пути в DEPFILE также относительны к CMAKE_CURRENT_BINARY_DIR. CMake автоматически преобразует пути в DEPFILE (если они не абсолютные) после выполнения пользовательской команды. Файл, указанный в DEPFILE, не изменяется никоим образом. Вместо этого CMake записывает преобразование в свой собственный внутренний файл и передает этот внутренний файл в переменную Ninja depfile. Это преобразование происходит независимо от того, является ли DEPFILE относительным и независимо от того, вызывается ли add_custom_command() из подкаталога.

Поведение OLD по отношению к этой политике заключается в передаче DEPFILE в Ninja без изменений. Поведение NEW по отношению к этой политике заключается в преобразовании DEPFILE после выполнения пользовательской команды. Статус CMP0116 записывается в момент создания пользовательской команды, и вы можете иметь пользовательские команды в одном каталоге с разными значениями для CMP0116 путем настройки политики перед каждой пользовательской командой.

Эта политика была введена в версии CMake 3.20. Она может быть установлена с помощью cmake_policy() или cmake_minimum_required(). Если она не установлена, CMake по умолчанию не предупреждает (если DEPFILE используется в подкаталоге) и использует поведение OLD.

См. документацию переменной CMAKE_POLICY_WARNING_CMP0116 для управления предупреждением.

Примечание

Поведение OLD политики deprecated by definition и может быть удалено в будущей версии CMake.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API