Spec-Zone.ru › CMake 3.29

CMP0069

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

INTERPROCEDURAL_OPTIMIZATION применяется при включении.

CMake 3.9 и более поздние версии предпочитают добавлять флаги IPO всякий раз, когда свойство целевого объекта INTERPROCEDURAL_OPTIMIZATION включено, и выдавать ошибку, если CMake не знает флагов для текущего компилятора. Поскольку компилятор может не поддерживать флаги IPO во всех средах, в которых он используется, теперь проект обязан использовать модуль CheckIPOSupported для проверки поддержки перед включением свойства целевого объекта INTERPROCEDURAL_OPTIMIZATION. Этот подход позволяет проекту условно активировать IPO при поддержке. Он также позволяет конечному пользователю задать переменную CMAKE_INTERPROCEDURAL_OPTIMIZATION в среде, известной как поддерживающая IPO, даже если проект не включает данное свойство.

Поскольку CMake 3.8 и ниже учитывали INTERPROCEDURAL_OPTIMIZATION только для компилятора Intel на Linux, некоторые проекты могут безусловно включать свойство целевого объекта. Политика CMP0069 обеспечивает совместимость с такими проектами.

Данная политика вступает в силу при включении свойства IPO. Поведение OLD для этой политики заключается в добавлении флагов IPO только для компилятора Intel на Linux. Поведение NEW для этой политики заключается в добавлении флагов IPO для текущего компилятора или выдаче ошибки, если CMake не знает этих флагов.

Эта политика была введена в CMake версии 3.9. Её можно установить с помощью команды cmake_policy() или cmake_minimum_required(). Если она не установлена, CMake выводит предупреждение и использует поведение OLD.

Примечание

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

Примеры

Ведите себя как CMake 3.8 и не применяйте никакие флаги IPO, кроме флагов для компилятора Intel на Linux:

cmake_minimum_required(VERSION 3.8)
project(foo)

# ...

set_property(TARGET ... PROPERTY INTERPROCEDURAL_OPTIMIZATION TRUE)

Используйте модуль CheckIPOSupported для определения, поддерживает ли текущий компилятор, среда и версия CMake IPO. Выдайте ошибку, если поддержка недоступна:

cmake_minimum_required(VERSION 3.9) # CMP0069 NEW
project(foo)

include(CheckIPOSupported)
check_ipo_supported()

# ...

set_property(TARGET ... PROPERTY INTERPROCEDURAL_OPTIMIZATION TRUE)

Применяйте флаги IPO только если компилятор их поддерживает:

cmake_minimum_required(VERSION 3.9) # CMP0069 NEW
project(foo)

include(CheckIPOSupported)

# ...

check_ipo_supported(RESULT result)
if(result)
  set_property(TARGET ... PROPERTY INTERPROCEDURAL_OPTIMIZATION TRUE)
endif()

Применяйте флаги IPO без каких-либо проверок. Это может привести к ошибкам сборки, если IPO не поддерживается компилятором в текущей среде. Выдайте ошибку, если CMake не знает флагов IPO для текущего компилятора:

cmake_minimum_required(VERSION 3.9) # CMP0069 NEW
project(foo)

# ...

set_property(TARGET ... PROPERTY INTERPROCEDURAL_OPTIMIZATION TRUE)

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

Spec-Zone.ru

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