Spec-Zone.ru › CMake 3.27

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–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.27/prop_tgt/XCODE_LINK_BUILD_PHASE_MODE.html

Spec-Zone.ru

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