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 变量的值初始化。