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_policy() или cmake_minimum_required(). Если она не установлена, CMake выводит предупреждение и использует поведение OLD.

Используйте переменную CMAKE_POLICY_DEFAULT_CMP0077, чтобы задать политику для проекта третьих лиц в подкаталоге без его изменения.