cmake-policies(7)

Введение
Политики, введённые в CMake 3.21
Политики, введённые в CMake 3.20
Политики, введённые в CMake 3.19
Политики, введённые в CMake 3.18
Политики, введённые в CMake 3.17
Политики, введённые в CMake 3.16
Политики, введённые в 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 начнут выводить предупреждения о поведении обратной совместимости. Можно отключить предупреждение, явно запросив старое, или обратное поведение, используя команду 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 также может использоваться для определения, следует ли сообщать об ошибке при использовании устаревших макросов или функций.

Политики, введённые CMake 3.21

Политики, введённые CMake 3.20

Политики, введённые CMake 3.19

Политики, введённые CMake 3.18

Политики, введённые CMake 3.17

Политики, введённые CMake 3.16

Политики, введённые CMake 3.15

Политики, введённые CMake 3.14

Политики, введённые CMake 3.13

Политики, введённые CMake 3.12

Политики, введённые CMake 3.11

CMP0072: FindOpenGL по умолчанию предпочитает GLVND, если оно доступно.

Политики, введённые CMake 3.10

Политики, введённые CMake 3.9

Политики, введённые CMake 3.8

CMP0067: Учет стандарта языка в try_compile() сигнатуре файла исходного кода.

Политики, введённые CMake 3.7

CMP0066: Учет флагов для каждой конфигурации в сигнатуре файла исходного кода try_compile().

Политики, введённые CMake 3.4

Политики, введённые CMake 3.3

Политики, введенные CMake 3.2

Политики, введенные CMake 3.1

Политики, введенные CMake 3.0

Политики, введённые в CMake 2.8

Политики, введённые в CMake 2.6

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.21/manual/cmake-policies.7.html