INSTALL_RPATHΒΆ
The rpath to use for installed targets.
By default, the install rpath is empty. It can be set using this property,
which is a semicolon-separated list specifying the rpath to use in installed
targets (for platforms that support it). This property is initialized
by the value of the variable CMAKE_INSTALL_RPATH if it is set
when a target is created.
Beside setting the install rpath manually, using the
INSTALL_RPATH_USE_LINK_PATH target property it can also be
generated automatically by CMake.
Normally CMake uses the build tree for the RPATH when building executables
etc on systems that use RPATH, see the BUILD_RPATH target
property. When the software is installed
the targets are edited (or relinked) by CMake (see
CMAKE_NO_BUILTIN_CHRPATH) to have the install RPATH.
This editing during installation can be avoided via
the BUILD_WITH_INSTALL_RPATH target property.
For handling toolchain-dependent RPATH entries the
INSTALL_REMOVE_ENVIRONMENT_RPATH can be used.
Runtime paths can be disabled completely via the CMAKE_SKIP_RPATH
variable.
Because the rpath may contain ${ORIGIN}, which coincides with CMake syntax,
the contents of INSTALL_RPATH are properly escaped in the
cmake_install.cmake script (see policy CMP0095.)
This property supports
generator expressions.
On Apple platforms, refer to the INSTALL_NAME_DIR target property.
Under Windows, the TARGET_RUNTIME_DLLS generator expression is related.