Spec-Zone.ru › CMake 3.19

XCODE_LINK_BUILD_PHASE_MODE

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

При использовании генератора Xcode, библиотеки, которые необходимо связать, будут указаны в файле проекта Xcode, используя либо фазу сборки «Связать двоичный файл с библиотеками», либо напрямую в качестве флагов компоновщика. Первый вариант позволяет Xcode управлять путями сборки, что может потребоваться при создании архивов Xcode, поскольку он может использовать разные пути сборки по сравнению с обычной сборкой.

Это свойство управляет использованием фазы сборки «Связать двоичный файл с библиотеками» для целевого объекта, являющегося пакетом приложения, исполняемым файлом, динамической библиотекой, динамической фреймворковой библиотекой или библиотекой модулей.

Возможные значения:

  • NONE Библиотеки будут связаны, указав флаги компоновщика напрямую.
  • BUILT_ONLY Фаза сборки «Связать двоичный файл с библиотеками» будет использована для связи с другим целевым объектом при следующих условиях:

    • Целевой объект, с которым необходимо установить связь, является обычным, не импортированным, не интерфейсной библиотечной целью.
    • Директория вывода целевого объекта, который собирается, не была изменена с её значения по умолчанию (см. RUNTIME_OUTPUT_DIRECTORY и LIBRARY_OUTPUT_DIRECTORY).
  • KNOWN_LOCATION Фаза сборки «Связать двоичный файл с библиотеками» будет использована для связи с другим целевым объектом при тех же условиях, что и с BUILT_ONLY, а также: - импортированные целевые объекты библиотек, за исключением тех, которые имеют тип UNKNOWN. - Любая библиотека, не являющаяся целевым объектом, указанная непосредственно с путём.

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

Предупреждение

Библиотеки, связанные с помощью «Связать двоичный файл с библиотеками», связываются после тех, которые связаны с помощью обычных флагов компоновщика. Этот порядок следует учитывать, когда разные статические библиотеки содержат символы с одинаковым именем, так как первые будут иметь приоритет над последними.

Предупреждение

Если две или более директории содержат библиотеки с одинаковыми именами файлов и некоторые библиотеки связаны из этих директорий, поиск пути поиска библиотек приведёт к связыванию библиотек из первой директории. Это известное ограничение Xcode.

Это свойство инициализируется значением переменной CMAKE_XCODE_LINK_BUILD_PHASE_MODE, если она задана при создании целевого объекта.

© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.19/prop_tgt/XCODE_LINK_BUILD_PHASE_MODE.html

Spec-Zone.ru

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