Руководство по упаковке 1: banner

Version содержит номер версии упаковываемого программного обеспечения.

Release numbers specfile updates, package rebuilds and other work within Fedora. The value used here, %autorelease, is part of rpmautospec, which is recommended for Fedora packages. It ties Release to package’s Git history. As we do not have a Git repository, %autorelease will evaluate to the default value of 1.

Часто Summary можно скопировать из README вышестоящего проекта. Первая буква должна быть заглавной, чтобы избежать предупреждений rpmlint.

License описывает лицензию результирующего двоичного пакета с использованием идентификатора лицензии SPDX. Он должен соответствовать рекомендациям по лицензированию Fedora. На практике определение правильного значения часто означает проверку уведомлений о лицензии в отдельных файлах исходного кода. Может также потребоваться запросить у разработчиков вышестоящего проекта разъяснения или исправления. В этом руководстве мы просто полагаемся на слово вышестоящего проекта о том, что лицензия — это GNU Public License, версия 2.

URL указывает на веб-сайт вышестоящего проекта, которым в данном случае является страница репозитория на GitHub.

Source определяет исходные коды вышестоящего проекта, используемые при сборке пакета. Обычно, как и в данном случае, это URL-адрес, указывающий на тарболл, выпущенный вышестоящим проектом, но это также может быть локальный файл. При необходимости может быть несколько тегов Source.

%description часто можно скопировать из README вышестоящего проекта.

%prep содержит скрипт оболочки для подготовки исходных кодов к сборке. Часто это просто один макрос %autosetup, который в данном случае просто извлекает исходные коды.

%build содержит скрипт оболочки для необходимых шагов сборки, таких как компиляция исходных кодов в двоичные файлы. Поскольку система сборки banner — это Autotools, её сборка включает запуск configure и make. Макросы %configure и %make_build вызывают эти команды с использованием флагов компиляции Fedora и других настроек.

%install содержит скрипт оболочки для копирования результатов из %build в изначально пустой каталог корня сборки. Поскольку banner использует Autotools, используется макрос %make_install.

%files перечисляет содержимое результирующего пакета. В основном файлы берутся из корня сборки, созданного в %install, но файлы документации и лицензии также могут быть добавлены непосредственно из исходных кодов. Этот раздел пока оставлен пустым, для заполнения позже.

%changelog документирует изменения в каждой новой версии и выпуске пакета. Данные журнала изменений можно отобразить с помощью rpm --query --changelog PACKAGE_NAME, что может быть полезно, например, для выяснения, включены ли конкретные исправления ошибок и безопасности. Его значение, %autochangelog, также поступает из rpmautospec. Он заполняет журнал изменений из сообщений коммитов Git. Поскольку у нас нет Git-репозитория, журнал изменений будет пустым.

Ненужные строки можно закомментировать с помощью символа #.

Дополнительную информацию можно найти в разделе Справочного руководства по RPM Формат spec-файла.

Это исполняемая двоичная программа. Для /usr/bin, как и для многих других системных каталогов, определён стандартный RPM-макрос. Макросы всегда следует использовать, когда они доступны, поэтому исполняемый файл указывается в %files следующим образом:

В Рекомендациях по упаковке есть отдельный раздел для Man-страниц. Следуя его инструкциям, man-страницы указываются следующим образом:

На этом этапе mockbuild завершается успешно, но есть ещё файлы, которые мы должны добавить в пакет.

Каждый пакет должен устанавливать свою лицензию, помеченную директивой %license. В случае с banner, как и для многих других проектов, файл лицензии находится на верхнем уровне исходного тарболла и, возможно, вообще не копируется в корень сборки во время установки. Тем не менее, его можно установить в стандартный каталог лицензий, используя относительный путь:

Часто исходные коды пакета содержат документацию, которая может быть полезна и конечным пользователям. Эти файлы можно установить и пометить как документацию с помощью директивы %doc. Аналогично %license, можно использовать относительные пути для включения файлов непосредственно из исходного тарболла, а не из корня сборки:

Выведите список файлов, содержащихся в пакете:

Вы можете видеть, что все файлы, перечисленные в разделе %files spec-файла, включены. Кроме того, в /usr/lib/.build-id находится автоматически сгенерированный файл. На самом деле это символическая ссылка, сопоставляющая идентификатор сборки с двоичным файлом banner для целей отладки.

Выведите список зависимостей пакета во время выполнения с помощью следующей команды:

Чтобы проверить, какие пакеты в репозиториях Fedora предоставляют эти зависимости, вы можете использовать dnf repoquery:

Вы увидите, что единственной зависимостью banner является glibc, который предоставляет символы в libc.so.6, а также rtld(GNU_HASH).

Зависимости rpmlib являются особыми. Они определяют различные функции rpm, используемые в самом rpm-пакете, ограничивая версию rpm, которая может быть использована для установки пакета.

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

Предоставляемые возможности этого пакета очень просты. Он просто предоставляет своё собственное имя в обычной и архитектурно-специфичной формах.

В качестве финальной проверки пакет можно установить и запустить:

Чтобы очистить систему, отмените установку: