第 6 章 构建软件包

为保证完整的软件包(重)构建能顺利进行，你必须保证系统中已经安装

然后在源代码目录中执行以下命令：

$ dpkg-buildpackage -us -uc

这样会自动完成所有从源代码包构建二进制包的工作，包括：

如果构建结果令人满意，那就用 debsign 命令以你的私有 GPG 密钥签署 .dsc 文件和 .changes 文件。你需要输入密码两次。 ^[62]

对于非本土 Debian 软件包，比如 gentoo， 构建软件包之后，你将会在上一级目录(~/gentoo) 中看到下列文件：

在上传到 Debian FTP 仓库中前，gentoo_0.9.12-1.dsc 文件和 gentoo_0.9.12-1_i386.changes 文件必须用 debsign 命令签署，其中使用你自己存放在 ~/.gnupg/ 目录中的 GPG 私钥。 用你的公钥，可以令 GPG 签名证明这些文件真的是你的。

debsign 命令可以用来以指定 ID 的 GPG 密钥进行签署 （这方便了赞助(sponsor)软件包）， 只要照着下边在 ~/.devscripts 中的内容：

DEBSIGN_KEYID=Your_GPG_keyID

.dsc 和 .changes 文件中很长的数字串是其中提及文件的 SHA1/SHA256 校验和。下载你软件包的人可以使用 sha1sum(1) 或 sha256sum(1) 来进行核对。如果校验和不符，则说明文件已被损坏或偷换。

Debian 支持非常多的 移植(port)，同时它有着 自动构建网络，这个网络在不同体系结构的计算机上运行着 buildd 守护进程。 虽然你不需要自己做这件事情，你也应该知道在你的软件包身上发生了什么。让我们来简要地看看他们是如何为你给多个体系结构构建软件包的。 ^[64]

对于 Architecture: any 的软件包，自动编译系统重构建它们。它确保系统中已经安装

然后在源代码目录中执行以下命令：

$ dpkg-buildpackage -B

这样会自动完成从源代码包构建平台依赖二进制包的工作，包括：

这就是你看到你的软件包在其他平台上可用的原因。

尽管通常的打包工作中 Build-Depends-indep 字段中列出的软件包都需要安装(参看 第 6.1 节 “完整的(重)构建”)，但是在编译平台依赖二进制包时它们无需在自动编译系统上安装。^[65]通常打包和自动编译系统的这种不同为你指出如何考虑必须的软件包应如何放在 debian/control 文件的 Build-Depends 或 Build-Depends-indep 域中(参看 第 4.1 节 “control”)。

你可以使用 debuild 命令来进一步自动化 dpkg-buildpackage 的构建过程。参看 debuild(1)

debuild 命令会执行 lintian 命令，以在 Debian 软件包构建结束之后进行静态检查。 lintian 命令可以用下边出现在 ~/.devscripts 文件中的项来定制：

DEBUILD_DPKG_BUILDPACKAGE_OPTS="-us -uc -I -i"
DEBUILD_LINTIAN_OPTS="-i -I --show-overrides"

在普通用户帐号中可以使用以下这样简单的命令清理源代码并重构建软件包：

$ debuild

还可以这样简单地清理源代码树：

$ debuild -- clean

对于使用净室(chroot)编译环境来验证编译依赖而言，pbuilder 软件包是非常有用的。^[66]它确保了软件包在不同构架上的 sid 发行版环境中的自动编译器中能干净地编译，避免了总是被归类于 RC (Release Critical，影响发布)的严重 FTBFS (Fails To Build From Source，从源代码编译失败) Bug。^[67]

我们通过以下操作来定制 pbuilder 软件包。

首先使用以下命令初始化本地 pbuilder chroot 系统：

$ sudo pbuilder create

如果你已经创建了源代码包，在包含 foo.orig.tar.gz、foo.debian.tar.gz 和 foo.dsc 文件的目录中执行下面的命令来更新 pbuilder chroot 系统以便在其中执行构建：

$ sudo pbuilder --update
$ sudo pbuilder --build foo_version.dsc

新构建的无 GPG 签名的软件包会被以非 root 属主放置于 /var/cache/pbuilder/result/。

.dsc 文件和 .changes 文件中的 GPG 签名可以用如下方法生成：

$ cd /var/cache/pbuilder/result/
$ debsign foo_version_arch.changes

如果你已经更新了源代码树但没有生成对应的源代码包，在存放 debian 目录的源码目录里执行：

$ sudo pbuilder --update
$ pdebuild

你可以使用 pbuilder --login --save-after-login 命令登录到这个 chroot 环境中并按照需要对其进行配置。通过 ^D (Control-D)离开这个 shell 时环境会被保存。

最新版的 lintian 命令可以通过设置钩子脚本 /var/cache/pbuilder/hooks/B90lintian 在 chroot 环境中运行。脚本内容如下：^[68]

#!/bin/sh
set -e
install_packages() {
        apt-get -y --allow-downgrades install "$@"
        }
install_packages lintian
echo "+++ lintian output +++"
su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes" - pbuilder
# use this version if you don't want lintian to fail the build
#su -c "lintian -i -I --show-overrides /tmp/buildd/*.changes; :" - pbuilder
echo "+++ end of lintian output +++"

为 sid 编译软件包需要使用 sid 环境。在现实中 sid 存在很多问题以至于你不愿意将整个系统都迁移到其上。pbuilder 软件包可以在这种情况下很好地解决问题。

你可能需要在 stable 软件包发布后为 stable-proposed-updates、stable/updates 等仓库升级你维护的软件包。^[69]对于这类情况，“我正在运行 sid 系统”并不是你不为它们进行升级的充分理由。pbuilder 软件包可以帮助你使用到相同 CPU 体系结构下几乎所有 Debian 和 Debian 衍生版系统环境。

参见 http://www.netfort.gr.jp/~dancer/software/pbuilder.html, pdebuild(1), pbuilderrc(5), 和 pbuilder(8).

如果你的上游对源代码使用版本控制系统(VCS)^[70]，你也应该考虑使用它们。这会使得合并和提取上游补丁更加简单。有多个为不同 VCS 设计的包装脚本包来协助 Debian 软件包构建。

git-buildpackage 的使用 在 Debian 开发者之中非常流行， 它可以使用 alioth.debian.org 上的 Git 服务器来管理 Debian 软件包。 ^[71] 这个软件包提供了许多命令来 自动化 打包操作：

这些命令使用 3 个分支来跟踪打包操作：

你可以设置 git-buildpackage，通过修改 ~/.gbp.conf 文件。参见 gbp.conf(5). ^[73]

对于很大的软件包，在调试 debian/rules 的过程中你可能不想每次都对整个软件包进行重构建。仅用于测试目的，你可以不重新构建源代码包而使用以下的方法创建 .deb 文件^[74]：

$ fakeroot debian/rules binary

或者可以通过以下方法验证它是否能通过编译：

$ fakeroot debian/rules build

一旦完成了调试，记住要按照前面所给出的正常过程重构建你的软件包。你可能无法正常上传用此种方法构建的 .deb 文件。

这里有一个简练的总结，关于在命令层次结构中有多少用于构建软件包的命令能够组合到一起。做这件事情的方法非常多。

• debian/rules = 软件包构建过程的专用 maintainer script

• dpkg-buildpackage = 软件包构建之核心工具

• debuild = dpkg-buildpackage + lintian (在干净的环境变量下构建)

• pbuilder = Debian chroot 环境核心工具

• pdebuild = pbuilder + dpkg-buildpackage (在chroot环境中构建)

• cowbuilder = 加速 pbuilder 执行

• git-pbuilder = 命令行语法友好pdebuild (被 gbp buildpackage 使用)

• gbp = 在 Git 仓库中管理 Debian 源码

• gbp buildpackage = pbuilder + dpkg-buildpackage + gbp

即便像 gbp buildpackage 和 pbuilder 这样的高级命令的应用可以确保完美的软件包 构建环境，了解像 debian/rules 和 dpkg-buildpackage 这样的低级命令行工具如何被它们执行也是至关重要的。