XCODE_LINK_BUILD_PHASE_MODE

於版本 3.19 新增。

當使用 Xcode 產生器時，要連結的函式庫將會在 Xcode 專案檔中使用「Link Binary With Libraries」建置階段，或直接作為連結器標誌指定。前者允許 Xcode 管理建置路徑，這在建立 Xcode 封存檔時可能會有需要，因為它可能會使用與常規建置不同的建置路徑。

此屬性控制對於 app bundle、可執行檔、共享函式庫、共享框架或模組函式庫的目標使用「Link Binary With Libraries」建置階段。

可能的值為

• NONE 函式庫將會透過直接指定連結器標誌來連結。

• BUILT_ONLY 「Link Binary With Libraries」建置階段將會在以下條件下用於連結至另一個目標

  • 要連結的目標是一個常規的非導入、非介面函式庫目標。

  • 正在建置的目標的輸出目錄沒有從其預設值變更（請參閱 RUNTIME_OUTPUT_DIRECTORY 和 LIBRARY_OUTPUT_DIRECTORY）。

• KNOWN_LOCATION 「Link Binary With Libraries」建置階段將會在與 BUILT_ONLY 相同的條件下用於連結至另一個目標，並且也包含

  • 除了 UNKNOWN 類型的導入函式庫目標。

  • 任何直接使用路徑指定的非目標函式庫。

對於所有其他情況，函式庫將會透過直接指定連結器標誌來連結。

警告

使用「Link Binary With Libraries」連結的函式庫會在透過常規連結器標誌連結的函式庫之後連結。當不同的靜態函式庫包含具有相同名稱的符號時，應該考慮這個順序，因為前者會優先於後者。

警告

如果兩個或多個目錄包含具有相同檔案名稱的函式庫，且某些函式庫是從這些目錄連結的，則函式庫搜尋路徑查找將會連結第一個目錄中的函式庫。這是 Xcode 的已知限制。

此屬性會由 CMAKE_XCODE_LINK_BUILD_PHASE_MODE 變數的值初始化，如果該變數在建立目標時已設定。