CMP0077

option() поддерживает обычные переменные.

Команда option() обычно используется для создания записи кэша, позволяющей пользователям установить опцию. Однако в некоторых случаях, проект может определить обычную (не кэшированную) переменную с тем же именем, что и опция, до вызова команды option(). Например, проект, который встраивает другой проект в качестве подкаталога, может захотеть жестко закодировать опции подпроекта, чтобы собрать его нужным образом.

По историческим причинам в CMake 3.12 и ниже команда option() удаляет обычную (не кэшированную) переменную с тем же именем, когда:

• запись кэша с указанным именем вообще не существует, или
• запись кэша с указанным именем существует, но ей не был задан тип (например, с помощью -D<name>=ON в командной строке).

В обоих этих случаях (обычно при первом запуске в новой структуре сборки), команда option() присваивает записи кэша тип BOOL и удаляет любые обычные (не кэшированные) переменные с тем же именем. В оставшемся случае, когда запись кэша с указанным именем уже существует и имеет тип (обычно при последующих запусках в структуре сборки), команда option() ничего не изменяет, и любая обычная переменная с тем же именем остается установленной.

В CMake 3.13 и выше команда option() предпочитает ничего не делать, когда обычная переменная с заданным именем уже существует. Она не создает и не обновляет запись кэша и не удаляет обычную переменную. Новое поведение согласовано между первым и последующими запусками в дереве сборки. Эта политика обеспечивает совместимость с проектами, которые не были обновлены для ожидания нового поведения.

Когда команда option() видит обычную переменную с заданным именем:

• Поведение OLD для этой политики заключается в продолжении выполнения даже при наличии обычной переменной с тем же именем. Если запись кэша еще не существует и не имеет типа, она создается и/или получает тип, а обычная переменная удаляется.
• Поведение NEW для этой политики заключается в том, что ничего не делать, когда обычная переменная с тем же именем существует. Обычная переменная не удаляется. Запись кэша не создается и не обновляется, а игнорируется, если она существует.

Эта политика была введена в версии CMake 3.13. Версия CMake 3.16.9 предупреждает, когда политика не установлена и использует поведение OLD. Используйте команду cmake_policy() для явного её установки на OLD или NEW.