ОсобенностиСборкиПакетов

Особенности сборки пакетов

По результатам переписки разработчиков ALT Linux Team составлены советы по упаковке программ GTK, GNOME и KDE. Они должны войти в книжку «ALT Linux Team и проект Sysiphus» проекта alt-docs.

Использование альтернатив

• http://alternatives.sourceforge.net/

Создаём файл с описанием предоставляемой альтернативы такого вида:

# имя альтернативы     # один из вариантов альтернативы  # вес
/usr/bin/%альтернатива /usr/bin/%вариант                 40

и складываем его в /etc/alternatives/packages.d/%пакет.alternatives при сборке.

Поля в файле разделяются символом табуляции. Число в файле — вес альтернативы. Альтернатива с бОльшим весом будет выбрана, если не выбрано ручное управление альтернативами. Если в пакете содержится больше одного файла под управлением альтернатив, то %пакет.alternatives может содержать несколько строк.

Не забываем добавить файл в пакет:

%files
%_altdir/%пакет.alternatives

pkg-config

Почему в pkg-config отключена рекурсия (особенность сборки в ALT). Рекурсивный сбор --libs в принципе не нужен, более того — вреден, хотя бы потому что является источником огромного числа лишних зависимостей, которые потом должен обрабатывать apt и rpm.

Если программа не линкуется с какой-либо библиотекой, то весьма вероятно, что это ошибка в сборке библиотеки — библиотека использует функции из других библиотек, но с ними не слинкована. Ошибка эта практически везде, кроме как в ALT Linux прикрыта стандартным поведением pkg-config.

В качестве заглушки можно вписать

export ac_cv_path_PKG_CONFIG="%_bindir/pkg-config --recursive"

перед %configure, но лучше добиться исправления проблемной библиотеки (приложения). Пример исправления можно увидеть в спеке к libgtkmm2

MIME-типы

Файлы информации о MIME-типах. В этих файлах хранится описание форматов файлов (их mime-type, комментарием, способом определения принадлежности к формату по MAGIC value и шаблону…) См. подробнее http://www.freedesktop.org/Standards/shared-mime-info-spec http://www.freedesktop.org/Software/shared-mime-info

1. Если в пакете есть файлы /usr/share/mime/packages/*.xml, то при их установке, удалении, обновлении кэш базы mime-типов обновляется автоматически (файл-триггер в пакете shared-mime-info).

2. Файлы из каталога %_datadir/mime-info/* не используется GNOME-программами, которые получают mime-информацию из пакета shared-mime-info.

Тем не менее эти файлы используются рядом других программ (например, KDE), так что их тоже надо паковать. При этом пакет не получает никаких дополнительных зависимостей.

3. Для KDE определения типа файла задаётся в /usr/share/mimelnk/, например:

$ cat /usr/share/mimelnk/application/x-kompas.desktop
[Desktop Entry]
Encoding=UTF-8
Type=MimeType
MimeType=application/x-kompas
Icon=wine-kviewer
Patterns=*.a3d;*.m3d;*.cdw;*.spw;*.A3D;*.M3D;*.CDW;*.SPW
Comment=KOMPAS Comment[ru]=Файлы КОМПАС

Файлы schemas

При сборке в пакете установку schemas надо отключать:

%configure --disable-schemas-install

так как эта процедура должна быть выполнена при установке пакета; под пользователем при сборке пакета это невозможно.

это рекомендуется вместо конструкции

export GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1
%makeinstall

unset GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL

при установке.

В спеке должны быть секции:

%post
%gconf2_install %name

%preun
if [ $1 = 0 ]; then
  %gconf2_uninstall %name
fi

в качестве параметров к %gconf2-unstall/%gconf2-uninstall может быть указано несколько названий.

Образец оформления секции %files:

%config %_sysconfdir/gconf/schemas/*

В зависимостях пакета должно быть:

BuildRequires(Pre): libGConf-devel

(макросы %gconf2.* содержатся пакете libGConf-devel)

Файлы scrollkeeper

Нельзя упаковывать каталог и файлы из %_localstatedir/scrollkeeper, если они получаются при сборке, их надо удалить командой

rm -rf %buildroot%_localstatedir/scrollkeeper

в конце секции %install

Если %make_install вызывает scrollkeeper-update и сборка прерывается по ошибке — перед %make_install нужно сделать export OMF_DIR=%buildroot%_localstatedir/scrollkeeper

Файлы локализации

%find_lang вызывается в секции %install

Для программ GNOME указывается:

%find_lang --with-gnome %name

При этом find-lang кроме файлов переводов в %_datadir/locale ищет файлы справки Гном в %_datadir/gnome/help и .omf файлы в %_datadir/omf

Поэтому не нужно указывать в секции %files каталоги с locale (переводами), а также

%_datadir/omf/%name
%_datadir/gnome/help/

Для программ KDE указывается:

%find_lang --with-kde %name

При этом find-lang ищет файлы справки KDE в %_defaultdocdir/HTML

Далее секция %files оформляется следующим образом:

%files -f %name.lang

%find_lang, являющийся скриптом, имеет и другие параметры, делающие его более гибким.

Файлы меню

После перемещения в alt-docs необходимо совместить данный раздел с файлом ftp://ftp.altlinux.org/pub/people/zerg/menu/menu-packaging-howto-current.txt

Файл меню либо создаётся непосредственно заданием его содержимого, либо формируется. Перевод строк, содержащихся в меню, содержится в пакете menu. Формат файла меню частично описан здесь). На основе файла меню, устанавливающегося в /usr/lib/menu, генерируются меню для всех оконных менеджеров, установленных в системе.

Пример того, как обычно в спеке создают файл меню:

mkdir -p %buildroot%_menudir
cat << EOF > %buildroot%_menudir/%name
?package(%name):command="%name" \
needs="x11" \
section="Applications/Communications" \
title="wxDialer" \
longtitle="A phone dialer written in wxPython" \
genericname="Phone dialer" \
icon="%name.png"
EOF

Если есть файл в /usr/share/applications, то menu-файл для этого пункта не нужен.

Устарело: РЕКОМЕНДУЕМЫЙ СПОСОБ: Как правило к программе прилагается файл .desktop, который уже содержит эту информацию, из него можно получить файл меню с помощью скрипта freedesktop2menu.pl (планируется макрос %freedesktop2menu — см. bug#7972). Добавьте следующие строки в раздел %install:

%Md2m %name "Applications/Communications" \
    %buildroot%_desktopdir/%name.desktop \
    %buildroot%_menudir/%name

Это обязательно использовать, если вы хотите, чтобы работало связывания файла с обрабатывающим его приложением

При использовании этого скрипта в пакете должна быть указана зависимость:

BuildPreReq: menu-devel

Каталог для файлов меню обычно создают командой:

mkdir -p %buildroot%_menudir

Созданный файл меню устанавливается в каталог %_menudir. При установке или удалении пакета меню переформируется самостоятельно, с помощью файл-триггера в пакете menu.

В секции %files:

%_menudir/*
%_desktopdir/*
и возможно
%_datadir/application-registry/*

Пережиток KDE-шного прошлого %_datadir/applnk тоже надо паковать, если имеется. При этом не появляется дополнительных зависимостей.

Сейчас *.desktop и menu-файлы существуют параллельно. %_menudir обязательно, а %_desktopdir/*.desktop — нет. Когда-нибудь в далеком будущем бОльшая часть оконных менеджеров будет уметь самостоятельно читать %_desktopdir. Тогда пакет menu станет не нужен.

Статичный вариант меню хранится в %_desktopdir, а генерируемый из menu-файлов в — %_datadir/application-alt

KDE не особо при чем, %_desktopdir и %_menudir — это общее для всех.

После сборки нового пакета и его установке обязательно проверяйте, что программа появилась в меню на своём месте и имеет нужную пиктограмму.

Обновление базы обрабатываемых форматов

В файлах desktop кроме названия программы, способа её запуска и комментария, обычно также указаны сведения о том, какие форматы способна обрабатывать та или иная программа.

Подробнее см. http://www.freedesktop.org/Standards/desktop-entry-spec

Нижеописанное нужно только в случае если в %_desktopdir/*.desktop есть

$ grep -i mime /usr/share/applications/*.desktop
MimeType=.....;

В спеке должны быть секции:

%post
%update_desktopdb

%postun
%clean_desktopdb

В пакете должна быть указана зависимость:

Requires(post,postun): desktop-file-utils
BuildPreReq: desktop-file-utils

Используется вне зависимости от типа программы в пакете, и всегда должно быть указано.

Файлы bonobo

Пока ничего не знаю кроме того, что в %files пишется %_libdir/bonobo/servers/*

Статические библиотеки

Общей тенденцией является условная упаковка статических библиотек. Упаковываются они в пакет с суффиксом -devel-static. Как правило, статические библиотеки не требуются, и поэтому в начале спеке ставится

%def_disable static

При конфигурировании указывается

%configure %{subst_enable static}

которое управляет сборкой статических библиотек.

При указании пакетов на упаковку

%if_enabled static
%files -n lib%name-devel-static
%_libdir/lib%name.a
%endif

Тогда чтобы получить lib%name-devel-static, нужно пересобрать пакет с `--enable static'. Установка lib%name-devel-static автоматически ставит на hold lib%name-devel и, следовательно, lib%name (если между пакетами правильные зависимости).

Исключение: Если в пакете собирается только статическая библиотека, без динамической, то пакет должен называться -devel. devel@

Установка файлов

В секции %install для установки файлов используется несколько способов

1.

%make_install install DESTDIR=%buildroot

(в случае если используется схема Makefile с DESTDIR)

2.

%makeinstall

(она задаёт prefix и остальные пути по типу prefix=/home/lav/tmp/%{name}-buildroot/usr)

Это для программ, которые не пытаются запоминать пути, куда их устанавливают, при установке, а делают это при configure.

3. Иной способ. Возможно, ручная установка с помощью install

Дополнительно

Будьте внимательны при написании скриптов pre/post и прочих — используемые там пакеты должны быть прописаны в Requires их зависимости тоже проставляются в результирующий пакет. Желательно не использовать перенаправление вывода в /dev/null.

Примеры использования

Смотрите в Сизифе пакеты ggv2, rythmbox, eog2, gthumb, totem, conglomerate, inkscape

Авторы

Yuri N. Sedunov <aris@altlinux.ru>, 2004 Vitaly Lipatov <lav@altlinux.ru>, 2004—2005 Sergey Turchin <zerg@altlinux.ru>, 2004—2005 Alexey Tourbin <at@altlinux.ru>, 2005

09.11.2004, 21.01.2005