CMP0126

Когда эта политика установлена в NEW, команда set(CACHE) не удаляет какие-либо обычные переменные с тем же именем из текущей области видимости. Поведение OLD удаляет любые обычные переменные с тем же именем из текущей области видимости в следующих ситуациях:

• Ранее не существовала переменная кэша с таким именем.
• Ранее существовала переменная кэша с таким именем, но она не имела типа. Это может произойти, когда переменная была установлена в командной строке с помощью формата cmake -DMYVAR=blah вместо cmake -DMYVAR:STRING=blah.
• При установке переменной кэша использовались ключевые слова FORCE или INTERNAL.

Обратите внимание, что поведение NEW имеет важное отличие от аналогичного поведения NEW политики CMP0077. Команда set(CACHE) всегда устанавливает переменную кэша, если она ранее не существовала, независимо от настройки политики CMP0126. Команда option() не установит переменную кэша, если уже существует переменная, не являющаяся переменной кэша, с тем же именем, и CMP0077 установлено в NEW.

Политика CMP0126 была введена в CMake версии 3.21. Используйте команду cmake_policy(), чтобы явно установить её в OLD или NEW в рамках проекта. Используйте переменную CMAKE_POLICY_DEFAULT_CMP0126, чтобы установить политику для стороннего проекта в подкаталоге, не изменяя его. В отличие от многих политик, CMake версии 3.23.3 не предупреждает, когда политика не установлена, и просто использует поведение OLD. См. документацию переменной CMAKE_POLICY_WARNING_CMP0126 для управления предупреждением.