SOVERSION

Номер версии ABI целевой библиотеки общего использования.

Для библиотек общего использования VERSION и SOVERSION могут быть использованы для указания версии сборки и версии ABI соответственно. При построении или установке создаются соответствующие символические ссылки, если платформа поддерживает символические ссылки, а компоновщик поддерживает so-имена. Если указан только один из них, то отсутствующий предполагается иметь тот же номер версии. SOVERSION игнорируется, если свойство NO_SONAME установлено.

Обычной практикой является указание и VERSION и SOVERSION, так что SOVERSION соответствует первой компоненте VERSION:

set_target_properties(mylib PROPERTIES VERSION 1.2.3 SOVERSION 1)

Идея в том, что изменения, требующие перекомпиляции ABI, увеличивают и SOVERSION и номер основной версии VERSION.

Версии Windows

Для библиотек общего использования и исполняемых файлов на Windows атрибут VERSION анализируется для извлечения номера версии <major>.<minor>. Эти числа используются как версия образа двоичного файла.

Версии Mach-O

Для библиотек общего использования и исполняемых файлов на системах Mach-O (например, macOS, iOS), свойство SOVERSION соответствует версии совместимости, а VERSION соответствует текущей версии (если не указаны специфичные для Mach-O переопределения, как обсуждается ниже). См. свойство целевого объекта FRAMEWORK для примера.

Для библиотек общего использования, свойства MACHO_COMPATIBILITY_VERSION и MACHO_CURRENT_VERSION могут использоваться для переопределения версии совместимости и текущей версии соответственно. Обратите внимание, что SOVERSION по-прежнему будет использоваться для формирования install_name, и как SOVERSION, так и VERSION могут также повлиять на имена файлов и символических ссылок.

Версии бинарных файлов Mach-O можно проверить с помощью команды otool -L <binary>.