Spec start devel
Написание спека
Файл спека
Файл спека (он же файл спецификации) - файл со сценарием сборки пакета, описанный специальным синтаксисом по которому собирается бинарный пакет.
Данный файл состоит из макросов - специальных команд, начинающихся с %, которые сокращают объем ввода и делают спецификацию легче читаемой и воспринимаемой.
Файл спека состоит из двух частей:
- преамбулы (заголовка) - в которой описываются базовые метаданные;
- текста (тела) - в котором описывается основная часть инструкций;
спецификации
Каждая из этих частей содержит как обязательные, так и опциональные подразделы и элементы.
Автогенерация спека
С помощью утилиты rpmdev-newpec из пакета rpmdevtools можно сгенерировать базовый спек:
$ rpmdev-newspec hello
развернутьПример полученного спека |
---|
Преамбула
В нижеприведенной таблице перечислены элементы, используемые в преамбуле файла спецификации RPM, которые называются директивами или тэгами. В таблице жирным шрифтом выделены обязательные директивы.
Директива | Определение |
---|---|
Name | Базовое имя пакета, которое должно совпадать с именем файла спецификации |
Version | Номер версии программного обеспечения |
Release | Количество раз, когда данная версия программного продукта была собрана. Как правило, при первой сборке конкретной версии пакета значение устанавливается равным 1 и увеличивается на единицу с каждой новой сборкой пакета. После цифры указывают суффикс макросом alt1 |
Epoch | Способ определения взвешенных зависимостей на основе номеров версий. Если директива явно не задана, то значение по умолчанию равно 0. Данный параметр влияет на полную версию пакета при построении зависимостей в базе данных RPM или в репозитории
Полная версия выглядит как Epoch:Version-Release |
Summary | Краткое, однострочное описание пакета |
License | Лицензия на упаковываемое программное обеспечение |
URL | Полный URL (адрес) для получения дополнительной информации о программе. Обычно это веб-сайт проекта для упаковываемого программного обеспечения |
Source[X] | Путь (абсолютный или относительный) или URL-адрес к исходным файлам проекта. Директива может указывать как на сжатые архивы исходных кодов, так и на отдельные файлы. Проект может содержать несколько исходных файлов, тогда для их нумерации вместо [X] указывается цифра, например: Source3. Если имеется только один исходный файл, то нумерацию можно опустить, указав просто Source. |
Patch[X] | Файлы патчей, которые при необходимости будут применены к исходному коду. Проект может содержать несколько патчей, тогда вместо [X] указывают их номер, например: Patch2. Если патч единственный, то номер можно не присваивать (Patch) |
BuildArch | Явное указание архитектуры, под которую собирается двоичный пакет. Если параметр не задан, то пакет автоматически наследует архитектуру машины, на которой он собран. В случае с архитектурно-независимыми пакетами указание данной директивы обязательно: BuildArch: noarch |
ExcludeArch | Если программное обеспечение, для которого собирается двоичный пакет, не может работать на определённой архитектуре процессора, то можно исключить эту архитектуру данной директивой |
BuildRequires | Список пакетов, разделённых запятыми или пробелами либо указанных по одному в строке с данной директивой, необходимых для компиляции/создания программы или формирования пакета |
Requires | Список пакетов, разделённых запятыми или пробелами, необходимых программному обеспечению для запуска после установки. В файле спецификации может быть несколько записей Requires, каждая из которых находится в отдельной строке |
Provides | Указание дополнительных имён, библиотек или иных сущностей, которые предоставляет данный пакет. Используется для создания псевдонимов пакета, которые можно использовать как в тэгах спецификаций при сборке других пакетов, так и для установки пакета через пакетный менеджер |
Obsoletes | Перечисление имён пакетов, которые данный пакет делает устаревшими. При установке данного пакета устаревшие пакеты будут автоматически удалены из системы пакетным менеджером |
Confilcts | Перечисление имён пакетов, с которыми конфликтует данный пакет, т.е. все эти пакеты не могут быть одновременно установлены в системе |
Например:
Name: openssl Version: 1.0.2 Release: alt3
Завершается преамбула обязательным блоком описания назначения пакета, идущим после тэга %description, в котором, в отличие от директивы Summary, даётся развёрнутая информация о пакете. Описание может занимать любое количество строк и быть разбито на абзацы по желанию автора спецификации. Важно!
В таком случае один проект будет представлен несколькими двоичными RPM-файлами. Заголовки других пакетов в подобной спецификации должны начинаться с макроса %package <ИМЯ_ПАКЕТА>, причём имя другого пакета тэгом Name задавать не нужно — оно будет сформировано из опций указанного макроса. Также можно не указывать версию и релиз, если они совпадают (или должны совпадать по задумке автора спецификации) со значениями таковых же директив всего проекта. Например:
Name: superproj Version: 1.0 Release: alt1 Summary: Super Project ... %description This is the Super Project from our Company for all people. %package devel Summary: Development files for Super Project ... %descrtiption devel This package contains libraries and header files for development with Super Project. ...
В результате успешного завершения сборки согласно данной спецификации будут получены два пакета, например (для архитектуры x86_64):
superproj-1.0-1.alt1.x86_64.rpm и superproj-devel-1.0-1.alt1.x86_64.rpm
Тело спецификации
В таблице ниже перечислены основные блоки, используемые в тексте (теле) спецификации, причём все они, кроме %check, являются обязательными.
Важно заметить, что сколько бы двоичных пакетов не было описано в спецификации, все ниже приведённые директивы, кроме %files, фигурируют в тексте только один раз — разделение на разные двоичные RPM происходит именно в блоках %files согласно преамбуле.
Блоки | Определение |
---|---|
%prep | Команды для подготовки программного обеспечения к сборке, например, распаковка архива, указанного в Source или Source0. |
%build | Команды для фактической сборки программного обеспечения в машинный код (для компилируемых языков) или байт-код (для некоторых интерпретируемых языков) |
%install | Команды установки/копирования файлов из сборочного каталога в псевдо-корневую директорию |
%check | Команды для тестирования программного обеспечения. Данный блок обычно включают в себя модульные тесты |
%files | Список файлов для каждого двоичного пакета (если их создаётся несколько по одной спецификации), которые будут установлены в системе конечного пользователя |
%changelog | Список изменений, произошедших в пакете между сборками разных версий или релизов |
Командами внутри блоков могут быть как макросы сборочной системы RPM, так и вызовы внешних приложений, включая сценарии оболочки.
Если при сборке какого-либо пакета нет необходимости в каком-то блоке, всё равно его название необходимо указать в спецификации. Например, упаковывается тема пиктограмм и компилировать просто нечего при сборке двоичного пакета, то в спецификации такого пакета блок %build будет пустым.
Основные макросы
Как посмотреть значение макросов в сборочнице
Перейдите в каталог, где у вас сборка. Выполните:
$ hsh-shell
Выполните команду rpm --showrc с фильтром, где в фильтре будет указан нужный макрос:
$ rpm --showrc | grep _libdir
развернутьПример вывода |
---|
Четвертая строка --> -14: _prefix /usr.
Пути системных каталогов
Макрос | Определение |
---|---|
%_sysconfdir
|
/etc
|
%_lib
|
lib64 (для 64-битных платформ)lib (для 32-битных платформ)
|
%_prefix
|
/usr
|
%_includedir
|
%_prefix/include = /usr/include
|
%_bindir
|
%_prefix/bin = /usr/bin
|
%_libdir
|
%_prefix/%_lib = /usr/%_lib
|
%_libexecdir
|
%_prefix/lib = /usr/lib
|
%_sbindir
|
%_prefix/sbin = /usr/sbin
|
%_datadir
|
%_prefix/share = /usr/share
|
%_infodir
|
%_datadir/info = /usr/share/info
|
%_mandir
|
%_datadir/man = /usr/share/man
|
%_docdir
|
%_datadir/doc = /usr/share/doc
|
%_rundir
|
/run
|
%_localstatedir
|
/var/lib
|
%_sharedstatedir
|
/var/lib
|
Пути каталогов сборочного окружения
Макрос | Определение |
---|---|
%_tmppath
|
/usr/src/tmp
|
%_topdir
|
/usr/src/RPM
|
%_buildrootdir
|
%_tmppath
|
%_builddir
|
%_topdir/BUILD
|
%_rpmdir
|
%_topdir/RPMS
|
%_sourcedir
|
%_topdir/SOURCES
|
%_specdir
|
%_topdir/SPECS
|
%_srcrpmdir
|
%_topdir/SRPMS
|
Связь директив преамбулы и некоторых макросов
Директива | Соответствующий макрос |
---|---|
Name
|
%name
|
Version
|
%version
|
Release
|
%release
|
Epoch
|
%epoch
|
URL
|
%url
|
SourceX
|
%SOURCEX
|
Встроенные макросы RPM
Блок | Макрос | Назначение и описание |
---|---|---|
%prep | %setup
|
Используется в блоке %prep .
Выполняет:
Ключ |
%patch[X]
|
Используется в блоке %prep для применения патча под номером X, как в директиве PatchX . Поддерживает ключ -p (обрезка пути).
| |
%build | %configure
|
Используется в блоке %build для вызова скрипта configure с предустановленными значениями переменных. Принимает любые аргументы.
|
%make_build
|
Используется в блоке %build для вызова make с макросами %_smp_mflags и %make_bin
| |
%install | %make_install
|
Используется в блоке %install для установки: вызывает make install с указанием DESTDIR=%{buildroot} . Принимает дополнительные аргументы.
|
%files | %dir
|
Применяется в блоке %files для указания, что объект — каталог, который должен быть включён в RPM.
|
%doc
|
Используется в блоке %files для копирования файлов документации в %_docdir/%name-%version . Пути задаются относительно сборочного каталога.
| |
%license
|
Аналог %doc , но используется для лицензий. Файлы копируются в специальный каталог лицензий.
|