Kitware/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-22 16:07:49 +08:00
Code Issues Projects Releases Wiki Activity

Help: Clarify TARGET_RUNTIME_DLLS behavior on imported targets

Browse Source 
This generator expression does not report the locations of `.dll`
files on imported targets with the `UNKNWON` type, since their
`IMPORTED_LOCATION` refers to the import library and not the DLL.

Fixes: #22845
This commit is contained in:
Brad King
2021-11-03 15:51:35 -04:00
parent f65cebf51a
commit 001870d451
2 changed files with 14 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
Help/command/add_library.rst
View File

@@ -166,6 +166,8 @@ itself and is not included as a target in the generated buildsystem.
call are ``PRIVATE`` to the interface library and do not appear in its call are ``PRIVATE`` to the interface library and do not appear in its
:prop_tgt:`INTERFACE_SOURCES` target property. :prop_tgt:`INTERFACE_SOURCES` target property.
.. _`add_library imported libraries`:
Imported Libraries Imported Libraries
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
@@ -205,7 +207,8 @@ The ``<type>`` must be one of:
:prop_tgt:`IMPORTED_IMPLIB_<CONFIG>`) specifies the location of the :prop_tgt:`IMPORTED_IMPLIB_<CONFIG>`) specifies the location of the
DLL import library file (``.lib`` or ``.dll.a``) on disk, and the DLL import library file (``.lib`` or ``.dll.a``) on disk, and the
``IMPORTED_LOCATION`` is the location of the ``.dll`` runtime ``IMPORTED_LOCATION`` is the location of the ``.dll`` runtime
library (and is optional). library (and is optional, but needed by the :genex:`TARGET_RUNTIME_DLLS`
generator expression).
Additional usage requirements may be specified in ``INTERFACE_*`` properties. Additional usage requirements may be specified in ``INTERFACE_*`` properties.

11
Help/manual/cmake-generator-expressions.7.rst
View File

@@ -1068,7 +1068,7 @@ which is just the string ``tgt``.
.. code-block:: cmake .. code-block:: cmake
find_package(foo REQUIRED) find_package(foo CONFIG REQUIRED) # package generated by install(EXPORT)
add_executable(exe main.c) add_executable(exe main.c)
target_link_libraries(exe PRIVATE foo::foo foo::bar) target_link_libraries(exe PRIVATE foo::foo foo::bar)
@@ -1077,6 +1077,15 @@ which is just the string ``tgt``.
COMMAND_EXPAND_LISTS COMMAND_EXPAND_LISTS
) )
.. note::
:ref:`Imported Targets` are supported only if they know the location
of their ``.dll`` files. An imported ``SHARED`` or ``MODULE`` library
must have :prop_tgt:`IMPORTED_LOCATION` set to its ``.dll`` file. See
the :ref:`add_library imported libraries <add_library imported libraries>`
section for details. Many :ref:`Find Modules` produce imported targets
with the ``UNKNOWN`` type and therefore will be ignored.
.. genex:: $<INSTALL_PREFIX> .. genex:: $<INSTALL_PREFIX>
Content of the install prefix when the target is exported via Content of the install prefix when the target is exported via