New in version 3.17.

Link properties are transitive over private dependencies of static libraries.

In CMake 3.16 and below, evaluation of target properties INTERFACE_LINK_OPTIONS, INTERFACE_LINK_DIRECTORIES, and INTERFACE_LINK_DEPENDS during buildsystem generation does not follow private dependencies of static libraries, which appear in their INTERFACE_LINK_LIBRARIES guarded by LINK_ONLY generator expressions. Only the libraries themselves are propagated to link the dependent binary.

CMake 3.17 and later prefer to propagate all interface link properties. This policy provides compatibility for projects that have not been updated to expect the new behavior.

The OLD behavior for this policy is to not propagate interface link properties. The NEW behavior of this policy is to propagate interface link properties.

New in version 3.30: Policy CMP0166 makes TARGET_PROPERTY evaluation of these three transitive link properties follow private dependencies of static libraries too.

This policy was introduced in CMake version 3.17. It may be set by cmake_policy() or cmake_minimum_required(). If it is not set, CMake does not warn, and uses OLD behavior.


The OLD behavior of a policy is deprecated by definition and may be removed in a future version of CMake.