Spec-Zone.ru › CMake 3.28

CMP0128

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

Когда данная политика установлена в NEW:

  • <LANG>_EXTENSIONS инициализируется значением CMAKE_<LANG>_EXTENSIONS, если оно установлено, в противном случае используется значение по умолчанию CMAKE_<LANG>_EXTENSIONS_DEFAULT.
  • Расширения правильно включаются/отключаются, если <LANG>_STANDARD не задано или удовлетворяется значением по умолчанию.
  • Флаги, влияющие на стандартный режим, не добавляются, если это не необходимо для достижения заданного режима.

Поведение OLD:

  • Инициализирует <LANG>_EXTENSIONS значением CMAKE_<LANG>_EXTENSIONS, если оно установлено, в противном случае использует значение по умолчанию ON.
  • Всегда добавляет флаг, если <LANG>_STANDARD установлено и <LANG>_STANDARD_REQUIRED равно OFF.
  • Если <LANG>_STANDARD не задано:

    • Расширения не отключаются, даже если <LANG>_EXTENSIONS равно OFF.
    • Расширения не включаются, если <LANG>_EXTENSIONS равно ON за исключением компилятора IAR.

Код может потребовать обновления для поведения NEW в следующих случаях:

  • Если флаг режима стандарта, ранее переопределенный CMake и не используемый во время обнаружения компилятора, теперь активируется, поскольку CMake больше не добавляет его, так как обнаруженный по умолчанию подходящий.

    Такой код следует переработать, используя:

    • Использование <LANG>_STANDARD и <LANG>_EXTENSIONS вместо ручного добавления флагов.
    • Или убедиться, что ручные флаги используются во время обнаружения компилятора.
  • Если расширения были отключены без установки <LANG>_STANDARD, ранее CMake не отключал расширения на самом деле.

    Такой код следует обновить, чтобы не отключать расширения, если они необходимы.

  • Если расширения были включены/отключены, когда <LANG>_STANDARD удовлетворялось значением по умолчанию компилятора, CMake ранее не включал/отключал расширения на самом деле.

    Такой код следует обновить для корректного управления режимом работы расширений.

Если флаги компилятора, влияющие на стандартный режим, используются при обнаружении компилятора (например, в a toolchain file с использованием CMAKE_<LANG>_FLAGS_INIT), то они повлияют на обнаруженное значение по умолчанию standard и extensions.

В отличие от многих политик, CMake версии 3.28.6 не предупреждает, когда политика не задана, и просто использует поведение OLD. Используйте команду cmake_policy() для явного задания значения OLD или NEW. См. документацию переменной CMAKE_POLICY_WARNING_CMP0128 для управления предупреждением.

Примечание

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

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

Spec-Zone.ru

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