CMP0118

GENERATED источники могут использоваться в разных директориях без ручного обозначения.

В CMake 3.19 и ниже свойство источника GENERATED, как и другие свойства файлов-источников, были ограничены каждой директорией отдельно. Если файл-источник был сгенерирован в одной директории, проектам приходилось вручную устанавливать свойство GENERATED в другой директории, чтобы использовать этот файл.

То, сгенерирован ли файл-источник или нет, является глобальным свойством источника «всё или ничего»: источник либо сгенерирован, либо нет. CMake 3.20 и выше предпочитают, чтобы файлы-источники, сгенерированные в одной директории, могли использоваться в других директориях без ручного их обозначения как GENERATED. Кроме того, свойство GENERATED теперь можно устанавливать только для логических значений и нельзя отключить, после того как оно было включено. Данная политика обеспечивает совместимость для проектов, которые не были обновлены для этого поведения.

Поведение OLD этой политики заключается в том, что разрешено использование сгенерированных файлов только в тех директориях, в которых включено их свойство GENERATED. Поведение NEW этой политики заключается в том, что разрешено использование сгенерированных файлов в других директориях без явного включения свойства GENERATED для этих директорий.

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