Содержание
Данный раздел содержит краткий обзор доступных сопровождающим инструментов. Приведённая ниже информация ни в коем мере не является полной или окончательной, она представляет собой лишь руководство по некоторым более популярным утилитам.
Инструменты сопровождающего Debian предназначены для облегчения работы разработчиком и освобождения их времени для решения критических задач. Как говорит Ларри Уолл, существует более одного способа сделать это.
Some people prefer to use high-level package maintenance tools and some do not. Debian is officially agnostic on this issue; any tool that gets the job done is fine. Therefore, this section is not meant to stipulate to anyone which tools they should use or how they should go about their duties of maintainership. Nor is it meant to endorse any particular tool to the exclusion of a competing tool.
Большинство описаний этих пакетов берётся из самих фактических описаний
пакетов. Дополнительная информация может быть найдена в самой документации
по пакету. Также вы можете получить дополнительную информацию при помощи
команды apt-cache show
имя-пакета
.
Следующие инструменты весьма нужны любому сопровождающими.
dpkg-dev
содержит инструменты
(включая dpkg-source), необходимые для распаковки, сборки
и загрузки пакетов Debian с исходным кодом. Эти утилиты предоставляют
базовую, низкоуровневую функциональность, необходимую для создания пакетов и
для манипуляции ими; как таковые, эти утилиты являются необходимыми любому
сопровождающему Debian.
debconf
предоставляет единообразный
интерфейс для интерактивной настройки пакетов. Его пользовательских
интерфейс независим, что позволяет конечным пользователям настраивать пакеты
при помощи текстового интерфейса, интерфейса HTML, либо диалогового
интерфейса. Новые варианты интерфейса могут быть добавлены в виде модулей.
Документацию для этого пакета вы можете найти в пакете debconf-doc
.
Many feel that this system should be used for all packages that require
interactive configuration; see Раздел 6.5, «Управление настройкой с помощью debconf
».
debconf
is not currently required by
Debian Policy, but that may change in the future.
fakeroot
имитирует привилегии
суперпользователя. Это позволяет вам собирать пакеты без привилегий
суперпользователя (обычно пакеты хотят установить файлы, владельцем которых
является суперпользователь). Если у вас установлен fakeroot
, dpkg-buildpackage
будет автоматически использовать его.
According to the Free On-line Dictionary of Computing (FOLDOC), `lint' is: "A Unix C language processor which carries out more thorough checks on the code than is usual with C compilers." Package lint tools help package maintainers by automatically finding common problems and policy violations in their packages.
lintian
анализирует пакеты Debian и
выдаёт информацию об ошибках и нарушениях Политики. Он содержит
автоматические проверки множества аспектов Политики Debian, а также
некоторые проверки на наличие распространённых ошибок.
Периодически вам следует получить наиболее свежую версию lintian
из нестабильного
выпуска и проверять все ваши пакеты. Заметьте, что опция
-i
предоставляет подробное объяснение того, что означает
каждая ошибка или предупреждение, на каком пункте Политики они основываются,
а иногда и то, как вы можете исправить проблему.
Для получения дополнительной информации о том, как и когда использовать Lintian, обратитесь к разделу 5.3, «Тестирование пакета».
Также вы можете посмотреть обзор всех проблем, о которых было сообщено
Lintian для ваших пакетов, по адресу https://lintian.debian.org/.
Эти отчёты содержат наиболее свежий вывод lintian для
всего разрабатываемого выпуска (нестабильного
выпуска).
debdiff (из пакета devscripts
, раздел A.6.1, «devscripts
») сравнивает списки файлов
и управляющие файлы двух пакетов. Это простая проверка на наличие
регрессий, поскольку она позволяет вам заметить, что число двоичных пакетов
изменилось с момента последней загрузки, либо если что-то было изменено в
управляющем файле. Конечно, некоторые изменения, о которых сообщает эта
утилита, не являются чем-то плохим, но она может помочь вам предотвратить
различные случайные проблемы.
Вы можете запустить её, указав два двоичных пакета:
debdiff package_1-1_arch.deb package_2-1_arch.deb
Или даже два файла changes:
debdiff package_1-1_arch.changes package_2-1_arch.changes
Дополнительную информацию см. в debdiff(1).
Инструменты сборки пакетов делают написание файла
debian/rules
значительно проще. Дополнительную
информацию о том, почему желательно или не желательно использовать их, см. в
разделе 6.1.1, «Сценарии-помощники».
debhelper
is a collection of
programs that can be used in debian/rules
to automate
common tasks related to building binary Debian packages. debhelper
includes programs to install various
files into your package, compress files, fix file permissions, and integrate
your package with the Debian menu system.
Unlike some approaches, debhelper
is
broken into several small, simple commands, which act in a consistent
manner. As such, it allows more fine-grained control than some of the other
debian/rules tools.
Имеется ряд небольших дополнительных пакетов debhelper
, которые слишком мелки, чтобы
описывать их здесь. Вы можете посмотреть список этих программ, выполнив
apt-cache search ^dh-
.
When choosing a debhelper
compatibility level for your package, you should choose the highest
compatibility level that is supported in the most recent stable release.
Only use a higher compatibility level if you need specific features that are
provided by that compatibility level that are not available in earlier
levels.
In the past the compatibility level was defined in
debian/compat
, however nowadays it is much better to
not use that but rather to use a versioned build-dependency like
debhelper-compat (=12)
.
The dh-make
package contains
dh_make, a program that creates a skeleton of files
necessary to build a Debian package out of a source tree. As the name
suggests, dh_make is a rewrite of debmake
, and its template files use
dh_* programs from debhelper
.
Хотя файлы rules, порождаемые dh_make, вообще-то являются достаточной основой для создания рабочего пакета, они всё равно представляют собой лишь основу: на сопровождающем всё ещё лежит груз задачи по тонкой настройке порождённых файлов и сборке пакета, целиком соответствующего Политике и работающего.
equivs
представляет собой ещё один
пакет для создания пакетов. Часто он предлагается для локального
использования, если вам нужно сделать пакет просто для удовлетворения
зависимостей. Также он иногда используется при создании „метапакетов“, это
пакеты, чья цель состоит лишь в том, чтобы зависеть от других пакетов.
The following packages help with the package building process, general driving of dpkg-buildpackage, as well as handling supporting tasks.
git-buildpackage
предоставляет
возможность введения или импорта пакетов Debian с исходным кодом в
репозиторий Git, сборки пакета Debian из репозитория Git, а также помогает в
интеграции изменений из основной ветки разработки в этот репозиторий.
Эти утилиты предоставляют инфраструктуру для облегчения использования Git
сопровождающими Debian. Это позволяет хранить отдельные ветки Git пакета
для стабильного
, нестабильного
и
возможно экспериментального
выпусков, а также иметь все
другие преимущества системы контроля версий.
Пакет debootstrap
и соответствующий
сценарий позволяют вам произвести начальную установку базовой системы Debian
в любую часть файловой системы. Под базовой системой мы подразумеваем
минимальное число пакетов, необходимых для работы и установки остальной
системы.
Иметь подобную систему весьма полезно. Например, вы можете сделать chroot в эту систему и проверить ваши сборочные зависимости. Либо вы можете проверить то, как ведут себя ваши пакеты при установке на базовую систему. Сборщики chroot используют этот пакет; см. об этом ниже.
pbuilder
constructs a chrooted
system, and builds a package inside the chroot. It is very useful to check
that a package's build dependencies are correct, and to be sure that
unnecessary and wrong build dependencies will not exist in the resulting
package.
A related package is cowbuilder
,
which speeds up the build process using a COW filesystem on any standard
Linux filesystem.
sbuild
представляет собой другой
автоматизированный сборщик. Он также может использовать окружения chroot.
Он может использоваться как отдельно, так и как часть сетевого,
распределённого окружения. В последнем случае он является частью системы,
используемой теми, кто занимается переносом, для сборки двоичных пакетов для
всех доступных архитектур. Дополнительную информацию см. в разделе 5.10.3.3, «wanna-build
»,
систему в действии можно посмотреть по адресу https://buildd.debian.org/.
Следующие пакеты помогут автоматизировать или упростить процесс загрузки пакетов в официальный архив.
dupload
представляет собой пакет и
сценарий для автоматической загрузки пакетов Debian в архив Debian, для
записи журнала загрузки, а также отправки сообщений электронной почты о
загрузке пакета. Вы можете настроить его на использование новых мест или
методов загрузки.
The dput
package and script do much
the same thing as dupload
, but in a
different way. It has some features over dupload
, such as the ability to check the GnuPG
signature and checksums before uploading, and the possibility of running
dinstall in dry-run mode after the upload.
Сценарий dcut (часть пакета dput
, раздел A.5.2, «dput
») помогает удалять файлы из
каталога загрузки на ftp.
Следующие инструменты помогают автоматизировать различные задачи по
сопровождению пакетов от добавления записей в журнал изменений или строк
подписи и поиска ошибок в Emacs до использования наиболее свежего и
исключительно официального файла config.sub
.
devscripts
is a package containing
wrappers and tools that are very helpful for maintaining your Debian
packages. Example scripts include debchange (or its
alias, dch), which manipulates your
debian/changelog
file from the command-line, and
debuild, which is a wrapper around
dpkg-buildpackage. The bts utility is
also very helpful to update the state of bug reports on the command line.
uscan can be used to watch for new upstream versions of
your packages.
Полный список доступных сценариев см. в руководстве devscripts(1).
autotools-dev
contains best
practices for people who maintain packages that use
autoconf and/or automake. Also
contains canonical config.sub
and
config.guess
files, which are known to work on all
Debian ports.
dpkg-repack creates a Debian package file out of a
package that has already been installed. If any changes have been made to
the package while it was unpacked (e.g., files in /etc
were modified), the new package will inherit the changes.
This utility can make it easy to copy packages from one computer to another, or to recreate packages that are installed on your system but no longer available elsewhere, or to save the current state of a package before you upgrade it.
alien преобразует пакеты между различными форматами пакетов, включая пакеты Debian, RPM (RedHat), LSB (Linux Standard Base), Solaris, и Slackware.
dpkg-dev-el
is an Emacs lisp package
that provides assistance when editing some of the files in the
debian
directory of your package. For instance, there
are handy functions for listing a package's current bugs, and for finalizing
the latest entry in a debian/changelog
file.
dpkg-depcheck (из пакета devscripts
, раздел A.6.1, «devscripts
») запускает команду в
окружении strace для определения всех пакетов, которые
используются вызванной командой.
Для пакетов Debian это весьма полезно, если вам необходимо сформировать
строку Build-Depends
для вашего нового пакета: запуск
процесса сборки через dpkg-depcheck предоставит вам
приблизительный список сборочных зависимостей. Например:
dpkg-depcheck -b debian/rules build
dpkg-depcheck также может использоваться для проверки зависимостей времени исполнения, особенно в том случае, если ваш пакет использует exec(2) для запуска других программ.
Дополнительную информацию см. в dpkg-depcheck(1).
Следующие инструменты полезны для занимающихся переносом и кросс-компиляцией.
Следующие пакеты предоставляют информацию для сопровождающих, либо помогают им в сборке документации.
docbook-xml
предоставляет DocBook
XML DTD, который обычно используется для подготовки документации по Debian
(как более старая документация debiandoc SGML DTD). Например, данное
руководство написано в DocBook XML.
Пакет docbook-xsl
предоставляет
файлы XSL для сборки и форматирования стиля исходных файлов в различные
форматы вывода. Для того, чтобы использовать стили XSL, вам потребуется
процессор XSLT, такой как xsltproc
.
Документация для стилей может быть найдена в пакетах docbook-xsl-doc-*
.
Чтобы создать PDF из FO, вам потребуется процессор FO, такой как xmlroff
или fop
. Другим инструментом для создания PDF из
DocBook XML является dblatex
.
debiandoc-sgml
предоставляет
DebianDoc SGML DTD, который широко используется для подготовки документации
по Debian, но в настоящее время устарел (следует использовать пакет
docbook-xml
). Кроме того, он
предоставляет сценарии для сборки и изменения стиля оформления исходного
файла в других форматах вывода.
Документация для DTD может быть найдена в пакете debiandoc-sgml-doc
.
Содержит открытые ключи GPG разработчиков и сопровождающих Debian. Дополнительную информацию см. в разделе 3.2.2, «Сопровождение вашего открытого ключа» и документации по пакету.