Product SiteDocumentation Site

5.3. 源码包的结构

5.3.1. 格式

一个源码包通常包括三个文件，.dsc、.orig.tar.gz 与 .debian.tar.xz（或 .diff.gz）。它们允许从编程语言撰写的程序源代码文件中，创建二进制软件包（如前所述的 .deb 文件）。
.dsc (Debian Source Control) 文件是包括 RFC 2822 标头 (如同 control 文件于 第 5.2.1 节 “描述：control 文件”) 的简短文本档，描述原始软件包及包括的其他文件。由维护者签署，保证其真实性。详情见 第 6.6 节 “检查软件包真实性”。

例 5.1. 一个.dsc 文件

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Format: 3.0 (quilt)
Source: zim
Binary: zim
Architecture: all
Version: 0.75.1-1
Maintainer: Zim Package Maintainers <zim@packages.debian.org>
Uploaders: Raphaël Hertzog <hertzog@debian.org>
Homepage: https://zim-wiki.org
Standards-Version: 4.6.1
Vcs-Browser: https://salsa.debian.org/debian/zim
Vcs-Git: https://salsa.debian.org/debian/zim.git
Build-Depends: debhelper-compat (= 13), python3, python3-gi, python3-xdg, gir1.2-gtk-3.0, dh-python
Package-List:
 zim deb x11 optional arch=all
Checksums-Sha1:
 b4baa294ebc28b07393739875d94fab9557a2e5e 2510821 zim_0.75.1.orig.tar.gz
 e592c9ab8b12276283c6a7bed2246f2e9a843093 10416 zim_0.75.1-1.debian.tar.xz
Checksums-Sha256:
 88e175d7f7e141896f9e958989d252d722556af17bc4bc6f065e7d54287d0385 2510821 zim_0.75.1.orig.tar.gz
 30847b58bb2503b707f1d5c5c356eead31e61db09e677348f07383fcdda3bcb3 10416 zim_0.75.1-1.debian.tar.xz
Files:
 cc73838c1312b5e161d15a51ae4247c4 2510821 zim_0.75.1.orig.tar.gz
 ad84c5ac373071e4957490caf03f3a8b 10416 zim_0.75.1-1.debian.tar.xz

-----BEGIN PGP SIGNATURE-----
Comment: Signed by Raphael Hertzog

iQEzBAEBCgAdFiEE1823g1EQnhJ1LsbSA4gdq+vCmrkFAmO15esACgkQA4gdq+vC
mrkB4AgAj2tYiDW4aQdZfJHr/GGU9rHL99+lTL1VmrXr/I6Z8ggig0JGbTH4Z3lg
QNRu1PbFDJgdO1ho+c0b474iOsT4QTIUu9vHX/enwJ1MiQw8wGDNlsJIS+S33j5n
745p9Y782LTyKaaKPnilHst7pTIGNjmFRlqJr9E8K3gRjZjpTg6HE420epZ6haf1
+gk2npbsy2Psu1LsrbDUCa415COsogar6fpU3Kui3/p8ijT1ED1y9CqoNxATequp
nHkwpnwmi24Y5+RV79SXKW3ECOHTHGKCRWGFtSwCFg0LcAq69cTwnyphXt0gW/+Z
RtG81/jI+mMeRUGsdzdjAVlLK7K75w==
=0po3
-----END PGP SIGNATURE-----
需要注意的是源码包也有依赖（Build-Depends），和那些二进制包依赖完全不同，因为它们需要设置编译软件所需工具的选项后，再来构建二进制包。

当心 不同的命名空间

这里需要注意的是，源码包的名称和它所生成的二进制包的名称之间并没有必然的对应关系。如果你知道每个源码包可能会生成多个二进制包，就很容易理解了。这就是为什么 .dsc 文件有 Source 和 Binary 字段来明确命名源软件包并存储其生成的二进制软件包列表。

文化 为什么要分成几个软件包

通常，一个源代码软件包 (对于一个指定软件来说) 可产生多个二进制软件包。分开多个二进制包，可以满足在不同的环境使用 (部分) 软件。对于一个共享库，安装它后，可以让一个于应用程序工作（如，libc6）；或者安装后，可以用来开发一个新的程序（libc6-dev 就是这样的软件包）。客户端/服务器服务的逻辑也是一样的，我们希望在一台机器上安装服务器部分，而在其他机器上安装客户端部分（例如，openssh-server 和 openssh-client 就是这种情况）。
同样常见的是，文档也以专用软件包的形式提供的：用户可以独立于软件安装文档，也可以随时选择删除文档以节省磁盘空间。此外，这也节省了 Debian 镜像的磁盘空间，因为文档包将在所有架构中共享（而不是在每个架构的文档包中重复）。

洞察不同格式的源码包

本来只有一个原始的软件包格式，像1.0这样的格式，它关联了.orig.tar.gz和.diff.gz“Debian化”的补丁（还有一个变种，由一个单一的.tar.gz归档，当.orig.tar.gz不可用时它会自动使用。）.
自从 Debian 6 Squeeze 以来，Debian 开发者可以选择新的格式来校正历史上旧格式的问题。格式 3.0 (quilt) 可以将多个上游档案组合在相同的源码包中：除了通常的 .orig.tar.gz，还可纳入补充的 .orig-component.tar.gz 档案。这种做法对那些散布在多个上游组件，但只需要单一一个原码包的软件。这些文件还可以使用 xz 而不是 gzip 来压缩，这节省了磁盘空间与网络资源。最后，单一的补丁 .diff.gz 被 .debian.tar.gz 档案取代，它包括编译指示与软件包维护者贡献的一组上游补丁。最后的这些部分以兼容的 quilt 的格式记录，其中 quilt 是实现一系列补丁管理的工具。
.orig.tar.gz 文件包括原开发者提供的源代码。要求 Debian 的软件包维护者不要修改它，以便检查原来的文件与集成后的文件 (比较校验码就知道) 并且尊重其他著者的意愿。
.debian.tar.xz 包含了 Debian 维护者做出的所有修改，特别是添加了 debian 目录，它包含了运行构建一个或多个 Debian 二进制软件包的指示。

工具 解压缩源码包

使用原始软件包时，您可使用 dpkg-source 指令 (从 dpkg-dev 软件包取得) 解压缩它： 
$ dpkg-source -x zim_0.75.1-1.dsc
dpkg-source: info: extracting zim in zim-0.75.1
dpkg-source: info: unpacking zim_0.75.1.orig.tar.gz
dpkg-source: info: unpacking zim_0.75.1-1.debian.tar.xz
可以使用 apt 来下载原码包，并立即将它拆包。然而，这需要适当的 deb-src 出现在 /etc/apt/sources.list 文件内（进一步的细节请参见 第 6.1 节 “编写 sources.list 文件”）。这些用于列出原码包的 “来源”（就是托管一组源码包的服务器）。 
$ apt source zim

Reading package lists... Done
NOTICE: 'zim' packaging is maintained in the 'Git' version control system at:
https://salsa.debian.org/debian/zim.git
Please use:
git clone https://salsa.debian.org/debian/zim.git
to retrieve the latest (possibly unreleased) updates to the package.
Need to get 2,523 kB of source archives.
Get:1 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (dsc) [1,580 B]
Get:2 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (tar) [2,511 kB]
Get:3 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (diff) [10.4 kB]
Fetched 2,523 kB in 0s (12.4 MB/s)
dpkg-source: info: extracting zim in zim-0.75.1
dpkg-source: info: unpacking zim_0.75.1.orig.tar.gz
dpkg-source: info: unpacking zim_0.75.1-1.debian.tar.xz

5.3.2. Debian 中的使用

源码包是 Debian 一切的基础。所有 Debian 软件包都来自源码包，对 Debian 软件包的每一次修改都是对源码包修改的结果。Debian 的维护者们在使用源码包的同时，也知道他们的行为会对二进制包产生什么样的影响。因此，在 Debian 提供的源码包中可以找到他们的劳动成果：你可以很容易地回到源码包，一切都源于源码包。第 15 章 创建 Debian 软件包 包含一些例子。
当一个新版本的源码包到达 Debian 服务器时，它将被不同架构的机器网络用于在 Debian 支持的各种架构上进行编译。
→ https://buildd.debian.org/

进阶阅读 仅含源代码的维护者上传文件

Right after the release of Debian 10 Buster, the Release Team announced that maintainer binary uploads will no longer be accepted for main and all binary packages in this component must be built automatically from mandatory source-only uploads. While binary uploads are still allowed for the contrib and non-free components, we will not focus on this possibility as it should only be the exception.