CMP0116

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

В CMake 3.19 и ниже, файлы, переданные в аргумент DEPFILE команды add_custom_command(), передавались напрямую в переменную depfile Ninja без разрешения пути. Это означало, что если 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 записывает преобразование в свой собственный внутренний файл и передает этот внутренний файл в переменную depfile Ninja. Это преобразование происходит независимо от того, является ли DEPFILE относительным, и независимо от того, вызывается ли add_custom_command() из подкаталога или нет.

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

Эта политика была представлена в версии CMake 3.20. В отличие от большинства политик, CMake версии 3.20.0-rc3 не выдает предупреждение по умолчанию, когда эта политика не установлена (если DEPFILE используется в подкаталоге), и просто использует поведение OLD. См. документацию переменной CMAKE_POLICY_WARNING_CMP0116 для управления предупреждением.