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.15.7 предупреждает, когда политика не установлена, и использует поведение OLD. Используйте команду cmake_policy(), чтобы установить её явно на OLD или NEW.