cmake-policies(7)

• Введение
• Политики, представленные в 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.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: Запрещено выполнение install() для результата export().
• 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 в свойстве TARGET SOURCES.

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

• CMP0050: Запрет сигнатур add_custom_command SOURCE.
• CMP0049: Не расширять переменные в записях источников целевых объектов.
• CMP0048: Команда project() управляет переменной VERSION.
• CMP0047: Использование идентификатора компилятора QCC для драйверов 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: Запрещено включение результата export().

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

• CMP0023: Простые и ключевые сигнатуры target_link_libraries не могут быть смешаны.
• CMP0022: INTERFACE_LINK_LIBRARIES определяет интерфейс компоновки.
• CMP0021: Ошибка при использовании относительных путей в свойстве INCLUDE_DIRECTORIES целевого объекта.
• CMP0020: Автоматическая компоновка Qt-исполняемых файлов с целевым объектом qtmain в Windows.
• CMP0019: Не перерасширять переменные в информации о заголовках и компоновке.
• 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 DESTINATION.
• CMP0005: Значения определений препроцессора теперь автоматически экранируются.
• CMP0004: Библиотеки, связанные с полными путями, не должны иметь ведущих или хвостовых пробелов.
• CMP0003: Библиотеки, связанные полным путём, больше не создают пути поиска компоновщика.
• CMP0002: Логические имена целевых объектов должны быть уникальными в глобальном масштабе.
• CMP0001: CMAKE_BACKWARDS_COMPATIBILITY больше не должен использоваться.
• CMP0000: Необходимо указать минимальную требуемую версию CMake.