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