CMP0116

Генераторы 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 для управления предупреждением.