Chapter 7. Полезные советы

Можно сравнивать содержимое файлов в двух пакетах Debian с исходным кодом с помощью команды debdiff.

$ debdiff old-package.dsc new-package.dsc

Также можно сравнивать списки файлов в двух наборах двоичных пакетов Debian с помощью команды debdiff.

$ debdiff old-package.changes new-package.changes

Это полезно для определения изменений в пакетах с исходным кодом и для проверки на предмет нечаянных изменений, привнесённых при обновлении двоичных пакетов, таких как непреднамеренное ошибочное размещение или удаление файлов.

Можно скачать набор файлв для пакета Debian с исходным кодом с помощью команды dget.

$ dget https://www.example.org/path/to/package_version-rev.dsc

Созданные пакеты следуется установить с помощью команды debc для их локальной проверки.

$ debc package_version-rev_arch.changes

Созданные пакеты следует установить с помощью команды piuparts для их автоматической проверки.

$ sudo piuparts package_version-rev_arch.changes

	Note
	This is a very slow process with remote APT package repository access.

После завершения тестирования пакета можно его подписать с помощью команды debsign.

For uploading source-only package (normal):

$ debsign package_version-rev_source.changes

For uploading binary package:

$ debsign package_version-rev_arch.changes

After signing the package with the debsign command, you can upload the set of files for the Debian source and binary packages with the dput command.

For uploading source-only package (normal):

$ dput package_version-rev_source.changes

For uploading binary package:

$ dput package_version-rev_arch.changes

Пакет git-buildpackage предлагает множество команд для автоматизации деятельности по работе над пакетом с помощью репозитория git.

Package history management with the git-buildpackage package is becoming the standard practice for most Debian maintainers.

См.:

The new dgit package offers commands to automate packaging activities using the git repository as an alternative to still popular gbp-buildpackage. Please read their guide:

Let’s assume that a bug report #bug_number was filed against your package, and it describes a problem that you can solve by editing the buggy file in the upstream source. Here’s what you need to do to create a new Debian revision of the package with the bugname.patch file recording the fix.

Новая редакция Debian с помощью команды dquilt. 

 $ dquilt push -a
 $ dquilt new bugname.patch
 $ dquilt add buggy
 $ vim buggy
   ...
 $ dquilt refresh
 $ dquilt header -e
 $ dquilt pop -a
 $ dch -i

Alternatively if the package is managed in the git repository using the git-buildpackage command with its default configuration:

Новая редакция Debian с помощью команды gbp-pq. 

 $ git checkout master
 $ gbp pq import
 $ vim buggy
 $ git add buggy
 $ git commit
 $ git tag pq/<newrev>
 $ gbp pq export
 $ gbp pq drop
 $ git add debian/patches/*
 $ dch -i
 $ git commit -a -m "Closes: #<bug_number>"

Проверьте, что вы лаконично описали изменения, исправляющие ошибку, и закрыли сообщение об ошибке, добавив «Closes: #<номер_ошибки>» в файл debian/changelog.

	Tip
	Когда вы экспериментируете, то используйте запись debian/changelog со строкой версии вида 1.0.1-1~rc1. Затем сведите такие записи журнала изменений в одну запись для официального пакета.

Обновление стиля пакета не является требуемой деятельностью до обновления пакета. Тем не менее, такое обновление позволяет использовать все возможности современной системы debhelper и формат исходного кода 3.0.

Общая система сборки Debian (CDBS) является обёрткой над пакетом debhelper. CDBS построена на основе механизма включения Makefile и настраивается с помощью установки переменных настройки DEB_* в файле debian/rules.

До добавления команды dh в пакет debhelper (начиная с версии 7) CDBS являлась единственным подходом к созданию простого и ясного файла debian/rules.

For many simple packages, the dh command alone allows us to make a simple and clean debian/rules file now. It is desirable to keep the build system simple and clean by not using the superfluous CDBS.

	Note
	Neither “the CDBS magically does the job for me with less typing” nor “I don’t understand the new dh syntax” can be an excuse to keep using the CDBS system.

For some complicated packages such as GNOME related ones, the CDBS is leveraged to automate their uniform packaging by the current maintainers with justification. If this is the case, please do not bother converting from the CDBS to the dh syntax.

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

При переходе с использования системы CDBS на синтаксис dh в качестве справочника используйте следующую документацию:

Локалью по умолчанию в сборочном окружении является C.

Некоторые программы, такие как функци read из Python3, изменяют своё поведение в зависимости от текущей локали.

Adding the following code to the debian/rules file ensures building the program under the C.UTF-8 locale.

LC_ALL := C.UTF-8
export LC_ALL

При первой загрузке пакета в архив вам следует включить в загрузку также и архив с оригинальным исходным кодом, orig.tar.gz.

Если номер редакции Debian вашего пакета не является 1 или 0, то это происходит по умолчанию. В противном случае, вам следует передать опцию -sa команде dpkg-buildpackage.

	Tip
	С другой стороны использование опции -sd приведёт к тому, что архив с оригинальным исходным кодом, orig.tar.gz, будет включён в загрузку.

	Tip
	Security uploads require including the orig.tar.gz file.

Если вы создаёте несколько записей в файле debian/changelog и пропускаете загрузки, то вам следует создать соответствующий файл *_.changes, включающий все изменения с последней загрузки. Это можно сделать, передав dpkg-buildpackage опцию -v с указанием последней загруженной версии, например, 1.2.

Полезные советы по приведённым ниже вопросам можно найти в странице руководства debhelper(7):

Несмотря на то, что в tar-архиве основной ветки имеется вся информация для сборки пакета Debian, не всегда легко понять, какую комбинацию опций следует использовать.

Also, the upstream package may be more focused on feature enhancements and may be less eager about backward compatibilities etc., which are an important aspect of Debian packaging practice.

The leveraging of information from other distributions is an option to address the above issues.

If the other distribution of interest is a Debian derivative one, it is trivial to reuse it.

Когда вы сталкиваетесь с проблемами сборки или дампом памяти созданных двоичных программ, вам необходимо разрешить их самостоятельно. Это называется отладкой.

Это слишком обширная тема, чтобы обсуждать её в настоящем руководстве. Поэтому позвольте просто привести несколько ссылок и полезных советов по использованию типичных инструментов отладки.