Soname: различия между версиями
Нет описания правки |
|||
(не показаны 3 промежуточные версии 3 участников) | |||
Строка 1: | Строка 1: | ||
[[Category:Devel]] | [[Category:Devel]] | ||
{{Stub}} | {{Stub}} | ||
=== Создание библиотеки с soname === | === Создание библиотеки с soname === | ||
Правильная библиотека имеет название типа libfoo.so.x.y.z, а на неё сделаны ссылки libfoo.so.x и libfoo.so. Причём сама библиотека и ссылка libfoo.so.x пакуется в пакет libfoo, а libfoo.so, нужная обычно только для | Правильная библиотека имеет название типа 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
Создание библиотеки с 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 и первую цифру. Это позволит в переходный период сохранить работоспособность старых приложений.
Ссылки
- Более подробно сказано здесь: http://www.gnu.org/software/libtool/manual/libtool.html#Versioning
- Семантическое версионирование
- API or ABI changing