mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-05 13:20:47 -06:00
14732d3f30
The properties added by commit 4a62e3d97c (macOS: Add
OSX_COMPATIBILITY_VERSION and OSX_CURRENT_VERSION properties,
2020-01-24, v3.17.0-rc1~80^2~1) are general-purpose for all platforms
using Mach-O formats and not just on OS X. Rename them accordingly.
The properties are new to the CMake 3.17 release so we can rename
them without compatibility concerns.
Fixes: #20442
30 lines
1.2 KiB
ReStructuredText
30 lines
1.2 KiB
ReStructuredText
SOVERSION
|
|
---------
|
|
|
|
What version number is this target.
|
|
|
|
For shared libraries :prop_tgt:`VERSION` and ``SOVERSION`` can be used to
|
|
specify the build version and API version respectively. When building or
|
|
installing appropriate symlinks are created if the platform supports
|
|
symlinks and the linker supports so-names. If only one of both is
|
|
specified the missing is assumed to have the same version number.
|
|
``SOVERSION`` is ignored if :prop_tgt:`NO_SONAME` property is set.
|
|
|
|
Windows Versions
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
For shared libraries and executables on Windows the :prop_tgt:`VERSION`
|
|
attribute is parsed to extract a ``<major>.<minor>`` version number.
|
|
These numbers are used as the image version of the binary.
|
|
|
|
Mach-O Versions
|
|
^^^^^^^^^^^^^^^
|
|
|
|
For shared libraries and executables on Mach-O systems (e.g. macOS, iOS),
|
|
the ``SOVERSION`` property is a fallback to
|
|
:prop_tgt:`MACHO_COMPATIBILITY_VERSION` property which corresponds to
|
|
*compatiblity version* and :prop_tgt:`VERSION` is a fallback to
|
|
:prop_tgt:`MACHO_CURRENT_VERSION` which corresponds to *current version*.
|
|
See the :prop_tgt:`FRAMEWORK` target property for an example. Versions
|
|
of Mach-O binaries may be checked with the ``otool -L <binary>`` command.
|