Глава 2. Первые шаги

Заметим, что в именах файлов пакетов Debian для разделения пакета и версии используется символ _ (подчёркивание), а не - (дефис), как в имени оригинального tar-файла.

В именах файлов, представленных выше, замените часть пакет на имя пакета, часть версия на версию исходной программы, часть редакция на редакцию Debian и часть архитектура на архитектуру, для которой предназначен пакет, в соответствии с политикой Debian ^[5].

Каждый шаг, показанный ранее, детально описан на примерах в последующих разделах.

Если пакет уже есть, то просто установите его! :-) Если случится так, что он окажется брошенным (orphaned) — то есть сопровождающий передал его Debian QA Group, то вы сможете подобрать его, если он ещё будет доступен. Также вы можете взять пакет, если его сопровождающий послал «запрос об усыновлении» (Request for Adoption, RFA) ^[6].

Есть несколько ресурсов для получения информации о состоянии владения пакетом:

Попутно отметим, что в Debian уже есть пакеты для большинства типов программ, и их количество в архиве Debian намного больше, чем участников с правом загрузки. Поэтому работа над пакетами, которые уже включены в архив, намного предпочтительней (и с большей вероятностью получит поручительство) с точки зрения других разработчиков ^[7]. Этого можно достичь различными путями:

If you are able to adopt the package, get the sources (with something like apt-get source packagename) and examine them. This document unfortunately doesn't include comprehensive information about adopting packages. Thankfully you shouldn't have a hard time figuring out how the package works since someone has already done the initial setup for you. Keep reading, though; a lot of the advice below will still be applicable to your case.

Если пакет новый и вы решили, что он нужен в Debian, то сделайте следующее:

Of course, the last one is just a safety measure, and is intended to save you from enraging users if you do something wrong in some setuid daemon… When you gain more experience in packaging, you'll be able to package such software.

Как начинающий сопровождающий, не беритесь за сложные пакеты, пока не научитесь пакетировать самые простые.

Пакетирование пакетов повышенной сложности не слишком трудно, но требует больше знаний. Вы должны найти нужное руководство для каждой сложной функции. Например, для некоторых языков есть своя документация с политикой:

There is another old Latin saying: fabricando fit faber (practice makes perfect). It is highly recommended to practice and experiment with all the steps of Debian packaging with simple packages while reading this tutorial. A trivial upstream tarball, hello-sh-1.0.tar.gz, created as follows may offer a good starting point:^[8]

$ mkdir -p hello-sh/hello-sh-1.0; cd hello-sh/hello-sh-1.0
$ cat > hello <<EOF
#!/bin/sh
# (C) 2011 Foo Bar, GPL2+
echo "Hello!"
EOF
$ chmod 755 hello
$ cd ..
$ tar -cvzf hello-sh-1.0.tar.gz hello-sh-1.0

Если исходный код выбранной программы поставляется в другом виде (например, имя файла оканчивается на .Z или .zip^[9]), распакуйте его соответствующими средствами и перепакуйте его.

Если исходный код выбранной программы поставляется с содержимым, не удовлетворяющим DFSG, то вам также нужно распаковать его и удалить это содержимое и перепаковать его, добавив в версию исходного кода пометку dfsg.

В качестве примера взята программа gentoo — менеджер файлов, использующий GTK+ ^[10].

В своём домашнем каталоге создайте каталог с именем debian, deb или с любым удобным (например, в нашем случае можно было бы использовать ~/gentoo). Поместите скачанный архив в этот каталог и распакуйте его (tar xzf gentoo-0.9.12.tar.gz). Убедитесь, что при этом не возникло никаких, даже, казалось бы, не относящихся к делу ошибок, так как их появление означает, что они могут возникнуть и на машинах других людей, у которых их инструменты распаковки посчитают это за реальную ошибку. В командной строке оболочки вы должны увидеть следующее:

$ mkdir ~/gentoo ; cd ~/gentoo
$ wget http://www.example.org/gentoo-0.9.12.tar.gz
$ tar xvzf gentoo-0.9.12.tar.gz
$ ls -F
gentoo-0.9.12/
gentoo-0.9.12.tar.gz

В результате вы получите подкаталог gentoo-0.9.12. Перейдите в этот каталог и внимательно прочитайте имеющуюся документацию. Обычно, полезными оказываются файлы README*, INSTALL*, *.lsm или *.html. Вы должны найти инструкции, которые позволят вам правильно скомпилировать и установить программу (скорее всего, в каталог /usr/local/bin; вы должны будете установить программу в другой каталог, подробнее об этом в Раздел 3.3, «Установка файлов в их каталоги назначения»).

Вы должны начинать процедуру пакетирования в полностью оригинальном (ещё неизменённым) каталоге с исходным кодом (для этого, например, можно заново распаковать архив с исходным кодом).

В простых программах обычно используется файл Makefile и для компиляции достаточно выполнить команду make^[11]. Некоторые из них поддерживают команду make check, по которой выполняется самопроверка. Установка в каталог назначения обычно выполняется с помощью make install.

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

Вы также можете попытаться воспользоваться командой make clean (или лучше make distclean) для очистки каталога сборки. Иногда есть даже команда make uninstall, которая позволит удалить все установленные файлы.

Многие свободные программы написаны на языках C и C++. В некоторых из них для переносимости между платформами используются Autotools или CMake. Эти инструменты используются для генерации Makefile и других необходимых исходных файлов. Такие программы обычно собираются с помощью make; make install.

Autotools — это система сборки GNU, состоящая из Autoconf, Automake, Libtool и gettext. Её использование можно определить по включённым в исходный архив файлам configure.ac, Makefile.am и Makefile.in ^[12].

Первый шаг автоматизации с помощью Autotools обычно выполняет автор программы. Он запускает команду autoreconf -i -f в каталоге с исходным кодом и затем распространяет сгенерированные файлы вместе с исходным кодом.

configure.ac-----+-> autoreconf -+-> configure
Makefile.am -----+        |      +-> Makefile.in
src/Makefile.am -+        |      +-> src/Makefile.in
                          |      +-> config.h.in
                      automake
                      aclocal
                      aclocal.m4
                      autoheader

Для правки файлов configure.ac и Makefile.am требуется знание инструментов autoconf и automake. Смотрите info autoconf и info automake.

Второй шаг автоматизации с помощью Autotools обычно выполняет пользователь. Он получает распространяемый код и запускает ./configure && make для компиляции программы в исполняемыйдвоичный файл.

Makefile.in -----+                +-> Makefile -----+-> make -> двоичный файл
src/Makefile.in -+-> ./configure -+-> src/Makefile -+
config.h.in -----+                +-> config.h -----+
                 |
  config.status -+
  config.guess --+

Вы можете изменять различные переменные в файле Makefile. Например каталог установки по умолчанию изменяется с помощью параметра в командной строке: ./configure --prefix=/usr.

Хотя это не обязательно, обновление configure и других файлов с помощью autoreconf -i -f может улучшить совместимость исходного кода ^[13].

Альтернативной системой сборки является CMake. Её можно определить по наличию файла CMakeLists.txt.

Если оригинальный исходный код программы содержится в файле gentoo-0.9.12.tar.gz, то в качестве (исходного) имени пакета можно взять gentoo, а в качестве версии исходной программы — 0.9.12. Имя и версия используются в файле debian/changelog, который описан далее в Раздел 4.3, «Файл changelog».

Although this simple approach works most of the time, you may need to adjust package name and upstream version by renaming the upstream source to follow Debian Policy and existing convention.

You must choose the package name to consist only of lower case letters (a-z), digits (0-9), plus (+) and minus (-) signs, and periods (.). It must be at least two characters long, must start with an alphanumeric character, and must not be the same as existing packages. It is a good idea to keep its length within 30 characters. ^[14]

Если для имени автор программы использовал какие-то общие слова, например test-suite, то лучше назначить другое имя, которое явно описывает содержимое и не засоряет пространство имён ^[15].

You should choose the upstream version to consist only of alphanumerics (0-9A-Za-z), plus signs (+), tildes (~), and periods (.). It must start with a digit (0-9). ^[16] It is good idea to keep its length within 8 characters if possible. ^[17]

If upstream does not use a normal versioning scheme such as 2.30.32 but uses some kind of date such as 11Apr29, a random codename string, or a VCS hash value as part of the version, make sure to remove them from the upstream version. Such information can be recorded in the debian/changelog file. If you need to invent a version string, use the YYYYMMDD format such as 20110429 as upstream version. This ensures that dpkg interprets later versions correctly as upgrades. If you need to ensure smooth transition to the normal version scheme such as 0.1 in the future, use the 0~YYMMDD format such as 0~110429 as the upstream version.

Строки версий ^[18] можно сравнить с помощь dpkg(1) следующим образом:

 $ dpkg --compare-versions версия1 операция версия2

Правило сравнения версий вкратце можно описать так:

Иногда бывает, что автор выпускает предварительную версию gentoo-0.9.12.tar.gz с именем gentoo-0.9.12-ReleaseCandidate-99.tar.gz. Чтобы правильно сработало обновление пакета, вам нужно переименовать файл с исходным кодом в gentoo-0.9.12~rc99.tar.gz.

Для указания вашего адреса электронной почты и имени, которые будут использоваться в пакетах инструментами сопровождения Debian, настройте переменные окружения $DEBEMAIL и $DEBFULLNAME ^[19]:

$ cat >>~/.bashrc <<EOF
DEBEMAIL="ваш.адрес.эл.почты@example.org"
DEBFULLNAME="Имя Фамилия"
export DEBEMAIL DEBFULLNAME
EOF
$ . ~/.bashrc

$ cd ~/gentoo
$ wget http://example.org/gentoo-0.9.12.tar.gz
$ tar -xvzf gentoo-0.9.12.tar.gz
$ cd gentoo-0.9.12
$ dh_make -f ../gentoo-0.9.12.tar.gz

Здесь замените имя файла именем вашего архива с исходным кодом ^[20]. Подробней смотрите dh_make(8).

You should see some output asking you what sort of package you want to create. Gentoo is a single binary package — it creates only one binary package, i.e., one .deb file — so we will select the first option (with the s key), check the information on the screen, and confirm by pressing ENTER. ^[21]

После выполнения dh_make в родительском каталоге создался исходный архив tar с именем gentoo_0.9.12.orig.tar.gz, который в дальнейшем будет использоваться для создания неродного пакета с исходным кодом Debian с именем debian.tar.gz:

$ cd ~/gentoo ; ls -F
gentoo-0.9.12/
gentoo-0.9.12.tar.gz
gentoo_0.9.12.orig.tar.gz

Отметьте два ключевых момента в имени файла gentoo_0.9.12.orig.tar.gz:

Вы, наверное, уже заметили, что в исходном коде в каталоге debian было создано множество файлов шаблонов. Их назначение описано в Глава 4, Обязательные файлы в каталоге debian и Глава 5, Другие файлы в каталоге debian/. Как вы уже догадались, процесс пакетирования не может быть полностью автоматическим. Вам нужно изменить исходный код программы для Debian (Глава 3, Изменение исходного кода). После этого вам нужно правильно собрать пакет Debian (Глава 6, Сборка пакета), проверить его (Глава 7, Проверка пакета на наличие ошибок) и отослать в архив (Глава 9, Отправка пакета). Далее будут рассмотрены все эти шаги.

Если вы случайно стёрли какой-то файл шаблона при работе, то можете восстановить его, повторно запустив dh_make с параметром --addmissing в дереве исходного кода пакета Debian.

Обновлять существующий пакет сложнее, так как для его создания могли использоваться старые методы. Поэтому на время обучения пока беритесь за современные пакеты. Мы вернёмся к этому позднее в Глава 8, Обновление пакета.

Please note that the source file does not need to contain any build system discussed in Раздел 2.4, «Простые системы сборки» and Раздел 2.5, «Популярные переносимые системы сборки». It could be just a collection of graphical data, etc. Installation of files may be carried out using only debhelper configuration files such as debian/install (see Раздел 5.11, «Файл install»).