https://github.com/Kitware/CMake
Raw File
Tip revision: 22612dd53a46c7f9b4c3f4b7dbe5c78f9afd9581 authored by Brad King on 15 March 2021, 13:39:14 UTC
CMake 3.19.7
Tip revision: 22612dd
CMP0063.rst
CMP0063
-------

.. versionadded:: 3.3

Honor visibility properties for all target types.

The :prop_tgt:`<LANG>_VISIBILITY_PRESET` and
:prop_tgt:`VISIBILITY_INLINES_HIDDEN` target properties affect visibility
of symbols during dynamic linking.  When first introduced these properties
affected compilation of sources only in shared libraries, module libraries,
and executables with the :prop_tgt:`ENABLE_EXPORTS` property set.  This
was sufficient for the basic use cases of shared libraries and executables
with plugins.  However, some sources may be compiled as part of static
libraries or object libraries and then linked into a shared library later.
CMake 3.3 and above prefer to honor these properties for sources compiled
in all target types.  This policy preserves compatibility for projects
expecting the properties to work only for some target types.

The ``OLD`` behavior for this policy is to ignore the visibility properties
for static libraries, object libraries, and executables without exports.
The ``NEW`` behavior for this policy is to honor the visibility properties
for all target types.

This policy was introduced in CMake version 3.3.  CMake version
|release| warns when the policy is not set and uses ``OLD`` behavior.  Use
the :command:`cmake_policy()` command to set it to ``OLD`` or ``NEW``
explicitly.

.. include:: DEPRECATED.txt
back to top