Spec-Zone.ru › CMake 3.24

CMP0120

Новое в версии 3.20.

Модуль WriteCompilerDetectionHeader удален.

Версии CMake с 3.1 по 3.19 предоставляют этот модуль для генерации слоя совместимости C++ путём повторного использования информации из таблицы проверок препроцессора CMake для cmake-compile-features(7). Однако:

  • Эти детализированные возможности были заменены мета-возможностями для Требования к стандартам языка, таким как cxx_std_11. Поэтому новые проверки на наличие детализированных возможностей добавляться не будут, и проектам потребуется использовать другие средства для условного использования новых возможностей C++.
  • Модуль напрямую раскрывает некоторые детали реализации CMake для C++ единиц трансляции.
  • Подход модуля фактически предоставляет заголовочный файл с CMake, тем самым привязывая версию заголовочного файла к версии CMake. Многие проекты обнаружили, что модуль WriteCompilerDetectionHeader лучше использовать, вручную сгенерировав его заголовочный файл локально с помощью последней версии CMake, а затем включив его в исходный код проекта, чтобы он мог работать с более старыми версиями CMake.

По причинам, включая вышеперечисленные, CMake 3.20 и выше предпочитают не предоставлять модуль WriteCompilerDetectionHeader. Эта политика обеспечивает совместимость для проектов, которые ещё не были переведены с неё. Проекты, использующие этот модуль, должны быть обновлены, чтобы перестать его использовать. Альтернативы включают:

  • Включить копию сгенерированного заголовочного файла в исходный код проекта.
  • Использовать стороннюю альтернативу, например, Hedley с лицензией CC0.
  • Отказаться от поддержки компиляторов, которые не поддерживают необходимые функции.

Поведение OLD этой политики — для включения устаревшего модуля WriteCompilerDetectionHeader. Поведение NEW — для включения модуля, как если бы он не существовал.

Эта политика была введена в версии CMake 3.20. Версия CMake 3.24.2 выводит предупреждение, когда политика не установлена, и использует поведение OLD. Используйте команду cmake_policy(), чтобы установить её явно в OLD или NEW.

Примечание

Поведение OLD политики deprecated by definition и может быть удалено в будущих версиях CMake.

© 2000–2022 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.24/policy/CMP0120.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API