CMP0077

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

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

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

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

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

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

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

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

См. CMP0126 для аналогичной политики для команды set(CACHE), но обратите внимание на некоторые различия в NEW поведении между двумя политиками.

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