Просмотр кода страницы Краткое руководство по сборке пакета

[[category:devel]]
{{Stub}}

Данное руководство поможет вам самостоятельно создать свой RPM-пакет в дистрибутивах ALT Linux.
Больше информациx о тонкостях сборки пакетов и их сопровождению вы можете найти в разделах [[:Категория:Руководства|Руководства]] и [[:Категория:Справочники|Справочники]].

== Подготовка к сборке пакета ==

Помимо желания собрать пакет вам необходимы:
* Исходный код программы или библиотеки
* Доступ к репозиторию
* Сборочная среда

=== Исходный код ===

Исходный код для пакета вы можете скачать из Интернета. Предположим, вы скачали архив с исходным кодом '''foo-1.2.3.tar.gz'''

=== Доступ к репозиторию ===

Вам также потребуется доступ к репозиторию (для сборки необходимы зависимые пакеты). Идеальный вариант — [[Mirror|копия Sisyphus]] или необходимого [[Branches|бранча]]. Однако можно использовать и удалённый репозиторий. Организация доступа к репозиторию будет рассмотрена ниже.

=== Сборочная среда ===

: Подробнее: [[Join/Environment]]

1. Установите программы для сборки пакетов:

 apt-get install rpm-build gear
Возможно, понадобятся: hasher, rpm-build-licenses и rpm-utils

2. Подготовьте место на жёстком диске. Минимум 2 Гб. Крайне рекомендуется производить сборку на файловой системе [[tmpfs]] — скорость сборки может вырасти в несколько раз!  Для использования этого варианта начинайте с <tt>size=2300m</tt>.

3. Настройте rpm:

Создайте в домашнем каталоге файл '''.rpmmacros''' (обязательна точка в начале) примерно такого содержания:

 %_packager Vassily Poupkine <pupkin@altlinux.org>

В этом файле также можно указать ключи подписи пакетов (если вы собираетесь выкладывать пакеты в репозитории), макросы сборки и прочие полезные параметры.

== Репозиторий Gear ==

Подготовьте репозиторий [[gear]] (являющийся частным случаем [[git]]-репозитория). Это необходимое условие для правки уже существующих пакетов и просто удобный инструмент для хранения ваших изменений:

=== Новый пакет ===

Если вы создаёте новый пакет «с нуля», выполните следующие команды для подготовки git-репозитория:

 mkdir foo
 cd foo
 git init

В директории foo, в поддиректории <tt>.gear</tt> создайте файл <tt>.gear/rules</tt> со следующим содержимым:

 tar.gz: foo

Распакуйте архив с исходным кодом:

 gear-update -c /path/to/foo-1.2.3.tar.gz foo

Напишите .spec-файл (''спек''). Спек-файл — текстовый файл с набором инструкций по сборке пакета RPM.

==== [[SpecTips|Документация по написанию спека]] ====

* [[Spec|Краткое руководство по написанию спека]]
* [[SampleSpecs|Примеры спеков]].

=== Существующий пакет ===

Для изменения существующего пакета необходимо получить его исходный код. Исходный код находится в одном из двух мест:

* в gear-репозитории майнтайнера на [[git.alt]], если майнтайнер пользуется gear
* в архиве репозиториев сизифа, если майнтайнер gear не пользуется.

==== gear-репозиторий майнтайнера ====

Найдите на [http://packages.altlinux.org/ru packages.altlinux.org] интересующий вас пакет и посмотрите на репозитории на вкладке Gear. Их может быть больше одного, если над пакетом работает несколько человек. При отсутствии информации о том, кто сейчас ведёт разработку пакета, стоит взять репозиторий того, кто собирал его в последний раз. URL для клонирования репозитория указан в web-интерфейсе. К примеру, для keyjnote:

 git clone git://git.altlinux.org/people/dottedmag/packages/keyjnote.git

[https://www.altlinux.org/Сборка_пакета_с_РЕАЛЬНОГО_НУЛЯ Как правильно собирать пакет, исходники которого лежат во внешнем git]

==== Архив репозиториев сизифа ====

Если gear-репозитория у майнтайнера нет, то придётся воспользоваться архивом Sisyphus. Для этого в браузере откройте <tt>http://git.altlinux.org/archive/</tt> и найдите нужный вам пакет (к примеру, пакет kmymoney2 располагается в http://git.altlinux.org/archive/k/kmymoney2.git). URL для клонирования пакета указан в web-интерфейсе репозитория. Скажем, для kmymoney2:

 git clone git://git.altlinux.org/archive/k/kmymoney2.git

== Обновление исходного кода ==

Обновите исходный код из скачанного архива (команда выполняется в gear-репозитории):

 gear-update /path/to/kmymoney2-0.9.2.tar.bz2 kmymoney2

Обновите версию и changelog в .spec-файле (вручную, в разделе <tt>%changelog</tt> или с помощью утилиты <tt>add_changelog</tt>).

== Фиксирование изменений ==

Чтобы зафиксировать все ваши изменения, выполните:

 gear-commit -a

Появится окно редактора (по умолчанию — vi, вызываемый редактор определяется переменной окружения EDITOR, многие начинающие предпочитают export EDITOR=mcedit) с версией и текстом последней записи changelog. Если нужно, поправьте текст, сохраните изменения и выйдите из редактора. Строки, начинающиеся с символа <tt>#</tt>, будут проигнорированы. Если выйти без сохранения, то изменения зафиксированы не будут.

{{Note|Changlelog вносится через редактор Vim. Чтобы в Vim сохранить изменения и выйти нужно ввести ''':wq''' и нажать Enter}}

== Сборка ==

И, наконец, сборка!

 gear-hsh $TMP/

Среда сборки попытается собрать пакет в изолированной среде [[hasher]]. Если в процессе сборки возникнут ошибки — исправьте их и обязательно зафиксируйте изменения. В случае удачной сборки будут созданы пакеты:

* в каталоге <tt>$TMP/repo/SRPMS.hasher/</tt> — исходные пакеты .src.rpm
* в каталоге <tt>$TMP/repo/i586/RPMS.hasher/</tt> — собранные бинарные пакеты

Примечание: архитектура (i586) может отличаться названием в зависимости от настроек Hasher и сборочного компьютера.

'''Внимание!''' При перезагрузке tmpfs очищается, поэтому скопируйте пакеты в безопасное место.
{{Category navigation|title=Сборка пакетов|category=Сборка пакетов|sortkey={{SUBPAGENAME}}}}