INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE

新增於 3.24 版本。

此函式庫的消費者**不**應視為直接連結相依性的函式庫列表。

此目標屬性可用於從相依目標的最終直接連結相依性集合中*排除*項目。此屬性會在相依目標的所有其他相依性的 INTERFACE_LINK_LIBRARIES_DIRECT 目標屬性處理之後進行處理，因此排除直接連結相依性會優先於包含。

相依目標的直接連結相依性的初始集合由其 LINK_LIBRARIES 目標屬性指定。間接連結相依性由直接連結相依性的 INTERFACE_LINK_LIBRARIES 屬性的遞移閉包指定。任何連結相依性都可以使用 INTERFACE_LINK_LIBRARIES_DIRECT 目標屬性指定其他直接連結相依性。然後會過濾直接連結相依性的集合，以排除任何相依性的 INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE 目標屬性所命名的項目。

從相依目標的直接連結相依性中排除項目並不表示相依目標不會連結該項目。該項目可能仍會透過其他相依性上的 INTERFACE_LINK_LIBRARIES 屬性作為間接連結相依性連結。

INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE 的值可以使用 產生器 運算式。

注意

INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE 目標屬性適用於進階使用案例，例如將靜態外掛程式注入到消耗的可執行檔中。它不應用作組織對 target_link_libraries() 的正常呼叫的替代方法。

請參閱 INTERFACE_LINK_LIBRARIES_DIRECT 目標屬性文件，以取得更多詳細資料和範例。