cmake/Help/prop_tgt/INSTALL_NAME_DIR.rst

24 lines
1.0 KiB
ReStructuredText
Raw Normal View History

2014-08-03 19:52:23 +02:00
INSTALL_NAME_DIR
----------------
2021-09-14 00:13:48 +02:00
Directory name for installed targets on Apple platforms.
2014-08-03 19:52:23 +02:00
2019-11-11 23:01:05 +01:00
``INSTALL_NAME_DIR`` is a string specifying the directory portion of the
2021-09-14 00:13:48 +02:00
"install_name" field of shared libraries on Apple platforms for
installed targets. When not set, the default directory used is determined
2023-05-23 16:38:00 +02:00
by :prop_tgt:`MACOSX_RPATH`. If the :prop_tgt:`BUILD_WITH_INSTALL_NAME_DIR`
property is set, this will be used already in the build tree.
Policies :policy:`CMP0068` and :policy:`CMP0042` are also relevant.
2018-08-09 18:06:22 +02:00
This property is initialized by the value of the variable
:variable:`CMAKE_INSTALL_NAME_DIR` if it is set when a target is
created.
2020-08-30 11:54:41 +02:00
This property supports :manual:`generator expressions <cmake-generator-expressions(7)>`.
2021-09-14 00:13:48 +02:00
In particular, the :genex:`$<INSTALL_PREFIX>` generator expression can be
used to set the directory relative to the install-time prefix.
2023-05-23 16:38:00 +02:00
On platforms that support runtime paths (``RPATH``), refer to the
:prop_tgt:`INSTALL_RPATH` target property.
Under Windows, the :genex:`TARGET_RUNTIME_DLLS` generator expression is related.