CMP0068ΒΆ
New in version 3.9.
RPATH
settings on macOS do not affect install_name
.
CMake 3.9 and newer remove any effect the following settings may have on the
install_name
of a target on macOS:
BUILD_WITH_INSTALL_RPATH
target propertySKIP_BUILD_RPATH
target propertyCMAKE_SKIP_RPATH
variableCMAKE_SKIP_INSTALL_RPATH
variable
Previously, setting BUILD_WITH_INSTALL_RPATH
had the effect of
setting both the install_name
of a target to INSTALL_NAME_DIR
and the RPATH
to INSTALL_RPATH
. In CMake 3.9, it only affects
setting of RPATH
. However, if one wants INSTALL_NAME_DIR
to
apply to the target in the build tree, one may set
BUILD_WITH_INSTALL_NAME_DIR
.
If SKIP_BUILD_RPATH
, CMAKE_SKIP_RPATH
or
CMAKE_SKIP_INSTALL_RPATH
were used to strip the directory portion
of the install_name
of a target, one may set INSTALL_NAME_DIR=""
instead.
The OLD
behavior of this policy is to use the RPATH
settings for
install_name
on macOS. The NEW
behavior of this policy is to ignore
the RPATH
settings for install_name
on macOS.
This policy was introduced in CMake version 3.9. CMake version
3.22.6 warns when the policy is not set and uses OLD
behavior.
Use the cmake_policy()
command to set it to OLD
or NEW
explicitly.
Note
The OLD
behavior of a policy is
deprecated by definition
and may be removed in a future version of CMake.