INTERFACE_LINK_LIBRARIES_DIRECT_EXCLUDE

在 3.24 版本中添加。

消费者（consumers）不应将其视为直接链接依赖项的库列表。

此目标属性可用于排除依赖目标最终直接链接依赖项集中的项。此属性在处理完依赖目标的所有其他依赖项的 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 目标属性文档。