mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-22 06:31:29 -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
32 lines
1.3 KiB
ReStructuredText
32 lines
1.3 KiB
ReStructuredText
VERSION
|
|
-------
|
|
|
|
What version number is this target.
|
|
|
|
For shared libraries ``VERSION`` and :prop_tgt:`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. For
|
|
executables ``VERSION`` can be used to specify the build version. When
|
|
building or installing appropriate symlinks are created if the
|
|
platform supports symlinks.
|
|
|
|
Windows Versions
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
For shared libraries and executables on Windows the ``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 ``VERSION`` property is a fallback to :prop_tgt:`MACHO_CURRENT_VERSION`
|
|
property which corresponds to *current version* and :prop_tgt:`SOVERSION`
|
|
is a fallback to :prop_tgt:`MACHO_COMPATIBILITY_VERSION` which corresponds
|
|
to *compatiblity 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.
|