XCODE_LINK_BUILD_PHASE_MODE

From Get docs
Cmake/docs/3.21/prop tgt/xcode link build phase mode


XCODE_LINK_BUILD_PHASE_MODE

New in version 3.19.


When using the Xcode generator, libraries to be linked will be specified in the Xcode project file using either the "Link Binary With Libraries" build phase or directly as linker flags. The former allows Xcode to manage build paths, which may be necessary when creating Xcode archives because it may use different build paths to a regular build.

This property controls usage of "Link Binary With Libraries" build phase for a target that is an app bundle, executable, shared library, shared framework or a module library.

Possible values are:

  • NONE The libraries will be linked by specifying the linker flags directly.
  • BUILT_ONLY The "Link Binary With Libraries" build phase will be used to link to another target under the following conditions:
  • KNOWN_LOCATION The "Link Binary With Libraries" build phase will be used to link to another target under the same conditions as with BUILT_ONLY and also:
    • Imported library targets except those of type UNKNOWN.
    • Any non-target library specified directly with a path.

For all other cases, the libraries will be linked by specifying the linker flags directly.

Warning

Libraries linked using "Link Binary With Libraries" are linked after the ones linked through regular linker flags. This order should be taken into account when different static libraries contain symbols with the same name, as the former ones will take precedence over the latter.


Warning

If two or more directories contain libraries with identical file names and some libraries are linked from those directories, the library search path lookup will end up linking libraries from the first directory. This is a known limitation of Xcode.


This property is initialized by the value of the CMAKE_XCODE_LINK_BUILD_PHASE_MODE variable if it is set when a target is created.

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