cmake-policies(7)

Введение
Политики, введённые в CMake 3.15
Политики, введённые в CMake 3.14
Политики, введённые в CMake 3.13
Политики, введённые в CMake 3.12
Политики, введённые в CMake 3.11
Политики, введённые в CMake 3.10
Политики, введённые в CMake 3.9
Политики, введённые в CMake 3.8
Политики, введённые в CMake 3.7
Политики, введённые в CMake 3.4
Политики, введённые в CMake 3.3
Политики, введённые в CMake 3.2
Политики, введённые в CMake 3.1
Политики, введённые в CMake 3.0
Политики, введённые в CMake 2.8
Политики, введённые в CMake 2.6

Введение

Политики в CMake используются для сохранения обратной совместимости в разных версиях. Когда вводится новая политика, более новые версии CMake начнут предупреждать об обратной совместимости. Можно отключить предупреждение, явно запросив поведение OLD, или обратной совместимости, используя команду cmake_policy(). Также можно запросить NEW, или не обратной совместимости для политики, также избегая предупреждения. Каждая политика также может быть установлена в NEW или OLD поведение явно в командной строке с переменной CMAKE_POLICY_DEFAULT_CMP<NNNN>.

Политика является механизмом устаревания, а не надёжным переключателем функций. Политику почти никогда не следует устанавливать в OLD, за исключением случаев, когда нужно заглушить предупреждения в полностью замороженном или стабильном коде, или временно в рамках более масштабного пути миграции. OLD поведение каждой политики нежелательно и будет заменено условием ошибки в будущей версии.

Команда cmake_minimum_required() делает больше, чем просто сообщает об ошибке, если используется слишком старая версия CMake для сборки проекта. Она также устанавливает все политики, введённые в этой версии CMake или ранее, в NEW поведение. Для управления политиками без увеличения минимально требуемой версии CMake можно использовать команду if(POLICY):

if(POLICY CMP0990)
  cmake_policy(SET CMP0990 NEW)
endif()

Это приводит к использованию NEW поведения с более новыми версиями CMake, которые могут использоваться пользователями, и не выдавать предупреждений о совместимости.

В некоторых случаях установка политики не распространяется на родительский контекст. Например, если файлы, прочитанные командой include() или командой find_package(), содержат использование cmake_policy(), эта настройка политики по умолчанию не повлияет на вызывающую сторону. Обе команды принимают необязательный NO_POLICY_SCOPE ключевое слово для управления этим поведением.

Переменная CMAKE_MINIMUM_REQUIRED_VERSION также может использоваться для определения того, следует ли сообщать об ошибке при использовании устаревших макросов или функций.