如何定制Debian软件包

定制 Debian 软件包的实用流程

一 准备与规划

• 明确目标与范围：是做全新打包，还是修改现有包，或仅做二进制重打包；是否需要支持多架构（Architecture: any/all）。
• 检查是否已有人打包：使用aptitude、wnpp-alert（来自 devscripts）查看包状态，避免重复劳动；若需接手或新建，遵循 Debian 的流程与政策（许可证需兼容 DFSG，并准备 ITP 等）。
• 准备工具链：安装构建所需基础工具（如 build-essential、dpkg-dev、debhelper、fakeroot、dh-make），为后续构建与校验打底。

二 三种常见定制路径

• 路径A 从零构建源码包（推荐）

  1. 准备上游源码包：规范命名为package_version.orig.tar.gz，在源码根目录创建 debian/ 并生成打包元数据（如使用 dh_make），形成 package_version-revision.dsc 等；构建产物为 package_version-revision_arch.deb。
  2. 定制 debian 控制文件：至少包含 control、changelog、copyright、rules；按需添加 install、links、compat、source/format、watch 等。
  3. 调整构建与安装：在 debian/rules 中使用 debhelper 与 make/CMake 流程，必要时在 debian/install 指定安装映射（如：myapp /usr/bin/），在 debian/links 建立可执行链接（如：/usr/lib/myapp/myapp /usr/bin/myapp）。
  4. 构建与校验：使用 dpkg-buildpackage -uc -us 构建；仅做快速验证可用 fakeroot debian/rules binary；安装测试用 sudo apt install ./xxx.deb 或 dpkg -i。
  5. 版本与命名：遵循 Debian 对包名、上游版本与 Debian 修订号的规则；必要时在 debian/changelog 记录变更。

• 路径B 修改现有包再打包（适合小改动）

  1. 解包：用 dpkg -X pkg.deb 目标目录 解压文件树；用 dpkg -e pkg.deb 目标目录/DEBIAN 提取控制信息。
  2. 定制：按需修改程序文件或 DEBIAN/ 下的控制/脚本（如 postinst 设置环境变量、创建链接、处理 divert）。
  3. 重打包：回到上层目录执行 dpkg -b 目标目录 新包名.deb，安装测试并验证行为与依赖。

• 路径C 极简“手工包”（仅文件分发，不编译）

  1. 建立目录树：创建 mydeb/DEBIAN/control 与目标路径（如 usr/bin、etc/mydeb）。
  2. 编写 control：至少包含 Package、Version、Architecture、Maintainer、Description；如需环境变更，在 DEBIAN/postinst 中写入（如导出环境变量到 /etc/profile.d/）。
  3. 打包与安装：用 dpkg-deb --build mydeb 生成 mydeb.deb，再用 apt 或 dpkg 安装。

三 关键文件与常用定制点

• 核心控制文件
  • debian/control：定义源码与二进制包的元信息；常用字段有 Source、Package、Version、Section、Priority、Architecture、Depends、Maintainer、Description、Build-Depends、Standards-Version、Homepage；脚本类包常用 Architecture: all，C/Go 等编译产物用 Architecture: any。
  • debian/changelog：记录版本变更与维护者信息，影响版本排序与升级策略。
  • debian/copyright：声明许可证与版权归属，需与 DFSG 兼容。
  • debian/rules：可执行的主构建脚本，常用 debhelper 与 make/CMake 流程；可覆盖编译/安装参数。
  • debian/install / debian/links：声明“文件→目标路径”的安装映射与符号链接，便于精确布局。
  • debian/postinst / preinst / postrm / prerm：安装/卸载/升级前后钩子，适合做用户组创建、服务启用、环境变量写入、divert 处理等。
  • 其他：compat、source/format、watch 等按需配置。

四 实战示例

• 示例A 将 Python 脚本打成 deb

  1. 安装工具：sudo apt-get install build-essential debmake。
  2. 生成模板：在源码目录执行 debmake -e you@example.com -p mydeb -u 1.0.0 -n -x1，得到 debian/ 骨架。
  3. 定制：在 debian/control 设置包名、版本、架构（如 all）、依赖（如 python3）；在 debian/install 写入脚本与库路径（如：script.py /usr/lib/mydeb）；在 debian/links 建立命令链接（如：/usr/lib/mydeb/script.py /usr/bin/mydeb）。
  4. 构建与安装：执行 dpkg-buildpackage -uc -us 生成 .deb，用 apt install ./mydeb_1.0.0-1_all.deb 安装测试。

• 示例B C 程序使用 Autotools 的标准流程

  1. 生成构建系统：在项目根目录执行 autoreconf -ivf 生成 configure 与 Makefile 基础设施。
  2. 创建 debian 目录：执行 dh_make --createorig -s -p printdate 生成模板。
  3. 定制安装：在 debian/install 写入可执行文件映射（如：printdate /usr/bin/）。
  4. 构建与安装：执行 dpkg-buildpackage -b --no-sign 生成 printdate_0.1-1_amd64.deb，安装后可在 /usr/bin/printdate 运行。

五 质量保障与常见问题

• 快速迭代与调试：用 fakeroot debian/rules build 与 fakeroot debian/rules binary 做局部构建；避免全量重来可用 dpkg-buildpackage -nc -uc -us 跳过清理；大文件打包可用 pigz 加速压缩。
• 环境与权限：在 DEBIAN/postinst 中设置环境变量（如写入 /etc/profile.d/），注意脚本需 #!/bin/sh 且 chmod +x；涉及文件冲突可用 dpkg-divert 做转移。
• 依赖与架构：解释型脚本常用 Architecture: all；C/Go 等原生二进制用 Architecture: any；依赖建议显式声明并配合 ${shlibs:Depends}、${misc:Depends} 使用。
• 命名与版本：遵循 Debian 对包名与版本号字符集、顺序与比较规则；必要时在 debian/changelog 记录变更，确保升级路径正确。