Soname: различия между версиями

Материал из ALT Linux Wiki
Нет описания правки
 
(не показаны 3 промежуточные версии 3 участников)
Строка 1: Строка 1:
[[Category:Devel]]
[[Category:Devel]]
{{Викифицировать}}
{{Stub}}
{{Stub}}
{{MovedFromFreesourceInfo|AltLinux/Sisyphus/devel/soname}}
 


=== Создание библиотеки с soname ===
=== Создание библиотеки с soname ===


Правильная библиотека имеет название типа libfoo.so.x.y.z, а на неё сделаны ссылки libfoo.so.x и libfoo.so. Причём сама библиотека и ссылка libfoo.so.x пакуется в пакет libfoo, а libfoo.so, нужная обычно только для линовки, вместе с заголовками для компиляции пакуется в в libfoo-devel.
Правильная библиотека имеет название типа libfoo.so.x.y.z, а на неё сделаны ссылки libfoo.so.x и libfoo.so. Причём сама библиотека и ссылка libfoo.so.x пакуется в пакет libfoo, а libfoo.so, нужная обычно только для линковки, вместе с заголовками для компиляции пакуется в в libfoo-devel.


Обычно версия библиотеки задаётся в LDFLAGS при линковке библиотеки примерно так:
Обычно версия библиотеки задаётся в LDFLAGS при линковке библиотеки примерно так:
Строка 30: Строка 29:
сохранить работоспособность старых приложений.
сохранить работоспособность старых приложений.


Более подробно сказано здесь:
=== Ссылки ===
[http://www.gnu.org/software/libtool/manual.html#Versioning http://www.gnu.org/software/libtool/manual.html#Versioning]
* Более подробно сказано здесь: [http://www.gnu.org/software/libtool/manual/libtool.html#Versioning http://www.gnu.org/software/libtool/manual/libtool.html#Versioning]
* [https://semver.org/lang/ru/ Семантическое версионирование]
* [[API or ABI changing]]

Текущая версия от 20:29, 14 декабря 2017

Stub.png
Данная страница находится в разработке.
Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.


Создание библиотеки с soname

Правильная библиотека имеет название типа libfoo.so.x.y.z, а на неё сделаны ссылки libfoo.so.x и libfoo.so. Причём сама библиотека и ссылка libfoo.so.x пакуется в пакет libfoo, а libfoo.so, нужная обычно только для линковки, вместе с заголовками для компиляции пакуется в в libfoo-devel.

Обычно версия библиотеки задаётся в LDFLAGS при линковке библиотеки примерно так: -Wl,-soname,libfoo.so.1

Где libfoo.so.1 - это т.н. soname библиотеки. Сам .so файл библиотеки при этом должен иметь имя типа libfoo.so.1.0.0 или даже libfoo.so.1.0 Обратите внимание, что первая цифра после .so совпадает с цифрой после soname.

Таким образом, библиотека libfoo.so.1.0 имеет soname libfoo.so.1 Также надо создать ссылки libfoo.so.1 -> libfoo.so.1.0 и libfoo.so -> libfoo.so.1.0

Теперь о дальнейшем развитии библиотеки.

Если в новом релизе добавилась в библиотеку какая-то функциональность, не меняя старой (обратная совместимость по API), то надо прибавлять вторую или третью цифру.

А если изменения в новой библиотеке затронули старые API/ABI, то надо менять soname и первую цифру. Это позволит в переходный период сохранить работоспособность старых приложений.

Ссылки