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