deb包构建详解

当你需要在Debian或Ubuntu等基于Debian的Linux系统上分发你的应用程序时，你可以使用Deb包（.deb文件）进行构建和分发。Deb包是一种用于Debian系统的软件包格式，它包含了应用程序的二进制文件、配置文件、依赖关系等信息。在本文中，我将为你介绍如何构建Deb包，并提供一个基本的构建流程。

一、deb包构建流程

• 步骤1：安装必要的工具

在开始之前，确保你的系统已经安装了以下必要的工具：

sudo apt-get update
sudo apt-get install dh-make dpkg-dev build-essential
1
2

• 步骤2：创建项目目录结构

在你的项目目录下，创建一个用于构建Deb包的目录结构：

mkdir debian-package
cd debian-package
1
2

• 步骤3：创建Deb包描述文件

在debian-package目录下，创建一个DEBIAN目录，并在其中创建一个control文件，用于描述Deb包的信息：

Package: your-package-name
Version: 1.0
Architecture: all
Maintainer: Your Name 
Description: Your package description
1
2
3
4
5

• 步骤4：将应用程序拷贝到Deb包目录中

将你的应用程序文件（可执行文件、配置文件等）拷贝到debian-package目录中。

• 步骤5：构建Deb包

在debian-package目录下，执行以下命令构建Deb包：

dpkg-deb --build . your-package-name_1.0_all.deb
1

这将在当前目录下生成一个名为your-package-name_1.0_all.deb的Deb包文件。

• 步骤6：测试Deb包

你可以在本地测试你的Deb包，确保它能够正常安装和运行：

sudo dpkg -i your-package-name_1.0_all.deb
1

• 步骤7：分发你的Deb包

你可以将生成的Deb包上传到你的网站、软件仓库，或者通过邮件等方式分发给用户。

以上是一个简单的Deb包构建流程，你可以根据你的应用程序的复杂度和需求进一步定制和优化构建过程。
项目案例地址：https://arv000.blog.csdn.net/article/details/126004176
源码地址：https://github.com/arv000/getcolor

二、deb包构建描述文件详解

2.1 control文件

在Debian的软件包中，control 文件是非常重要的，它包含了软件包的描述信息，如软件包的名称、版本、依赖关系、描述等。下面是一个 control 文件的详细说明：

• 1. Package:
     软件包的名称。这个字段必须是唯一的，它指定了Deb包的名称。
     在Debian和Ubuntu的软件包管理中，Package字段（软件包的名称）是有一些命名规范和限制的。具体来说：

     1. 只能包含小写字母、数字、加号（+）、减号（-）和点号（.）： 字母必须是小写的，不可以包含大写字母。

     2. 不能包含空格和特殊字符： 不能包含空格、下划线、斜杠、反斜杠等特殊字符。

     3. 长度限制： 一般情况下，软件包的名称应该尽量短小，通常不应该超过50个字符。

     4. 应该具有唯一性： 在软件包仓库中，软件包名称必须是唯一的，不可与其他软件包重名。

     遵循这些限制和规范可以确保软件包名称的唯一性，并且避免与系统的其他软件包发生冲突。在创建control文件时，请确保软件包名称满足上述规定。

• 2. Version:
     软件包的版本号。通常遵循 major.minor.patch 的格式。例如：1.0.0
• 3. Architecture:
     软件包适用的体系结构。常见的取值有 i386、amd64、all（表示通用的，与体系结构无关的软件包）。
• 4. Maintainer:
     维护者的信息，包括姓名和邮箱。例如：Maintainer: John Doe
• 5. Description:
     软件包的描述信息。这个字段通常包括软件包的简要介绍、功能特性、用法等。描述信息可能包括多行文本，每行以点号（.`）开头，例如：

  Description: This is a sample package.
   . It demonstrates how to create a Debian package
   . for educational purposes.
  1
  2
  3

• 6. Depends:
     软件包的依赖关系。用于指定安装这个软件包需要满足的其他软件包。例如：

  Depends: libc6 (>= 2.14), libqt5core5a (>= 5.0.1)
  1

这表示该软件包依赖于 libc6 版本大于等于 2.14 和 libqt5core5a 版本大于等于 5.0.1。

• 7. Homepage:
     软件包的官方网站。例如：Homepage: https://example.com
• 8. Section:
     软件包所属的分类。例如：Section: utils
• 9. Priority:
     软件包的优先级。常见的取值包括 required（必需的软件包）和 optional（可选的软件包）。
• 10. Built-Using:
      用于指定软件包编译时所使用的其他软件包。例如：Built-Using: gcc (>= 4.8)
• 11. Pre-Depends:
      软件包的前置依赖关系。与 Depends 类似，但 Pre-Depends 的软件包在安装前就必须满足。

  这些是 control 文件中常见字段的说明。在构建Deb包时，你需要根据你的软件包的需求，适当地填写这些字段。确保 control 文件的格式正确，以便Deb包能够被正确解析和处理。

除了 control 文件，Deb包构建中通常还包含其他一些重要的文件，每个文件都有不同的作用。以下是这些文件的详细说明：

以下是一个简单的control文件的示例，展示了基本的结构和字段。请根据你的软件包的需求修改这些字段，确保它们符合你的软件包的信息。

Package: example-package
Version: 1.0.0
Architecture: amd64
Maintainer: John Doe 
Description: This is an example package.
 This package demonstrates how to create a Debian package
 for educational purposes.
Homepage: https://example.com
Depends: libc6 (>= 2.14), libqt5core5a (>= 5.0.1)
Section: utils
Priority: optional
1
2
3
4
5
6
7
8
9
10
11

2.2 postinst 文件 (post-installation script)

postinst 是安装软件包后执行的脚本。在这个脚本中，你可以进行一些安装后的配置、服务启动等操作。执行该脚本使用root用户权限执行。

2.3 postrm 文件 (post-removal script)

postrm 是移除软件包后执行的脚本。你可以在这个脚本中进行一些清理操作，例如删除配置文件、停止服务等。执行该脚本使用root用户权限执行。

2.4 prerm 文件 (pre-removal script)

prerm 是移除软件包前执行的脚本。在这个脚本中，你可以进行一些准备工作，例如停止服务、备份数据等。执行该脚本使用root用户权限执行。

2.5 preinst 文件 (pre-installation script)

preinst 是安装软件包前执行的脚本。在这个脚本中，你可以进行一些预处理，例如检查依赖关系、备份数据等。执行该脚本使用root用户权限执行。

2.6 rules 文件

rules 文件包含了构建软件包时的构建规则。这个文件通常用于告诉构建系统如何编译和打包软件。
rules 文件是用来指定在构建Deb软件包时的构建规则的文件。这个文件使用make规则的语法，并且通常是根据软件包的需要进行定制的。下面是一个简单的rules文件的示例，展示了基本的结构和语法：

#!/usr/bin/make -f

%:
	dh $@

override_dh_auto_build:
	# 在这里添加构建软件包的命令
	qmake
	make

override_dh_auto_install:
	# 在这里添加安装软件包的命令
	make INSTALL_ROOT=$(CURDIR)/debian/tmp install

override_dh_auto_clean:
	# 在这里添加清理操作的命令
	make distclean
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

在这个示例中，%: 指定了默认的目标，dh $@表示使用Deb Helper工具进行构建。override_dh_auto_build、override_dh_auto_install 和 override_dh_auto_clean 是Deb Helper工具中预定义的目标，你可以在这些目标中添加相应的构建、安装和清理命令。

具体来说：

• override_dh_auto_build 目标用于执行构建软件包的命令。在这个例子中，使用了qmake和make来构建项目。

• override_dh_auto_install 目标用于执行安装软件包的命令。在这个例子中，使用了make INSTALL_ROOT=$(CURDIR)/debian/tmp install来安装软件包。

• override_dh_auto_clean 目标用于执行清理操作的命令。在这个例子中，使用了make distclean来进行清理。

需要注意的是，rules 文件的内容根据你的项目的构建系统和需要进行定制。如果你的项目使用了CMake，那么相应的构建命令和路径也会不同。请根据你的项目具体情况来修改rules 文件中的命令和路径，以确保Deb软件包能够正确构建。

2.7 changelog 文件

changelog 文件用于记录软件包的版本历史和变更信息。它是一个Debian软件包的重要部分，包含了软件包的版本号、发布日期、作者和变更日志。以下是changelog`文件的基本格式和创建方法：

• *Changelog 格式：

  每一个版本的变更记录通常按照以下格式组织：

  your-package-name (version) distribution; urgency=urgency
  
    * Changes here...
  
   -- Maintainer Name   Fri, 01 Jan 2021 12:00:00 +0000
  1
  2
  3
  4
  5

  • your-package-name： 你的软件包的名称。
  • version： 软件包的版本号。
  • distribution： 软件包支持的发行版（如stable、unstable等）。
  • urgency： 变更的紧急程度（可选，通常是low、medium或high）。
  • Changes here...： 该版本的变更日志。

• Changelog 示例：

  example-package (1.0.0-1) stable; urgency=medium
  
    * Initial release.
    * Added feature A.
    * Fixed issue with feature B.
  
   -- John Doe   Fri, 01 Jan 2021 12:00:00 +0000
  1
  2
  3
  4
  5
  6
  7

• 创建 Changelog 文件：

  你可以使用文本编辑器手动创建或编辑changelog文件，确保按照上述格式编写变更记录。另外，还有一些工具可以自动生成changelog文件，比如 dch（Debian ChangeLog Helper）工具。

  如果你的系统上没有安装dch工具，可以通过以下命令安装：

  sudo apt-get update
  sudo apt-get install devscripts
  1
  2

  然后，使用以下命令在软件包的源代码目录中生成一个新的changelog文件或编辑现有的changelog文件：

  dch -i
  1

  这个命令会打开一个编辑器，让你输入变更记录。完成后，保存并关闭编辑器，dch工具会为你自动生成合适格式的changelog文件。

三、常见问题

在构建Deb包时，可能会遇到各种各样的错误。以下是一些常见的错误信息以及可能的处理方法：

1. 错误信息：dpkg-shlibdeps 报错

dpkg-shlibdeps: error: no dependency information found for /path/to/library
1

处理方法：
这个错误通常表示在Deb包的控制文件（control文件）中缺少必要的依赖信息。请检查Depends字段，确保列出了所有需要的依赖库。

2. 错误信息：dpkg-gencontrol: error: current build architecture is not included**

dpkg-gencontrol: error: current build architecture is not included
1

处理方法：
这个错误通常是由于在control文件的Architecture字段中指定了一个不支持的架构。请确保Architecture字段的值正确，符合当前系统的架构（如amd64、i386等）。

3. 错误信息：dpkg-source: error: aborting due to unexpected upstream changes**

dpkg-source: error: aborting due to unexpected upstream changes
1

处理方法：
这个错误通常是由于在构建Deb包前，源代码目录中存在未提交的变更。确保源代码目录是干净的，没有未提交的更改，然后再尝试构建Deb包。

4. 错误信息：dh: error: unable to load addon : Can’t locate .pm in @INC

dh: error: unable to load addon : Can't locate .pm in @INC
1

处理方法：
这个错误通常是由于dh工具无法找到指定的插件。请检查你的debian/rules文件，确保插件的名称和路径正确。如果你使用了自定义的插件，请确保它们被正确安装并且在debian/rules文件中被正确引用。

5. 错误信息：dpkg-deb: building package ‘package-name’ in ‘/path/to/package-name.deb’.

dpkg-deb: building package 'package-name' in '/path/to/package-name.deb'.
dpkg-deb: error: failed to read package info file '/path/to/package-name/DEBIAN/control': Is a directory
1
2

处理方法：
这个错误通常是由于构建Deb包时指定的路径错误。请确保你在正确的目录下执行构建命令，并且debian目录下包含了正确的control文件。

6. 错误信息：dpkg-source: error: source package has two conflicting values - in and

dpkg-source: error: source package has two conflicting values -  in  and 
1

处理方法：
这个错误通常是由于在Debian源码包中的不同文件中存在冲突的字段值。请检查并修复源代码包中的相关文件，确保所有的字段值一致。

7. 错误信息：dpkg-source: error: cannot represent change to as it is not in the patch’s header

dpkg-source: error: cannot represent change to  as it is not in the patch's header
1

处理方法：
这个错误通常是由于patch文件中的内容与实际文件不匹配。请检查并更新patch文件，确保其中的变更与实际文件内容一致。

8. 错误信息：E: Sub-process /usr/bin/dpkg returned an error code (1)

E: Sub-process /usr/bin/dpkg returned an error code (1)
1

处理方法：
这个错误通常是由于前面某个步骤的错误导致后续步骤无法执行。请仔细检查之前的错误信息，找出根本原因，并按照前述的方法逐个解决错误。

9. 错误信息：dh: unable to load addon : Can’t locate .pm in @INC

dh: unable to load addon : Can't locate .pm in @INC
1

处理方法：
这个错误通常是由于构建系统无法找到指定的插件。请检查你的debian/rules文件，确保插件的名称和路径正确。如果使用了自定义的插件，请确保它们被正确安装并在debian/rules文件中正确引用。

10. 错误信息：dpkg-deb: error: control directory has bad permissions

dpkg-deb: error: control directory has bad permissions
1

处理方法：
这个错误通常是由于debian/DEBIAN目录的权限设置问题。请确保debian/DEBIAN目录及其下的文件具有正确的权限（通常为755）。你可以使用以下命令修复权限问题：

chmod 755 debian/DEBIAN
1

在处理以上错误时，要仔细阅读错误信息，了解具体的错误原因。然后，根据错误信息的内容，检查相应的配置文件，确保配置正确。如果需要，可以查阅相关文档、社区讨论等资源，以获取更多的帮助。

在处理以上错误时，首先要仔细阅读错误信息，了解具体的错误原因。然后，根据错误信息的内容，检查相应的配置文件（如control文件、debian/rules文件等），确保配置正确。在调试过程中，还可以查阅相关文档、社区讨论等资源，以获取更多的帮助。