cmake-policies(7)

• Введение
• Политики, представленные 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.18

• CMP0108: Цель не может ссылаться на себя через псевдоним.
• CMP0107: Цель-псевдоним не может перезаписывать другую цель.
• CMP0106: Модуль документации удалён.
• 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: Запрет 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 в свойстве 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: Запрет использования include результата 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.
• CMP0005: Значения определений препроцессора теперь автоматически экранируются.
• CMP0004: Связанные библиотеки не должны содержать начальных или конечных пробелов.
• CMP0003: Библиотеки, связанные с полным путём, больше не генерируют пути поиска компоновщика.
• CMP0002: Логические имена целей должны быть уникальными во всём проекте.
• CMP0001: CMAKE_BACKWARDS_COMPATIBILITY больше не должен использоваться.
• CMP0000: Необходимо указать минимальную требуемую версию CMake.