第 2 章 第一步

请注意一个细节，在 Debian 软件包的文件名中，分隔 package 和 version 的字符从 tarball 名称中的 - (连字符)换成了 _ (下划线)。

在上述的文件名中，请根据 Debian Policy，将 package 这个部分替换为 package name， 将 version 这个部分替换为 upstream version， 将revision 这个部分替换为 Debian revision，以及将 arch 这个部分替换为 package architecture。 ^[5]

本概要中的每一步，我们都会在后续的章节中辅以详细的例子进行解释。

如果软件包已经存在于仓库中，那直接装上它就可以了呀！:-) 如果它是被 甩掉了(orphaned) 的 —— 也就是说它的维护者被设置为 Debian QA Group，这时候你可以尝试接手维护它。另外，你也可以“领养”那些维护者发送过“Request for Adoption”(RFA)请求的软件包。^[6]

软件包归属状态有这几种：

作为旁注必须指出，Debian 已经拥有了海量各种类型的软件包，而且处在仓库中软件包的数量也远远超过了拥有上传权限的贡献者数量。因此，为已经在仓库中的软件包贡献力量是非常受其他开发者欢迎的 (且更容易获得 sponsorship)^[7]。有非常多的方式可以实现这一目的：

如果你有能力“领养”那个软件包，那就先下载 (使用 apt-get source packagename 或其他类似的工具)并分析它的源代码。这篇文档不会详细说明如何领养软件包，不过幸运的是，领养软件包时，打包的起始工作已经有人完成，接手的工作应比从头开始轻松得多。尽管如此也请您不要轻敌，请继续阅读，下面给出的建议会对你很有帮助。

如果您要制作的软件包是完全崭新的，而您又希望它出现在 Debian 中，那请遵循以下的步骤：

当然，这些都是为了安全，并试图避免你在，比如 setuid 守护进程等问题上犯错误而激怒了用户 ... 当你在打包方面有了更多经验时，就能够处理这样的软件包了，不必着急。

我们鼓励你，作为一个新维护者，选择易于打包和维护的软件，而不鼓励选择复杂的软件包。

打包高复杂软件包并非难如登天，但这个过程需要用到更多知识。你应该针对每一个所谓的复杂特性来搜寻相应的指南。比如，一些语言有它们自己的子策略文档：

还有一句拉丁谚语：fabricando fit faber （熟能生巧）。我们 强烈 建议你在阅读这篇教程的时候，用一个简单的软件包来对所有的 Debian 打包步骤进行实验。跟随下边的步骤您就可以创建一个微不足道的软件包 hello-sh-1.0.tar.gz ，而且这会是一个非常好的开端：^[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])，则应当使用对应和合适的工具将其解压，再重新归档为 Tarball。

如果你挑选的程序的源代码中包含一些不符合 DFSG 的内容，你应当解压后移除它们，然后将删减过的源码重新归档。因为 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 目录；但在 Debian 软件包制作过程中不可以那样做。详细的原因在 第 3.3 节 “文件安装” 中说明)。

开始打包时的源代码目录应当是绝对干净原始，没有做过任何修改的。一般来说直接使用刚刚解压得到的源代码即可。

有些比较简单的程序源码自己带有 Makefile, 这时你可以很容易地使用 make 命令来编译它。^[11] 有一些软件的 Makefile 还支持 make check，这个命令可以完成一系列程序检验和测试。当程序编译好后即可用 make install 命令，将程序安装到目标目录。

现在尝试编译和运行你的程序，你需要确保它能正常工作，以及它在安装和运行时不会破坏别的东西。

你还可以运行 make clean (或更好的 make distclean) 来清理编译目录。Makefile 中有时还会支持 make uninstall ，它被用来卸载已经安装了的程序文件。

有非常非常多的自由软件是使用 C 和 C++ 语言编写的。其中又有很多程序使用了 Autotools 或 CMake 来使其可以移植到不同平台上。这些工具被用于生成 Makefile 和其他必须的源文件。然后程序就可以使用正常的 make; make install 来编译和安装。

Autotools 是 GNU 编译系统工具集，包括 Autoconf、Automake、Libtool 和 gettext。你可以通过 configure.ac、Makefile.am 和 Makefile.in 等特征文件来识别使用 Autotools 作为编译系统的源代码。^[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 来将其编译成为 binary (二进制文件)。

Makefile.in -----+                +-> Makefile -----+-> make -> binary
src/Makefile.in -+-> ./configure -+-> src/Makefile -+
config.h.in -----+                +-> config.h -----+
                 |
  config.status -+
  config.guess --+

你可以改变 Makefile 文件的许多设置，比如你可以修改默认的文件安装路径(使用 ./configure --prefix=/usr)。

可选：若使用 autoreconf -i -f 来更新 configure 和其他相关文件，则有可能可以提高源代码的兼容性。 ^[13]

CMake 是另一个备选的编译系统，你可以通过 CMakeLists.txt 这个特征文件来识别使用 CMake 的源代码。

如果上游源代码以 gentoo-0.9.12.tar.gz 这样的文件名来分发，你就可以用 gentoo 作为 软件包名 ，并用 0.9.12 作为 上游版本。 它们会被 debian/changelog 这个文件用到；第 4.3 节 “changelog” 部分会详细描述这个文件。

虽然此法在大部分情况下能显灵，但你仍需要根据 Debian 政策（Debian Policy）以及约定俗成的做法来调整 软件包名 和 上游版本 。

在 软件包名 里只能含有 小写字母 (a-z), 数字 (0-9), 加号 (+) 和 减号 (-) ， 以及 点号 (.)。 软件包名最短长度两个字符；它必须以字母开头；它不能与仓库软件包名发生冲突。还有，把软件包名的长度控制在 30 字符以内是明智之举。 ^[14]

如果上游代码在它的名称中使用了一些通用术语比如 test-suite， 那么你应当将其重命名，显式地说明其内容并避免污染命名空间。 ^[15]

你应该让 upstream version（上游版本号） 只包含字母和数字 (0-9A-Za-z), 以及加号 (+), 波浪号 (~), 还有 点号(.)。它必须以数字开头 (0-9)。 ^[16] 如果可能的话，最好把它的长度控制在8字符以内。 ^[17]

如果上游不使用像 2.30.32 这样的常规版本格式，而是用类似 11Apr29 这样的日期作为版本，类似于随机的代号字符串，或者以VCS的哈希值作为版本号的一部分，那么请确认将其从 upstream version 中移除。 为此作出的改动信息可以记录在 debian/changelog 文件中。 如果你需要发明一个版本字符串，请使用 YYYYMMDD 这个格式作为上游版本，比如 20110429 。这会确保 dpkg 在升级软件包时能够正确解读新版本。 如果需要确保未来能够平滑过渡到类似 0.1 这样的版本号的话，那就请使用 0~YYMMDD 格式作为上游版本，例如 0~110429 。

版本字符串 ^[18] 可以用 dpkg(1) 来进行比较：

$ dpkg --compare-versions ver1 op ver2

版本比较规则可总结为以下几点：

有一种比较棘手的情况，当上游释出 gentoo-0.9.12-ReleaseCandidate-99.tar.gz 作为 gentoo-0.9.12.tar.gz 的预发布版本时，就需要确保升级工作妥当进行：重命名该上游源代码为 gentoo-0.9.12~rc99.tar.gz.

首先设置两个 环境变量，$DEBEMAIL 和 $DEBFULLNAME，这样大多数 Debian 维护工具就能够正确识别你用于维护软件包的姓名和电子邮件地址。^[19]

$ cat >>~/.bashrc <<EOF
DEBEMAIL="your.email.address@example.org"
DEBFULLNAME="Firstname Lastname"
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

当然，这里请用你原版源码归档的名字来替换 filename (文件名)。 ^[20] 详情请参见 dh_make(8) 。

你会看到一些输出，询问你想要创建什么类型的软件包。这里的 Gentoo 被规划为一个单一二进制包——它仅仅产生一个二进制包， 亦即单个 .deb 文件——于是我们就选择第一项 (按 s 键)， 认真阅读屏幕上的输出信息， 然后按 ENTER 键来确认。 ^[21]

执行 dh_make 后，上级目录中自动创建了一份上游 tarball 的副本，名为 gentoo_0.9.12.orig.tar.gz，这个文件和稍后要介绍的 debian.tar.gz 合在一起便满足了一部分 Debian 非本土源码包的要求。

$ 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 目录下的其他文件 中一一加以说明。另外，打包这件事情无法被完全自动化。因此你还得按照 第 3 章 修改源代码 中介绍的方法为 Debian 修改软件包。再接下来，按照 第 6 章 构建软件包 中叙述的合适的方法来构建 Debian 软件包，并根据 第 7 章 检查软件包中的错误 中的方法进行软件包测试，最后参考 第 9 章 上传软件包 这里的说明将其上传。所有的这些主要步骤本教程都会进行解释。

如果你在修改过程中不小心删除或玩坏了某些模板，你还可以使用 dh_make 加 --addmissing 参数来将其还原。（译注：也可以用dpkg -L dh-make 来寻找您想要的模板）

更新一个已存在的软件包可能有点复杂，因为它可能使用了旧的打包技术。在学习基本功的阶段，建议只创建全新的软件包；稍后的 第 8 章 更新软件包中会细致地讲解更新现存软件包。

请注意，源代码中不必包含任何在 第 2.4 节 “简单的编译系统” 或 第 2.5 节 “常见的可移植编译系统” 中谈论到的编译系统。 就算源码包仅仅是一组图像之类的也可以，这时候这些文件的安装可以用 debhelper 的配置文件来搞定，比如 debian/install (参见 第 5.11 节 “install”)。