cmake-policies(7)

• Введение
• Политики, введённые в 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.20

• CMP0120: Модуль WriteCompilerDetectionHeader удалён.
• CMP0119: Свойство файла исходного кода LANGUAGE явно компилирует как язык.
• CMP0118: Свойство файла исходного кода GENERATED теперь видно во всех каталогах.
• CMP0117: Флаг MSVC RTTI /GR не добавляется в CMAKE_CXX_FLAGS по умолчанию.
• CMP0116: Генераторы Ninja преобразуют DEPFILE из add_custom_command().
• CMP0115: Расширения файлов исходного кода должны быть явными.

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

• CMP0114: Целевые шаги ExternalProject полностью принимают свои шаги.
• CMP0113: Генераторы Makefile не повторяют пользовательские команды из зависимостей целей.
• CMP0112: Выражения компонент файла цели генератора не добавляют зависимости целей.
• CMP0111: Импортированная цель, у которой отсутствует свойство расположения, завершается сбоем при генерации.
• CMP0110: add_test() поддерживает произвольные символы в именах тестов.
• CMP0109: find_program() требует разрешения на выполнение, но не на чтение.

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

• CMP0108: Цель не может ссылаться на себя через псевдоним.
• CMP0107: Цель-псевдоним не может перезаписывать другую цель.
• CMP0106: Модуль Documentation удалён.
• CMP0105: Шаг связывания устройства использует параметры связывания.
• CMP0104: CMAKE_CUDA_ARCHITECTURES теперь обнаруживается для NVCC, пустые CUDA_ARCHITECTURES запрещены.
• CMP0103: Не разрешено несколько export() с тем же FILE без APPEND.

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

• CMP0102: mark_as_advanced() ничего не делает, если запись кеша не существует.
• CMP0101: target_compile_options учитывает ключевое слово BEFORE во всех контекстах.
• CMP0100: Разрешить AUTOMOC и AUTOUIC обрабатывать файлы заголовков .hh.
• CMP0099: Свойства связывания являются транзитивными по отношению к частной зависимости от статических библиотек.
• CMP0098: FindFLEX выполняет flex в CMAKE_CURRENT_BINARY_DIR при выполнении.

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

• CMP0097: ExternalProject_Add с GIT_SUBMODULES "" не инициализирует подмодули.
• CMP0096: project() сохраняет ведущие нули в компонентах версии.
• CMP0095: Записи RPATH должным образом экранируются в скрипте промежуточной установки CMake.

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

• CMP0094: FindPython3, FindPython2 и FindPython используют LOCATION для стратегии поиска.
• CMP0093: FindBoost сообщает Boost_VERSION в формате x.y.z.
• CMP0092: Флаги предупреждений MSVC не входят в CMAKE_{C,CXX}_FLAGS по умолчанию.
• CMP0091: Флаги библиотеки времени выполнения MSVC выбираются с помощью абстракции.
• CMP0090: export(PACKAGE) не заполняет реестр пакетов по умолчанию.
• CMP0089: Идентификатор компилятора для IBM Clang-based XL компиляторов теперь XLClang.

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

• CMP0088: FindBISON запускает bison в CMAKE_CURRENT_BINARY_DIR при выполнении.
• CMP0087: install(SCRIPT | CODE) поддерживает генераторы выражений.
• CMP0086: UseSWIG учитывает SWIG_MODULE_NAME через флаг -module.
• CMP0085: Генератор выражений IN_LIST обрабатывает пустые элементы списка.
• CMP0084: Модуль FindQt не существует для find_package().
• CMP0083: Добавление опций PIE при линковке исполняемого файла.
• CMP0082: Правила установки из add_subdirectory() переплетаются с правилами в вызывающем элементе.

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

• CMP0081: Относительные пути запрещены в свойстве LINK_DIRECTORIES целевого объекта.
• CMP0080: BundleUtilities нельзя включать во время конфигурации.
• CMP0079: target_link_libraries допускает использование с целевыми объектами в других директориях.
• CMP0078: UseSWIG генерирует стандартные имена целевых объектов.
• CMP0077: option() учитывает обычные переменные.
• CMP0076: Команда target_sources() преобразует относительные пути в абсолютные.

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

• CMP0075: Макросы проверки файлов включают CMAKE_REQUIRED_LIBRARIES.
• CMP0074: find_package использует переменные PackageName_ROOT.
• CMP0073: Не генерировать устаревшие кэшированные записи _LIB_DEPENDS.

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

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

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

• CMP0071: Позволить AUTOMOC и AUTOUIC обрабатывать файлы GENERATED.
• CMP0070: Определение поведения file(GENERATE) для относительных путей.

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

• CMP0069: INTERPROCEDURAL_OPTIMIZATION применяется при включении.
• CMP0068: Настройки RPATH на macOS не влияют на install_name.

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

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

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

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

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

• CMP0065: Не добавлять флаги для экспорта символов из исполняемых файлов без свойства ENABLE_EXPORTS целевого объекта.
• CMP0064: Поддержка нового оператора TEST if().

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

• CMP0063: Учёт свойств видимости для всех типов целевых объектов.
• CMP0062: Запрет установки результата export() с помощью install().
• CMP0061: CTest по умолчанию не сообщает make игнорировать ошибки (-i).
• CMP0060: Линковка библиотек по полному пути, даже в неявных директориях.
• CMP0059: DEFINITIONS не рассматриваются как встроенное свойство директории.
• CMP0058: Ninja требует явных побочных продуктов пользовательских команд.
• CMP0057: Поддержка нового оператора IN_LIST if().

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

• CMP0056: Учёт флагов линковки в сигнатуре файла при try_compile().
• CMP0055: Строгая проверка команды break().

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

• CMP0054: Интерпретация аргументов if() только как переменных или ключевых слов при отсутствии кавычек.
• CMP0053: Упрощение оценки ссылок на переменные и последовательностей экранирования.
• CMP0052: Отклонение каталогов исходных и библиотек в установленных INTERFACE_INCLUDE_DIRECTORIES.
• CMP0051: Список TARGET_OBJECTS в свойстве SOURCES целевого объекта.

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

• CMP0050: Запрет подписей SOURCE в add_custom_command.
• CMP0049: Не расширять переменные в записях источника целевого объекта.
• CMP0048: Команда project() управляет переменными VERSION.
• CMP0047: Использование QCC compiler id для драйверов qcc на QNX.
• CMP0046: Ошибка при отсутствующей зависимости в add_dependencies.
• CMP0045: Ошибка при отсутствующем целевом объекте в get_target_property.
• CMP0044: Генераторы выражений Lang_COMPILER_ID регистрозависимые.
• CMP0043: Игнорировать свойства COMPILE_DEFINITIONS_Config.
• CMP0042: MACOSX_RPATH включено по умолчанию.
• CMP0041: Ошибка при относительном включении с генератором выражений.
• CMP0040: Целевой объект в сигнатуре TARGET команды add_custom_command должен существовать.
• CMP0039: Вспомогательные целевые объекты не могут иметь зависимости линковки.
• CMP0038: Целевые объекты не могут напрямую линковаться к себе.
• CMP0037: Имена целевых объектов не должны быть зарезервированы и должны соответствовать шаблону валидности.
• CMP0036: Команда build_name не должна вызываться.
• CMP0035: Команда variable_requires не должна вызываться.
• CMP0034: Команда utility_source не должна вызываться.
• CMP0033: Команда export_library_dependencies не должна вызываться.
• CMP0032: Команда output_required_files не должна вызываться.
• CMP0031: Команда load_command не должна вызываться.
• CMP0030: Команда use_mangled_mesa не должна вызываться.
• CMP0029: Команда subdir_depends не должна вызываться.
• CMP0028: Двойные двоеточия в имени целевого объекта означают ALIAS или IMPORTED целевой объект.
• CMP0027: Условные зависимые импортированные целевые объекты с отсутствующими директориями заголовков.
• CMP0026: Запрещено использование свойства LOCATION целевого объекта.
• CMP0025: Идентификатор компилятора Apple Clang теперь AppleClang.
• CMP0024: Запрещено включение результата экспорта.

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

• CMP0023: Нельзя смешивать подписи target_link_libraries с обычными и ключевыми.
• CMP0022: INTERFACE_LINK_LIBRARIES определяет интерфейс связи.
• CMP0021: Критическая ошибка при использовании относительных путей в свойстве INCLUDE_DIRECTORIES целевого объекта.
• CMP0020: Автоматическое подключение исполняемых файлов Qt к целевому объекту qtmain в Windows.
• CMP0019: Не повторно расширять переменные в информации об include и link.
• CMP0018: Игнорировать переменную CMAKE_SHARED_LIBRARY_Lang_FLAGS.
• CMP0017: Предпочитать файлы из каталога модуля CMake при включении из него.
• CMP0016: target_link_libraries() сообщает об ошибке, если единственный аргумент не является целевым объектом.
• CMP0015: link_directories() обрабатывает пути относительно каталога исходных файлов.
• CMP0014: Каталоги ввода должны содержать CMakeLists.txt.
• CMP0013: Не разрешены дублирующие каталоги библиотек.
• CMP0012: if() распознаёт числа и булевы константы.

Политики, представленные CMake 2.6

• CMP0011: Включённые скрипты выполняют автоматический cmake_policy PUSH и POP.
• CMP0010: Неправильный синтаксис ссылки на переменную — это ошибка.
• CMP0009: FILE GLOB_RECURSE по умолчанию не должны следовать символичным ссылкам.
• CMP0008: Библиотеки, связанные полным путём, должны иметь действительное имя файла библиотеки.
• CMP0007: Команда list больше не игнорирует пустые элементы.
• CMP0006: Установка целевых объектов MACOSX_BUNDLE требует назначения BUNDLE.
• CMP0005: Значения определений препроцессора теперь автоматически экранируются.
• CMP0004: Связанные библиотеки не должны содержать пробелов в начале или конце.
• CMP0003: Библиотеки, связанные с полным путём, больше не генерируют пути поиска компоновщика.
• CMP0002: Логические имена целевых объектов должны быть уникальными в глобальном масштабе.
• CMP0001: CMAKE_BACKWARDS_COMPATIBILITY больше не должен использоваться.
• CMP0000: Необходимо указать минимальную требуемую версию CMake.