Debian 维护者指南 Osamu Aoki 杨博远 Chinese zh-cn Translation (2017-2019)  Fonzie Huang Chinese zh-cn Translation (2018)  xiao sheng wen(肖盛文) Chinese zh-cn Translation (2021)  Copyright © 2014-2021 Osamu Aoki Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without     restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:     The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND     NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.     本指南在撰写过程中参考了以下几篇文档： * “Making a Debian Package (AKA the Debmake Manual)”, 版权所有 © 1997 Jaldhar Vyas. * “The New-Maintainer’s Debian Packaging Howto”, 版权所有 ©     1997 Will Lowe. * “Debian New Maintainers’ Guide”, 版权所有 © 1998-2002 Josip Rodin, 2005-2017 Osamu Aoki, 2010 Craig Small 以及 2010 Raphaël Hertzog。     本指南的最新版本应当可以在下列位置找到：     * 在 debmake-doc 软件包中，以及 * 位于 Debian 文档网站。 Abstract 本篇《Debian 维护者指南》（2023-11-10）教程文档面向普通 Debian 用户和 未来的开发者，描述了使用 debmake 命令构建 Debian 软件包的方法。 本指南注重描述现代的打包风格，同时提供了许多简单的示例。 * POSIX shell 脚本打包 * Python3 脚本打包 * C 和 Makefile/Autotools/CMake * 含有共享库的多个二进制软件包的打包，等等。 本篇《Debian 维护者指南》可看作《Debian 新维护者手册》的继承文档。 --------------------------------------------------------------------- Table of Contents 前言 1. 概览 2. 预备知识 2.1. Debian 社区的工作者 2.2. 如何做出贡献 2.3. Debian 的社会驱动力 2.4. 技术提醒 2.5. Debian 文档 2.6. 帮助资源 2.7. 仓库状况 2.8. 贡献流程 2.9. 新手贡献者和维护者 3. 工具的配置 3.1. 电子邮件地址 3.2. mc 3.3. git 3.4. quilt 3.5. devscripts 3.6. sbuild 3.7. git-buildpackage 3.8. HTTP 代理 3.9. 私有 Debian 仓库 3.10. Virtual machines 3.11. Local network with virtual machines 4. 简单例子 4.1. Packaging tarball 4.2. 大致流程 4.3. 什么是 debmake？ 4.4. 什么是 debuild？ 4.5. 第一步：获取上游源代码 4.6. 第二步：使用 debmake 产生模板文件 4.7. 第三步：编辑模板文件 4.8. 第四步：使用 debuild 构建软件包 4.9. 第三步（备选）：修改上游源代码 4.9.1. 使用 diff -u 处理补丁 4.9.2. 使用 dquilt 处理补丁 4.9.3. 使用 dpkg-source --commit 处理补丁 5. 基本内容 5.1. 打包工作流 5.1.1. debhelper 软件包 5.2. Historical perspective of Debian packaging practices 5.3. Future perspective on Debian packaging practices 5.4. 软件包名称和版本 5.5. 原生 Debian 软件包 5.6. debian/rules 5.6.1. dh 5.6.2. 简单的 debian/rules 5.6.3. 自定义 debian/rules 5.6.4. debian/rules 中的变量 5.6.5. 可重现的构建 5.7. debian/control 5.7.1. Debian 二进制软件包的拆分 5.7.2. Substvar 5.7.3. binNMU 安全 5.8. debian/changelog 5.9. debian/copyright 5.10. debian/patches/* 5.10.1. dpkg-source -x 5.10.2. dquilt 和 dpkg-source 5.11. debian/upstream/signing-key.asc 5.12. debian/watch 和 DFSG 5.13. 其它 debian/* 文件 5.14. Debian 打包的定制化 5.15. 在版本控制系统中进行记录（标准） 5.16. 在版本控制系统中进行记录（备选方案） 5.17. 构建软件包时排除不必要的内容 5.17.1. 使用 debian/rules clean 进行修复 5.17.2. 使用版本控制系统修复 5.17.3. 使用 extend-diff-ignore 修复 5.17.4. 使用 tar-ignore 修复 5.18. 上游构建系统 5.18.1. Autotools 5.18.2. CMake 5.18.3. Meson 5.18.4. Python distutils 5.19. 调试信息 5.19.1. 新的 -dbgsym 软件包（Stretch 9.0 或更新） 5.20. 库软件包 5.20.1. 库符号 5.20.2. 库变迁 5.21. debconf 5.22. 多体系结构 5.22.1. 多架构库路径 5.22.2. 多架构头文件路径 5.22.3. 多架构支持下的 *.pc 文件路径 5.23. 编译加固 5.24. 持续集成 5.25. Other new requirements 5.26. 自举 5.27. 错误报告 6. debmake 选项 6.1. 快捷选项（-a，-i） 6.1.1. Python 模块 6.2. Snapshot upstream tarball (-d, -t) 6.3. debmake -cc 6.4. debmake -k 6.5. debmake -j 6.6. debmake -x 6.7. debmake -P 6.8. debmake -T 7. 提示 7.1. debdiff 7.2. dget 7.3. debc 7.4. piuparts 7.5. debsign 7.6. dput 7.7. bts 7.8. git-buildpackage 7.8.1. gbp import-dscs --debsnap 7.8.2. 上游 git 仓库 7.9. dgit 7.9.1. Snapshot upstream tarball (alternative git deborig approach) 7.10. chroot 7.11. 新的 Debian 版本 7.12. 新上游版本 7.12.1. uupdate + tarball 7.12.2. uscan 7.12.3. gbp 7.12.4. gbp + uscan 7.13. 3.0 源代码格式 7.14. CDBS 7.15. 在 UTF-8 环境下构建 7.16. UTF-8 转换 7.17. 上传 orig.tar.gz 7.18. 跳过的上传 7.19. 高级打包 7.20. 其他发行版 7.21. 除错 8. 更多示例 8.1. 挑选最好的模板 8.2. 无 Makefile（shell，命令行界面） 8.3. Makefile（shell，命令行界面） 8.4. setup.py（Python3，命令行界面） 8.5. Makefile（shell，图形界面） 8.6. setup.py（Python3，图形界面） 8.7. Makefile（单个二进制软件包） 8.8. Makefile.in + configure（单个二进制软件包） 8.9. Autotools（单个二进制文件） 8.10. CMake（单个二进制软件包） 8.11. Autotools（多个二进制软件包） 8.12. CMake（多个二进制软件包） 8.13. 国际化 8.14. 细节 A. debmake(1) 手册页 A.1. 名称 A.2. 概述 A.3. 描述 A.3.1. 可选参数： A.4. 示例 A.5. 帮助软件包 A.6. 注意事项 A.7. 除错 A.8. 作者 A.9. 许可证 A.10. 参见 前言 如果您在某些方面算得上是有经验的 Debian 用户 ^[1] 的话，您可能遇上过 这样的情况： * 您想要安装某一个软件包，但是该软件在 Debian 仓库中尚不存在。 * 您想要将一个 Debian 软件包更新为上游的新版本。 * 您想要添加某些补丁来修复某个 Debian 软件包中的缺陷。 如果您想要创建一个 Debian 软件包来满足您的需求，并将您的工作与社区分 享，您便是本篇指南的目标读者，即未来的 Debian 维护者。^[2] 欢迎来到 Debian 社区。 Debian 是一个大型的、历史悠久的志愿者组织。因此，它具有许多需要遵守的 社会上和技术上的规则和惯例。Debian 也开发出了一长串的打包工具和仓库维 护工具，用来构建一套能够解决各种技术目标的二进制软件包： * 跨多个架构构建的软件包（Section 5.6.4, “debian/rules 中的变量”） * 可重现的构建（Section 5.6.5, “可重现的构建”） * 在明确指定软件包依赖和补丁情况下干净地构建（Section 5.7, “debian/ control”, Section 5.10, “debian/patches/*”, Section 7.10, “chroot”） * 拆分多个二进制软件包的最佳实践（Section 5.7.1, “Debian 二进制软件 包的拆分”） * 平滑的程序库迁移（Section 5.20.2, “库变迁”） * 交互式安装定制（Section 5.21, “debconf”） * 多架构（multiarch）支持（Section 5.22, “多体系结构”） * 使用特定的编译选项进行安全增强（Section 5.23, “编译加固”） * 持续集成（Section 5.24, “持续集成”） * 自举（Section 5.26, “自举”） * …… 这些目标也许会让很多新近参与进 Debian 工作中的潜在 Debian 维护者感到 迷茫而不知所措。本篇指南尝试为这些目标提供一个着手点，方便读者开展工 作。它具体描述了以下内容： * 作为未来潜在的维护者，您在参与 Debian 工作之前应该了解的东西。 * 制作一个简单的 Debian 软件包大概流程如何。 * 制作 Debian 软件包时有哪些规则。 * 制作 Debian 软件包的小窍门。 * 在某些典型场景下制作 Debian 软件包的示例。 作者在更新原有的使用 dh-make 软件包的“新维护者手册”时感受到了文档的局 限性。因此，作者决定创建一个替代工具并编写其对应的文档以解决某些现代 的需求。其成果便是 debmake（当前版本：4.4.0)）软件包，以及这篇更新的 “Debian 维护者指南”，可从 debmake-doc（当前版本：1.17-9）软件包获取。 许多杂项事务和小提示都集成进了 debmake 命令，以使本指南内容简单易懂。 本指南同时提供了许多打包示例。 +-----------------------------------------------------+ |Caution | | | |合适地创建并维护 Debian 软件包需要占用许多时间。 | |Debian 维护者在接受这项挑战时一定要确保既能精通技术又| |能勤勉投入精力。 | +-----------------------------------------------------+ 某些重要的主题会详细进行说明。其中某些可能看起来和您没什么关系。请保 持耐心。某些边角案例会被跳过。某些主题仅使用外部链接提及。这些都是有 意的行文安排，目标是让这份指南保持简单而可维护。 --------------------------------------------------------------------- ^[1] 您的确需要对 Unix 编程有所了解，但显然没必要是这方面的天才。     在 Debian 参考手册中，您可以了解到使用 Debian 系统的一些基本方法 和关于 Unix 编程的一些指引。     ^[2] 如果您对分享 Debian 软件包不感兴趣，您当然可以在本地环境中将 上游的源码包进行编译并安装至 /usr/local 来解决问题。 Chapter 1. 概览 对 package-1.0.tar.gz，一个包含了简单的、符合 GNU 编码标准和 FHS     （文件系统层级规范）的 C 语言源代码的程序来说，它在 Debian 下打包 工作可以按照下列流程，使用 debmake 命令进行。 $ tar -xvzf package-1.0.tar.gz $ cd package-1.0     $ debmake ... Make manual adjustments of generated configuration files $ debuild 如果跳过了对生成的配置文件的手工调整流程，则最终生成的二进制软件     包将缺少有意义的软件包描述信息，但是仍然能为 dpkg 命令所使用，在 本地部署环境下正常工作。 Caution     这里的 debmake 命令只提供一些不错的模板文件。如果生成的软件包需要 发布出去供公众使用的话，这些模板文件必须手工调整至最佳状态以遵从 Debian 仓库的严格质量标准。     如果您在 Debian 打包方面还是个新手的话，此时不要过多在意细节问题 ，请先确立一个大致流程的印象。 如果您曾经接触过 Debian 打包工作，您会注意到这和 dh_make 命令很像     。这是因为 debmake 命令设计时便旨在替代历史上由 dh_make 命令所提 供的功能。^[3]     debmake 命令设计提供如下特性与功能： * 现代的打包风格 + debian/copyright: DEP-5 compliant + debian/control：substvar 支持、multiarch 支持、多个二进制 软件包、…… + debian/rules：dh 语法、编译器加固选项、…… * 灵活性 + 许多选项（Section 5.7.1.1, “debmake -b”、Chapter 6, debmake 选项、Appendix A, debmake(1) 手册页）     * 合理的默认行为 + 执行过程不中断，输出干净的结果 + 生成多架构支持（multiarch）的软件包，除非明确指定了 -m 选 项。 + 生成非原生 Debian 软件包，使用“3.0 (quilt)”格式，除非明确 指定了 -n 选项。 * 额外的功能 + 根据当前源代码对 debian/copyright 文件进行验证（ Section 6.4, “debmake -k”） The debmake command delegates most of the heavy lifting to its     back-end packages: debhelper, dpkg-dev, devscripts, sbuild, schroot, etc. Tip     请确保将 -b、-f、-l 和 -w 选项的参数使用引号合适地保护起来，以避 免 shell 环境的干扰。 Tip     非原生软件包是标准的 Debian 软件包。 Tip     本文档中所有软件包构建示例的详细日志可以由 Section 8.14, “细节” 一段给出的操作来获取。 Note     所产生的 debian/copyright 文件，以及 -c（Section 6.3, “debmake -cc”）和 -k（Section 6.4, “debmake -k”）选项的输出都涉及了对版权 和授权信息的启发式操作。它们具有局限性，可能会输出某些错误的结果 。 --------------------------------------------------------------------- ^[3] 历史上还存在过 deb-make 命令，它在 dh_make 之前曾经流行过。     当前的 debmake 软件包的版本从 4.0 起始，其目的便是避免和废弃的 debmake 软件包的版本产生重叠。旧有的对应软件包提供了 deb-make 命 令。 Chapter 2. 预备知识     这里给出您在投入 Debian 相关工作之前应当理解掌握的一些必备的预备 知识。 2.1. Debian 社区的工作者     在 Debian 社区中有这几类常见的角色： * 上游作者（upstream author）：程序的原始作者。 * 上游维护者（upstream maintainer）：目前在上游维护程序代码的人 。 * 软件包维护者（maintainer）：制作并维护该程序 Debian 软件包的 人。     * 赞助者（sponsor）：帮助维护者上传软件包到 Debian 官方仓库的人 （在通过内容检查之后）。 * 导师（mentor）：帮助新手维护者熟悉和深入打包的人。 * Debian 开发者（DD, Debian Developer）：Debian 社区的官方成员 。DD 拥有向 Debian 官方仓库上传的全部权限。 * Debian 维护者（Debian Maintainer, DM）：拥有对 Debian 官方仓 库部分上传权限的人。 注意，您不可能在一夜之间成为 Debian 开发者（DD），因为成为 DD 所     需要的远不只是技术技巧。不过别因此而气馁，如果您的软件包对其他人 有用，您可以当这个软件的软件包维护者，然后通过一位赞助者来上传这 份软件，或者您可以申请成为 Debian 维护者。 还有，要成为 Debian 开发者不一定要创建新软件包。对已有软件做出贡     献也是成为 Debian 开发者的理想途径。眼下正有很多软件包等着好的维 护者来接手（参见 Section 2.8, “贡献流程”）。 2.2. 如何做出贡献     请参考下列文档来了解应当如何为 Debian 作出贡献： * 您如何协助 Debian？（官方） * The Debian GNU/Linux FAQ, 第 13 章 - “为 Debian 项目捐赠”（半     官方） * Debian Wiki, HelpDebian（补充内容） * Debian 新成员站点（官方） * Debian Mentors FAQ（补充内容） 2.3. Debian 的社会驱动力     为做好准备和 Debian 进行交互，请理解 Debian 的社会动力学： * 我们都是志愿者。 + 任何人都不能把事情强加给他人。 + 您应该主动地做自己想做的事情。 * 友好的合作是我们前行的动力。 + 您的贡献不应致使他人增加负担。     + 只有当别人欣赏和感激您的贡献时，它才有真正的价值。 * Debian 并不是一所学校，在这里没有所谓的老师会自动地注意到您。 + 您需要有自学大量知识和技能的能力。 + 其他志愿者的关注是非常稀缺的资源。 * Debian 一直在不断进步。 + Debian 期望您制作出高质量的软件包。 + 您应该随时调整自己来适应变化。     在这篇指南之后的部分中，我们只关注打包的技术方面。因此，请参考下 面的文档来理解 Debian 的社会动力学：     * Debian: 17 年的自由软件、“实干主义”、和民主（前任 DPL 制作的 介绍性幻灯片） 2.4. 技术提醒     这里给出一些技术上的建议，参考行事可以让您与其他维护者共同维护软 件包时变得更加轻松有效，从而让 Debian 项目的输出成果最大化。 * 让您的软件包容易除错（debug）。 + 保持您的软件包简单易懂。 + 不要对软件包过度设计。     * 让您的软件包拥有良好的文档记录。 + 使用可读的代码风格。 + 在代码中写注释。 + 格式化代码使其风格一致。 + 维护软件包的 git 仓库 ^[4]。 Note     对软件进行除错（debug）通常会比编写初始可用的软件花费更多的时间。 2.5. Debian 文档     Please make yourself ready to read the pertinent part of the latest Debian documentation to generate perfect Debian packages: * 《Debian 政策手册》 + The official “must follow” rules (https://www.debian.org/ doc/devel-manuals#policy) * “Debian 开发者参考”     + The official “best practice” document (https:// www.debian.org/doc/devel-manuals#devref) * “Guide for Debian Maintainers” — this guide + A “tutorial reference” document (https://www.debian.org/ doc/devel-manuals#debmake-doc) All these documents are published to https://www.debian.org using the unstable suite versions of corresponding Debian packages. If     you wish to have local accesses to all these documents from your base system, please consider to use techniques such as apt-pinning and chroot (Section 7.10, “chroot”).^[5]     如果本指南文档的内容与官方的 Debian 文档有所冲突，那么官方的那些 总是对的。请使用 reportbug 工具向 debmake-doc 软件包报告问题。     这里有一些替代性的教程文档，您可以与本指南一起阅读进行参考： * “Debian 新维护者手册”（较旧） + https://www.debian.org/doc/devel-manuals#maint-guide + https://packages.qa.debian.org/m/maint-guide.html * “Debian 打包教程”     + https://www.debian.org/doc/devel-manuals# packaging-tutorial + https://packages.qa.debian.org/p/packaging-tutorial.html * “Ubuntu 打包指南”（Ubuntu 基于 Debian。） + http://packaging.ubuntu.com/html/ Tip     When reading these tutorials, you should consider using the debmake command in place of the dh_make command. 2.6. 帮助资源     在您决定在某些公共场合问出您的问题之前，请先做好自己能做到的事情 ，例如，阅读能找到的文档： * 软件包的信息可以使用 aptitude、apt-cache 以及 dpkg 命令进行查 看。 * 所有相关软件包在 /usr/share/doc/软件包名目录下的文件。     * 所有相关命令在 man 命令下输出的内容。 * 所有相关命令在 info 命令下输出的内容。 * debian-mentors@lists.debian.org 邮件列表存档的内容。 * debian-devel@lists.debian.org 邮件列表存档的内容。 要获取您所需要的信息，一种有效的方法是在网页搜索引擎中构建类似“关     键字 site:lists.debian.org”这样具有限制条件的搜索字符串来限定搜索 的域名。 制作一个小型测试用软件包也是了解打包细节的一个好办法。对当前已有     的维护良好的软件包进行检查则是了解其他人如何制作软件包的最好方法 。     如果您对打包仍然存在疑问，您可以使用以下方式与他人进行沟通： * debian-mentors@lists.debian.org 邮件列表。（这个邮件列表为专 为新手答疑解惑。） * debian-devel@lists.debian.org 邮件列表。（这个邮件列表针对熟 练用户和高级开发者。） * IRC（互联网中继聊天）例如 #debian-mentors。 * 专注某个特定软件包集合的团队。（完整列表请见 https://     wiki.debian.org/Teams） * 特定语言的邮件列表。 + debian-devel-{french,italian,portuguese,spanish} @lists.debian.org + debian-chinese-gb@lists.debian.org（该邮件列表用于一般的 （简体）中文讨论。） + debian-devel@debian.or.jp     如果您在做好功课后能在这些场合中合适地提出您的疑问的话，那些更有 经验的 Debian 开发者会很愿意帮助您。 Caution     Debian 的开发是一个不断变动的目标。您在网上找到的某些信息可能是过 时的、不正确的或者不适用的，使用时请留意。 2.7. 仓库状况     请了解 Debian 仓库的当前状况。 * Debian 已经包含了绝大多数种类程序的软件包。     * Debian 仓库内软件包的数量是活跃维护者的数十倍。 * 遗憾的是，某些软件包缺乏维护者的足够关注。     因此，对已经存在于仓库内的软件包做出贡献是十分欢迎的（这也更有可 能得到其他维护者的支持和协助上传）。 Tip     来自 devscripts 软件包的 wnpp-alert 命令可以检查已安装软件中需要 接手或已被丢弃的软件包。 Tip     The how-can-i-help package can show opportunities for contributing to Debian on packages installed locally. 2.8. 贡献流程     这里使用类 Python 伪代码，给出了向 Debian 贡献名为 program 的软件 所走的贡献流程： if exist_in_debian(program): if is_team_maintained(program): join_team(program) if is_orphaned(program): # maintainer: Debian QA Group adopt_it(program) elif is_RFA(program): # Request for Adoption adopt_it(program) else: if need_help(program): contact_maintainer(program) triaging_bugs(program) preparing_QA_or_NMU_uploads(program) else: leave_it(program) else: # new packages if not is_good_program(program): give_up_packaging(program)     elif not is_distributable(program): give_up_packaging(program) else: # worth packaging if is_ITPed_by_others(program): if need_help(program): contact_ITPer_for_collaboration(program) else: leave_it_to_ITPer(program) else: # really new if is_applicable_team(program): join_team(program) if is_DFSG(program) and is_DFSG(dependency(program)): file_ITP(program, area="main") # This is Debian elif is_DFSG(program): file_ITP(program, area="contrib") # This is not Debian else: # non-DFSG file_ITP(program, area="non-free") # This is not Debian package_it_and_close_ITP(program)     其中： * 对 exist_in_debian() 和 is_team_maintained()，需检查： + aptitude 命令 + Debian 软件包网页 + 团队 * 对 is_orphaned()、is_RFA() 和 is_ITPed_by_others()，需检查： + wnpp-alert 命令的输出。 + 需要投入精力和未来的软件包（WNPP） + Debian 缺陷报告记录：在 unstable 版本中 wnpp 伪软件包的缺 陷记录 + 需要“关爱”的 Debian 软件包     + 基于 debtags 浏览 wnpp 缺陷记录 * 对于 is_good_program()，请检查： + 这个程序应当有用。 + 这个程序不应当向 Debian 系统引入安全和维护上的问题。 + 这个程序应当有良好的文档，其源代码需要可被理解（即，未经 混淆）。 + 这个程序的作者同意软件被打包，且对 Debian 态度友好。^[6] * 对 is_it_DFSG()，及 is_its_dependency_DFSG()，请检查： + Debian 自由软件指导方针（DFSG）。 * 对 is_it_distributable()，请检查： + 该软件必须有一个许可证，其中应当允许软件被发行。 您或是需要填写并提交一份 ITP，或是需要“收养”一个软件包并开始为其     工作。请见“Debian 开发者参考（Debian Developer's Reference）”文档 ：     * 5.1. 新软件包。 * 5.9. 移动、删除、重命名、丢弃、接手和重新引入软件包。 2.9. 新手贡献者和维护者 新手贡献者和维护者可能想知道在开始向 Debian 进行贡献之前需要事先     学习哪些知识。根据您个人的侧重点不同，下面有我的一些建议供您参考 ： * 打包 + POSIX shell 和 make 的基本知识。 + 一些 Perl 和 Python 的入门知识。     * 翻译 + 基于 PO 的翻译系统的工作原理和基本知识。 * 文档 + 文本标记语言的基础知识（XML、ReST、Wiki 等）。     新手贡献者和维护者可能想知道从哪里开始向 Debian 进行贡献。根据您 掌握的技能，下面有我的一些建议供您参考： * POSIX shell、Perl 和 Python 的技巧： + 向 Debian 安装器提交补丁。 + Send patches to the Debian packaging helper scripts such as devscripts, sbuild, schroot, etc. mentioned in this document. * C 和 C++ 技能：     + 向具有 required 和 important 优先级的软件包提交补丁。 * 英语之外的技能： + 向 Debian 安装器项目提交补丁。 + 为具有 required 和 important 优先级的软件包中的 PO 文件提 交补丁。 * 文档技能： + 更新 Debian 维基（Wiki）中的内容。 + 向已有的 Debian 文档提交补丁。     这些活动应当能让您在各位 Debian 社区成员之间得到存在感，从而建立 您的信誉与名气。     新手维护者应当避免打包具有潜在高度安全隐患的程序： * setuid 或 setgid 程序     * 守护进程（daemon）程序 * 安装至 /sbin/ 或 /usr/sbin/ 目录的程序     在积累足够的打包经验后，您可以再尝试打包这样的程序。 ---------------------------------------------------------------------     ^[4] 绝大多数 Debian 维护者使用 git 而非其它版本控制系统，如 hg、 bzr 等等。 ^[5] It is unwise to run your base system under the pure unstable suite even for the development system. Normally, most package development activities use unstable chroot as in Section 7.10,     “chroot”. By using virtualization, you can test demanding situation such as the full Desktop system, network daemons, and system installer in the unstable suite environment even from the base system running the stable suite.     ^[6] 这一条不是绝对的要求，但请注意：遇上不友好的上游可能需要大家 为此投入大量精力，而一个友好的上游则能协助解决程序的各类问题。 Chapter 3. 工具的配置     build-essential 软件包必须在构建环境内预先安装。     devscripts 软件包应当安装在维护者的工作环境中。 Although this is not necessarily an absolute requirement, it is a good idea to install and set up all of the popular set of packages mentioned in this chapter in the maintainer environment.     This enables us to share the common baseline working environment. . Please install the tools mentioned in the Overview of Debian Maintainer Tools in the “Debian Developer’s Reference”, as needed, too. Caution     这里展示的工具配置方式仅作为示例提供，可能与系统上最新的软件包相 比有所落后。Debian 的开发具有一个移动的目标。请确保阅读合适的文档 并按照需要更新配置内容。 3.1. 电子邮件地址     许多 Debian 维护工具识别并使用 shell 环境变量 $DEBEMAIL 和 $DEBFULLNAME 作为作为您的电子邮件地址和名称。     我们可以通过将下面几行加入 ~/.bashrc^[7] 的方式对这些软件进行配置 。 添加至 ~/.bashrc 文件.      DEBEMAIL="your.email.address@example.org" DEBFULLNAME="Firstname Lastname" export DEBEMAIL DEBFULLNAME 3.2. mc mc 命令提供了管理文件的简单途径。它可以打开二进制 deb 文件，并仅     需对二进制 deb 文件按下回车键便能检查其内容。它调用了 dpkg-deb 命 令作为其后端。我们可以按照下列方式对其配置，以支持简易 chdir 操作 。 添加至 ~/.bashrc 文件.      # mc related if [ -f /usr/lib/mc/mc.sh ]; then . /usr/lib/mc/mc.sh fi 3.3. git     如今 git 命令已成为管理带历史的源码树的必要工具。     git 命令的用户级全局配置，如您的名字和电子邮件地址，保存在 ~ /.gitconfig 文件中，且可以使用如下方式配置。     $ git config --global user.name "Name Surname" $ git config --global user.email yourname@example.com     如果您仍然只习惯 CVS 或者 Subversion 的命令风格，您可以使用如下方 式设置几个命令别名。     $ git config --global alias.ci "commit -a" $ git config --global alias.co checkout     您可以使用如下命令检查全局配置。     $ git config --global --list Tip     有必要使用某些图形界面 git 工具，例如 gitk 或 gitg 命令来有效地处 理 git 仓库的历史。 3.4. quilt quilt 命令提供了记录修改的一个基本方式。对 Debian 打包来说，该工     具需要进行自定义，从而在 debian/patches/ 目录内记录修改内容，而非 使用默认的 patches/ 目录。 为了避免改变 quilt 命令自身的行为，我们在这里创建一个用于 Debian     打包工作的命令别名：dquilt。之后，我们将对应内容写入 ~/.bashrc 文 件。下面给出的第二行为 dquilt 命令提供与 quilt 命令相同的命令行补 全功能。 添加至 ~/.bashrc 文件.      alias dquilt="quilt --quiltrc=${HOME}/.quiltrc-dpkg" . /usr/share/bash-completion/completions/quilt complete -F _quilt_completion $_quilt_complete_opt dquilt     然后我们来创建具有如下内容的 ~/.quiltrc-dpkg 文件。 d=. while [ ! -d $d/debian -a `readlink -e $d` != / ]; do d=$d/..; done if [ -d $d/debian ] && [ -z $QUILT_PATCHES ]; then # if in Debian packaging tree with unset $QUILT_PATCHES QUILT_PATCHES="debian/patches"     QUILT_PATCH_OPTS="--reject-format=unified" QUILT_DIFF_ARGS="-p ab --no-timestamps --no-index --color=auto" QUILT_REFRESH_ARGS="-p ab --no-timestamps --no-index" QUILT_COLORS="diff_hdr=1;32:diff_add=1;34:diff_rem=1;31:diff_hunk=1;33:" QUILT_COLORS="${QUILT_COLORS}diff_ctx=35:diff_cctx=33" if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi fi     请参考 quilt(1) 和处理大量补丁的方法暨对 Quilt 的介绍以了解如何使 用 quilt 命令。     要获取使用示例，请查看 Section 4.9, “第三步（备选）：修改上游源代 码”。 3.5. devscripts     debsign 命令由 devscripts 软件包提供，它可以使用用户的 GPG 私钥对 Debian 软件包进行签名。 debuild 命令同样由 devscripts 软件包提供，它可以构建二进制软件包     并使用 lintian 命令对其进行检查。lintian 命令的详细输出通常都很实 用。     您可以将下列内容写入 ~/.devscripts 文件来进行配置。 DEBUILD_DPKG_BUILDPACKAGE_OPTS="-i -I -us -uc"     DEBUILD_LINTIAN_OPTS="-i -I --show-overrides" DEBSIGN_KEYID="Your_GPG_keyID" 用于 dpkg-source 命令的 DEBUILD_DPKG_BUILDPACKAGE_OPTS 中可以额外     使用 -i 和 -I 选项以帮助构建源码中具有外来无关内容的软件包（参见 Section 5.17, “构建软件包时排除不必要的内容”）。     当前情况下，使用 4096 位的 RSA 密钥是较好的做法。另见创建一个新 GPG 密钥。 3.6. sbuild The sbuild package provides a clean room (chroot) build     environment. It offers this efficiently with the help of schroot using the bind-mount feature of the modern Linux kernel. Since it is the same build environment as the Debian’s buildd     infrastructure, it is always up to date and comes with full of useful features.     It can be customized to offer following features: * The schroot package to boost the chroot creation speed. * lintian 软件包能找到所构建软件包中的缺陷。 * The piuparts package to find bugs in the package.     * The autopkgtest package to find bugs in the package. * ccache 软件包可以加速 gcc。（可选） * libeatmydata1 软件包可以加速 dpkg。（可选） * 并行运行 make 以提高构建速度。（可选）     Let’s get started by following https://wiki.debian.org/sbuild .     $ sudo apt install sbuild piuparts autopkgtest lintian $ sudo usermod -a -G sbuild Reboot your system or execute command such as “kill -TERM -1” ^     [8]. Then login and check you are a member of sbuild group using id command.     $ id uid=1000() gid=1000() groups=...,132(sbuild) Let’s create the configuration file ~/.sbuildrc in line with     recent Debian practice https://wiki.debian.org/SourceOnlyUpload as: cat >~/.sbuildrc << 'EOF' ############################################################################## # PACKAGE BUILD RELATED (source-only-upload as default) ############################################################################## # -d $distribution = 'unstable'; # -A $build_arch_all = 1; # -s $build_source = 1; # --source-only-changes $source_only_changes = 1; # -v $verbose = 1;     ############################################################################## # POST-BUILD RELATED (turn off functionality by setting variables to 0) ############################################################################## $run_lintian = 1; $lintian_opts = ['-i', '-I']; $run_piuparts = 1; $piuparts_opts = ['--schroot', 'unstable-amd64-sbuild']; $run_autopkgtest = 1; $autopkgtest_root_args = ''; $autopkgtest_opts = [ '--', 'schroot', '%r-%a-sbuild' ]; ############################################################################## # PERL MAGIC ############################################################################## 1; EOF     Following document assumes that sbuild is configured this way.     Edit this to your needs. Post-build tests can be turned on and off by assigning 1 or 0 to the corresponding variables, Warning     可选的自定义项可能造成负面影响。如果有疑问，请禁用它们。 Note     并行的 make 可能在某些已有软件包上运行失败，它同样会使得构建日志 难以阅读。 3.7. git-buildpackage     您也可能需要在 ~/.gbp.conf 中设置全局配置信息 # Configuration file for "gbp " [DEFAULT] # the default build command:     builder = sbuild # use pristine-tar: pristine-tar = True # Use color when on a terminal, alternatives: on/true, off/false or auto color = auto Tip     这里的 gbp 命令是 git-buildpackage 命令的一个别名。 3.8. HTTP 代理     您应当在本地设置 HTTP 缓存代理以节约访问 Debian 软件仓库的带宽。 可以考虑以下几种选项： * 特化的 HTTP 缓存代理，使用 apt-cacher-ng 软件包。     * Generic HTTP caching proxy (squid package) configured by squid-deb-proxy package In order to use this HTTP proxy without manual configuration     adjustment, it’s a good idea to install either auto-apt-proxy or squid-deb-proxy-client package to everywhere. 3.9. 私有 Debian 仓库     您可以使用 reprepro 软件包搭建私有 Debian 仓库。 3.10. Virtual machines     For testing GUI application, it is good idea to have virtual machines. Install virt-manager and qemu-kvm.     Use of chroot and virtual machines allow us not to update the whole host PC to the latest unstable. 3.11. Local network with virtual machines In order to access virtual machines easily over the local     network, setting up multicast DNS service discovery infrastructure by installing avahi-utils is a good idea.     For all running virtual machines and the host PC, we can use each host name appended with .local for SSH to access each other. --------------------------------------------------------------------- ^[7] 这里假设您正在使用 Bash 并以此作为登录默认 shell。如果您设置     了其它登录 shell，例如 Z shell，请使用它们对应的配置文件替换 ~ /.bashrc 文件。     ^[8] Logout from your system via GUI menu may not work. Chapter 4. 简单例子     有一句古罗马谚语说得好：“Longum iter est per praecepta, breve et efficax per exempla”（“一例胜千言！”）。 4.1. Packaging tarball     这里给出了从简单的 C 语言源代码创建简单的 Debian 软件包的例子，并 假设上游使用了 Makefile 作为构建系统。     我们假设上游源码压缩包（tarball）名称为 debhello-0.0.tar.gz。     这一类源代码设计可以用这样的方式安装成为非系统文件： $ tar -xzmf debhello-0.0.tar.gz     $ cd debhello-0.0 $ make $ make install     Debian 的打包需要对“make install”流程进行改变，从而将文件安装至目 标系统镜像所在位置，而非通常使用的 /usr/local 下的位置。 Note     在其它更加复杂的构建系统下构建 Debian 软件包的例子可以在 Chapter 8, 更多示例找到。 4.2. 大致流程     从上游源码压缩包 debhello-0.0.tar.gz 构建单个非原生 Debian 软件包 的大致流程可以总结如下： * 维护者获取上游源码压缩包 debhello-0.0.tar.gz 并将其内容解压缩 至 debhello-0.0 目录中。 * debmake 命令对上游源码树进行 debian 化（debianize），具体来说 ，是创建一个 debian 目录并仅向该目录中添加各类模板文件。     + 名为 debhello_0.0.orig.tar.gz 的符号链接被创建并指向 debhello-0.0.tar.gz 文件。 + 维护者须自行编辑修改模板文件。 * debuild 命令基于已 debian 化的源码树构建二进制软件包。 + debhello-0.0-1.debian.tar.xz 将被创建，它包含了 debian 目 录。 软件包构建的大致流程.  $ tar -xzmf debhello-0.0.tar.gz     $ cd debhello-0.0 $ debmake ... manual customization $ debuild ... Tip     The debuild command in this and following examples may be substituted by equivalent commands such as the sbuild command. Tip     如果上游源码压缩包提供了 .tar.xz 格式文件，请使用这样的压缩包来替 代 .tar.gz 或 .tar.bz2 格式。xz 压缩与 gzip 或 bzip2 压缩相比提供 了更好的压缩比。 4.3. 什么是 debmake？     文中的 debmake 命令是用于 Debian 打包的一个帮助脚本。 * 它总是将大多数选项的状态与参数设置为合理的默认值。 * 它能产生上游源码包，并按需创建所需的符号链接。     * 它不会覆写 debian/ 目录下已存在的配置文件。 * 它支持多架构（multiarch）软件包。 * 它能创建良好的模板文件，例如符合 DEP-5 的 debian/copyright 文 件。     这些特性使得使用 debmake 进行 Debian 打包工作变得简单而现代化。 In retrospective, I created debmake to simplify this     documentation. I consider debmake to be more-or-less a demonstration session generator for tutorial purpose. Note     Many packages are packaged using only a text editor while imitating how other similar packages are packaged and consulting how the Debian policy requires us to do. This seems to me the most popular method for the real-life packaging activity. The debmake command isn’t the only helper script to make a Debian     package. If you are interested alternative packaging helper tools, please see: * Debian wiki: AutomaticPackagingTools — Extensive comparison     of packaging helper scripts * Debian wiki: CopyrightReviewTools — Extensive comparison of copyright review helper scripts 4.4. 什么是 debuild？     这里给出与 debuild 命令类似的一系列命令的一个汇总。 * debian/rules 文件定义了 Debian 二进制软件包该如何构建。 * dpkg-buildpackge 是构建 Debian 二进制软件包的正式命令。对于正 常的二进制构建，它大体上会执行以下操作： + “dpkg-source --before-build”（应用 Debian 补丁，除非它们 已被应用） + “fakeroot debian/rules clean” + “dpkg-source --build”（构建 Debian 源码包） + “fakeroot debian/rules build” + “fakeroot debian/rules binary” + “dpkg-genbuildinfo”（产生一个 *.buildinfo 文件） + “dpkg-genchanges”（产生一个 *.changes 文件）     + “fakeroot debian/rules clean” + “dpkg-source --after-build”（取消 Debian 补丁，如果它们在 --before-build 阶段已被应用） + “debsign”（对 *.dsc 和 *.changes 文件进行签名） o 如果您按照 Section 3.5, “devscripts” 的说明设置了 -us 和 -us 选项的话，本步骤将会被跳过。您需要手动运行 debsign 命令。 * debuild 命令是 dpkg-buildpackage 命令的一个封装脚本，它可以使 用合适的环境变量来构建 Debian 二进制软件包。 * The sbuild command is a wrapper script to build the Debian binary package under the proper chroot environment with the proper environment variables. Note     如需了解详细内容，请见 dpkg-buildpackage(1)。 4.5. 第一步：获取上游源代码     我们先要获取上游源代码。 下载 debhello-0.0.tar.gz.  $ wget http://www.example.org/download/debhello-0.0.tar.gz ... $ tar -xzf debhello-0.0.tar.gz $ tree .     ├── debhello-0.0 │   ├── LICENSE │   ├── Makefile │   └── src │   └── hello.c └── debhello-0.0.tar.gz 2 directories, 4 files     这里的 C 源代码 hello.c 非常的简单。 hello.c.  $ cat debhello-0.0/src/hello.c #include     int main() { printf("Hello, world!\n"); return 0; }     这里，源码中的 Makefile 支持 GNU 编码标准和 FHS（文件系统层级规范 ）。特别地： * 构建二进制程序时会考虑 $(CPPFLAGS)、$(CFLAGS)、$(LDFLAGS)，等     等。 * 安装文件时采纳 $(DESTDIR) 作为目标系统镜像的路径前缀 * 安装文件时使用 $(prefix) 的值，以便我们将其设置覆盖为 /usr Makefile.  $ cat debhello-0.0/Makefile prefix = /usr/local all: src/hello src/hello: src/hello.c @echo "CFLAGS=$(CFLAGS)" | \ fold -s -w 70 | \ sed -e 's/^/# /' $(CC) $(CPPFLAGS) $(CFLAGS) $(LDCFLAGS) -o $@ $^     install: src/hello install -D src/hello \ $(DESTDIR)$(prefix)/bin/hello clean: -rm -f src/hello distclean: clean uninstall: -rm -f $(DESTDIR)$(prefix)/bin/hello .PHONY: all install clean distclean uninstall Note     对 $(CFLAGS) 的 echo 命令用于在接下来的例子中验证所设置的构建参数 。 4.6. 第二步：使用 debmake 产生模板文件 Tip     如果 debmake 命令调用时使用了 -T 选项，程序将为模板文件产生更加详 细的注释内容。     debmake 命令的输出十分详细，如下所示，它可以展示程序的具体操作内 容。 $ cd debhello-0.0 $ debmake I: set parameters I: ================================================================= I: package_dir = /usr/lib/python3/dist-packages I: base_path = /usr I: base_lib_path = /usr/lib/debmake I: base_share_path = /usr/share/debmake I: ================================================================= I: sanity check of parameters I: pkg="debhello", ver="0.0", rev="1" I: *** start packaging in "debhello-0.0". *** I: provide debhello_0.0.orig.tar.gz for non-native Debian package I: pwd = "/path/to" I: $ ln -sf debhello-0.0.tar.gz debhello_0.0.orig.tar.gz I: pwd = "/path/to/debhello-0.0" I: parse binary package settings: I: binary package=debhello Type=bin / Arch=any M-A=foreign I: analyze the source tree I: build_type = make I: scan source for copyright+license text and file extensions I: 100 %, ext = c I: check_all_licenses I: .. I: check_all_licenses completed for 2 files. I: bunch_all_licenses I: format_all_licenses I: make debian/* template files     I: single binary package I: debmake -x "1" ... I: creating => debian/control I: creating => debian/copyright I: substituting => /usr/share/debmake/extra0/changelog I: creating => debian/changelog I: substituting => /usr/share/debmake/extra0/rules I: creating => debian/rules I: substituting => /usr/share/debmake/extra1/README.Debian I: creating => debian/README.Debian I: substituting => /usr/share/debmake/extra1/watch I: creating => debian/watch I: substituting => /usr/share/debmake/extra1source/format I: creating => debian/source/format I: substituting => /usr/share/debmake/extra1tests/control I: creating => debian/source/control I: substituting => /usr/share/debmake/extra1upstream/metadata I: creating => debian/upstream/metadata I: substituting => /usr/share/debmake/extra1tests/control I: creating => debian/tests/control I: substituting => /usr/share/debmake/extra1patches/series I: creating => debian/patches/series I: substituting => /usr/share/debmake/extra1sourcex/local-options I: creating => debian/source/local-options I: substituting => /usr/share/debmake/extra1sourcex/options I: creating => debian/source/options I: substituting => /usr/share/debmake/extra1sourcex/patch-header I: creating => debian/source/patch-header I: run "debmake -x2" to get more template files I: $ wrap-and-sort     debmake 命令基于命令行选项产生所有这些模板文件。如果没有指定具体 选项，debmake 命令将为您自动选择合理的默认值： * 源码包名称：debhello * 上游版本：0.0     * 二进制软件包名称：debhello * Debian 修订版本：1 * 软件包类型： bin（ELF 二进制可执行程序软件包） * -x 选项：-x1（是单个二进制软件包的默认值）     我们来检查一下自动产生的模板文件。 基本 debmake 命令运行后的源码树。.  $ cd .. $ tree . ├── debhello-0.0 │   ├── LICENSE │   ├── Makefile │   ├── debian │   │   ├── README.Debian │   │   ├── changelog │   │   ├── control │   │   ├── copyright │   │   ├── patches │   │   │   └── series │   │   ├── rules     │   │   ├── source │   │   │   ├── control │   │   │   ├── format │   │   │   ├── local-options │   │   │   ├── options │   │   │   └── patch-header │   │   ├── tests │   │   │   └── control │   │   ├── upstream │   │   │   └── metadata │   │   └── watch │   └── src │   └── hello.c ├── debhello-0.0.tar.gz └── debhello_0.0.orig.tar.gz -> debhello-0.0.tar.gz 7 directories, 19 files     这里的 debian/rules 文件是应当由软件包维护者提供的构建脚本。此时 该文件是由 debmake 命令产生的模板文件。 debian/rules（模板文件）：.  $ cat debhello-0.0/debian/rules #!/usr/bin/make -f # You must remove unused comment lines for the released package. #export DH_VERBOSE = 1 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all #export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic     #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ #override_dh_auto_install: # dh_auto_install -- prefix=/usr #override_dh_install: # dh_install --list-missing -X.pyc -X.pyo     这便是使用 dh 命令时标准的 debian/rules 文件。（某些内容已被注释 ，可供后续修改使用。）     这里的 debian/control 文件提供了 Debian 软件包的主要元信息。此时 该文件是由 debmake 命令产生的模板文件。 debian/control（模板文件）：.  $ cat debhello-0.0/debian/control Source: debhello Section: unknown Priority: optional Maintainer: "Firstname Lastname" Build-Depends: debhelper-compat (= 13) Standards-Version: 4.5.1     Homepage: Rules-Requires-Root: no Package: debhello Architecture: any Multi-Arch: foreign Depends: ${misc:Depends}, ${shlibs:Depends} Description: auto-generated package by debmake This Debian binary package was auto-generated by the debmake(1) command provided by the debmake package. Warning     如果您对 debian/control 模板文件中的“Section: unknown”部分不做修 改的话，后续的 lintian 错误可能导致构建失败。 因为这是个 ELF 二进制可执行文件软件包，debmake 命令设置了“     Architecture: any”和“Multi-Arch: foreign”两项。同时，它将所需的 substvar 参数设置为“Depends: ${shlibs:Depends}, ${misc:Depends}” 。这些内容将在 Chapter 5, 基本内容部分进行解释。 Note     请注意这个 debian/control 按照“Debian政策手册”中 5.2 Source package control files — debian/control 的内容使用 RFC-822 风格进 行编写。文件对空行和行首空格的使用有特别的要求。     这里的 debian/copyright 提供了 Debian 软件包版权数据的总结。此时 该文件是由 debmake 命令产生的模板文件。 debian/copyright（模板文件）：.  $ cat debhello-0.0/debian/copyright Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: debhello Upstream-Contact: Source: # # Please double check copyright with the licensecheck(1) command. Files: Makefile src/hello.c Copyright: __NO_COPYRIGHT_NOR_LICENSE__ License: __NO_COPYRIGHT_NOR_LICENSE__ #----------------------------------------------------------------------------... # Files marked as NO_LICENSE_TEXT_FOUND may be covered by the following # license/copyright files. #----------------------------------------------------------------------------... # License file: LICENSE     License: . All files in this archive are licensed under the MIT License as below. . Copyright 2015 Osamu Aoki . Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: . The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. . THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 4.7. 第三步：编辑模板文件     作为维护者，要制作一个合适的 Debian 软件包当然需要对模板内容进行 一些手工的调整。 为了将安装文件变成系统文件的一部分，Makefile 文件中 $(prefix) 默     认的 /usr/local 的值需要被覆盖为 /usr。要做到这点，可以按照下面给 出的方法，在 debian/rules 文件中添加名为 override_dh_auto_install 的目标，在其中设置“prefix=/usr”。 debian/rules（维护者版本）：.  $ vim debhello-0.0/debian/rules ... hack, hack, hack, ... $ cat debhello-0.0/debian/rules #!/usr/bin/make -f export DH_VERBOSE = 1     export DEB_BUILD_MAINT_OPTIONS = hardening=+all export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ override_dh_auto_install: dh_auto_install -- prefix=/usr     如上在 debian/rules 文件中导出=DH_VERBOSE 环境变量可以强制 debhelper 工具输出细粒度的构建报告。 如上导出 DEB_BUILD_MAINT_OPTION 变量可以如 dpkg-buildflags(1) 手     册页中“FEATURE AREAS/ENVIRONMENT”部分所说，对加固选项进行设置。^ [9]     如上导出 DEB_CFLAGS_MAINT_APPEND 可以强制 C 编译器给出所有类型的 警告内容。     如上导出 DEB_LDFLAGS_MAINT_APPEND 可以强制链接器只对真正需要的库 进行链接。^[10] 对基于 Makefile 的构建系统来说，dh_auto_install 命令所做的基本上     就是“$(MAKE) install DESTDIR=debian/debhello”。这里创建的 override_dh_auto_install 目标将其行为修改为“$(MAKE) install DESTDIR=debian/debhello prefix=/usr”。     这里是维护者版本的 debian/control 和 debian/copyright 文件。 debian/control（维护者版本）：.  $ vim debhello-0.0/debian/control ... hack, hack, hack, ... $ cat debhello-0.0/debian/control Source: debhello Section: devel Priority: optional Maintainer: Osamu Aoki Build-Depends: debhelper-compat (= 13)     Standards-Version: 4.5.1 Homepage: https://salsa.debian.org/debian/debmake-doc Rules-Requires-Root: no Package: debhello Architecture: any Multi-Arch: foreign Depends: ${misc:Depends}, ${shlibs:Depends} Description: Simple packaging example for debmake This Debian binary package is an example package. (This is an example only) debian/copyright（维护者版本）：.  $ vim debhello-0.0/debian/copyright ... hack, hack, hack, ... $ cat debhello-0.0/debian/copyright Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: debhello Upstream-Contact: Osamu Aoki Source: https://salsa.debian.org/debian/debmake-doc Files: * Copyright: 2015-2021 Osamu Aoki License: Expat Permission is hereby granted, free of charge, to any person obtaining a     copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: . The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. . THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。 debian/. 下面的模板文件（0.0 版）：.  $ tree debhello-0.0/debian debhello-0.0/debian ├── README.Debian ├── changelog ├── control ├── copyright ├── patches │   └── series ├── rules     ├── source │   ├── control │   ├── format │   ├── local-options │   ├── options │   └── patch-header ├── tests │   └── control ├── upstream │   └── metadata └── watch 4 directories, 14 files Tip     对于来自 debhelper 软件包的各个 dh_* 命令来说，它们在读取所使用的 配置文件时通常把以 # 开头的行视为注释行。 4.8. 第四步：使用 debuild 构建软件包 您可以使用 debuild 或者等效的命令工具（参见 Section 4.4, “什么是     debuild？”）在这个源码树内构建一个非原生 Debian 软件包。命令的输 出通常十分详细，如下所示，它会对构建中执行的操作进行解释。 $ cd debhello-0.0 $ debuild dpkg-buildpackage -us -uc -ui -i -i ... debian/rules clean dh clean ... debian/rules binary dh binary dh_update_autotools_config dh_autoreconf dh_auto_configure     install -d /path/to/debhello-0.0/debian/.debhelper/generated/_source/... dh_auto_build make -j12 "INSTALL=install --strip-program=true" make[1]: Entering directory '/path/to/debhello-0.0' # CFLAGS=-g -O2 # -ffile-prefix-map=/home/osamu/src/public/debmake-doc/debmake-doc/examp ... Now running lintian -i -I --show-overrides debhello_0.0-1_amd64.changes ... ... N: Renamed from: binary-without-manpage N: W: debhello: readme-debian-contains-debmake-template N: ...     这里验证了 CFLAGS 已经得到了更新，添加了 -Wall 和 -pendatic 参数 ；这是我们先前在 DEB_CFLAGS_MAINT_APPEND 变量中所指定的。     根据 lintian 的报告，您应该如同后文中的例子那样（请见 Chapter 8, 更多示例）为软件包添加 man 手册页。我们这里暂且跳过这部分内容。     现在我们来看看成果如何。 debhello 0.0 版使用 debuild 命令产生的文件：.  $ cd .. $ tree -FL 1 . ├── debhello-0.0/ ├── debhello-0.0.tar.gz ├── debhello-dbgsym_0.0-1_amd64.deb     ├── debhello_0.0-1.debian.tar.xz ├── debhello_0.0-1.dsc ├── debhello_0.0-1_amd64.build ├── debhello_0.0-1_amd64.buildinfo ├── debhello_0.0-1_amd64.changes ├── debhello_0.0-1_amd64.deb └── debhello_0.0.orig.tar.gz -> debhello-0.0.tar.gz 1 directory, 9 files     您可以看见生成的全部文件。 * debhello_0.0.orig.tar.gz 是指向上游源码压缩包的符号链接。 * debhello_0.0-1.debian.tar.xz 包含了维护者生成的内容。 * debhello_0.0-1.dsc 是 Debian 源码包的元数据文件。 * debhello_0.0-1_amd64.deb 是 Debian 二进制软件包。 * debhello-dbgsym_0.0-1_amd64.deb 是 Debian 的调试符号二进制软     件包。另请参见 Section 5.19.1, “新的 -dbgsym 软件包（Stretch 9.0 或更新）”。 * debhello_0.0-1_amd64.build 是构建日志文件。 * debhello_0.0-1_amd64.buildinfo 是 dpkg-genbuildinfo(1) 生成的 元数据文件。 * debhello_0.0-1_amd64.changes 是 Debian 二进制软件包的元数据文 件。     debhello_0.0-1.debian.tar.xz 包含了 Debian 对上游源代码的修改，具 体如下所示。 压缩文件 debhello_0.0-1.debian.tar.xz 的内容：.  $ tar -tzf debhello-0.0.tar.gz debhello-0.0/ debhello-0.0/src/ debhello-0.0/src/hello.c debhello-0.0/LICENSE debhello-0.0/Makefile $ tar --xz -tf debhello_0.0-1.debian.tar.xz debian/ debian/README.Debian debian/changelog debian/control     debian/copyright debian/patches/ debian/patches/series debian/rules debian/source/ debian/source/control debian/source/format debian/source/options debian/source/patch-header debian/tests/ debian/tests/control debian/upstream/ debian/upstream/metadata debian/watch     debhello_0.0-1_amd64.deb 包含了将要安装至目标系统中的文件。     debhello-debsym_0.0-1_amd64.deb 包含了将要安装至目标系统中的调试 符号文件。 所有二进制包的包内容：.  $ dpkg -c debhello-dbgsym_0.0-1_amd64.deb drwxr-xr-x root/root ... ./ drwxr-xr-x root/root ... ./usr/ drwxr-xr-x root/root ... ./usr/lib/ drwxr-xr-x root/root ... ./usr/lib/debug/ drwxr-xr-x root/root ... ./usr/lib/debug/.build-id/ drwxr-xr-x root/root ... ./usr/lib/debug/.build-id/be/ -rw-r--r-- root/root ... ./usr/lib/debug/.build-id/be/11292eded3fc22396a0b62... drwxr-xr-x root/root ... ./usr/share/     drwxr-xr-x root/root ... ./usr/share/doc/ lrwxrwxrwx root/root ... ./usr/share/doc/debhello-dbgsym -> debhello $ dpkg -c debhello_0.0-1_amd64.deb drwxr-xr-x root/root ... ./ drwxr-xr-x root/root ... ./usr/ drwxr-xr-x root/root ... ./usr/bin/ -rwxr-xr-x root/root ... ./usr/bin/hello drwxr-xr-x root/root ... ./usr/share/ drwxr-xr-x root/root ... ./usr/share/doc/ drwxr-xr-x root/root ... ./usr/share/doc/debhello/ -rw-r--r-- root/root ... ./usr/share/doc/debhello/README.Debian -rw-r--r-- root/root ... ./usr/share/doc/debhello/changelog.Debian.gz -rw-r--r-- root/root ... ./usr/share/doc/debhello/copyright     生成的依赖列表会给出所有二进制软件包的依赖。 生成的所有二进制软件包的依赖列表（v=0.0）：.  $ dpkg -f debhello-dbgsym_0.0-1_amd64.deb pre-depends \     depends recommends conflicts breaks Depends: debhello (= 0.0-1) $ dpkg -f debhello_0.0-1_amd64.deb pre-depends \ depends recommends conflicts breaks Depends: libc6 (>= 2.2.5) Caution     在将软件包上传至 Debian 仓库之前，仍然有很多细节需要进行处理。 Note     如果跳过了对 debmake 命令自动生成的配置文件的手工调整步骤，所生成 的二进制软件包可能缺少有用的软件包描述信息，某些政策的要求也无法 满足。这个不正式的软件包对于 dpkg 命令来说可以正常处理，也许这样 对您本地的部署来说已经足够好了。 4.9. 第三步（备选）：修改上游源代码     上面的例子中，在创建合适的 Debian 软件包时没有修改上游的源代码。     作为维护者，另一个备选的方案是对上游源代码做改动，如修改上游的 Makefile 以将 $(prefix) 的值设定为 /usr。     打包操作基本上和上面的分步示例相同，除了在 Section 4.7, “第三步： 编辑模板文件” 中的两点： * 要将维护者对上游源代码的修改形成对应的补丁文件存放在 debian/ patches/ 目录内，并将它们的文件名写入 debian/patches/series 文件，如 Section 5.10, “debian/patches/*” 所述。有数种生成补 丁文件的方式。下面的章节中给出了一些例子： + Section 4.9.1, “使用 diff -u 处理补丁” + Section 4.9.2, “使用 dquilt 处理补丁” + Section 4.9.3, “使用 dpkg-source --commit 处理补丁” * 此时维护者对 debian/rules 文件的修改如下所示，它不包含 override_dh_auto_install 目标： debian/rules（备选的维护者版本）：.      $ cd debhello-0.0 $ vim debian/rules ... hack, hack, hack, ... $ cat debian/rules #!/usr/bin/make -f export DH_VERBOSE = 1 export DEB_BUILD_MAINT_OPTIONS = hardening=+all export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ 这个使用一系列补丁文件进行 Debian 打包的备选方案对于应对上游未来     的改变可能不够健壮，但是在应对更为复杂的上游源代码时可以更灵活。 （参见 Section 7.13, “3.0 源代码格式”。） Note     对当前这个特定的打包场景，前文的 Section 4.7, “第三步：编辑模板文 件” 中使用 debian/rules 文件的方式更好一些。但为了演示起见，此时 我们先使用本节的方式继续操作。 Tip     对更复杂的打包场景，可能需要同时应用 Section 4.7, “第三步：编辑模 板文件” 和 Section 4.9, “第三步（备选）：修改上游源代码” 中的方式 。 4.9.1. 使用 diff -u 处理补丁     这里我们使用 diff 命令创建一个 000-prefix-usr.patch 文件作为例子 。 $ cp -a debhello-0.0 debhello-0.0.orig $ vim debhello-0.0/Makefile ... hack, hack, hack, ... $ diff -Nru debhello-0.0.orig debhello-0.0 >000-prefix-usr.patch $ cat 000-prefix-usr.patch diff -Nru debhello-0.0.orig/Makefile debhello-0.0/Makefile --- debhello-0.0.orig/Makefile 2021-07-02 16:26:38.734722687 +0900     +++ debhello-0.0/Makefile 2021-07-02 16:26:38.802723496 +0900 @@ -1,4 +1,4 @@ -prefix = /usr/local +prefix = /usr all: src/hello $ rm -rf debhello-0.0 $ mv -f debhello-0.0.orig debhello-0.0     请注意，上游的源码树应当恢复到原始状态，补丁文件此时的名字为 000-prefix-usr.patch。     这个 000-prefix-usr.patch 文件随后应当进行编辑以使其符合 DEP-3， 并照如下方式移动至正确的位置。 $ cd debhello-0.0 $ echo '000-prefix-usr.patch' >debian/patches/series $ vim ../000-prefix-usr.patch ... hack, hack, hack, ... $ mv -f ../000-prefix-usr.patch debian/patches/000-prefix-usr.patch $ cat debian/patches/000-prefix-usr.patch From: Osamu Aoki     Description: set prefix=/usr patch diff -Nru debhello-0.0.orig/Makefile debhello-0.0/Makefile --- debhello-0.0.orig/Makefile +++ debhello-0.0/Makefile @@ -1,4 +1,4 @@ -prefix = /usr/local +prefix = /usr all: src/hello 4.9.2. 使用 dquilt 处理补丁 这里的例子使用 dquilt 命令（一个 quilt 程序的简单封装）创建     000-prefix-usr.patch。dquilt 命令的语法和功能与 quilt(1) 命令相同 ，唯一的区别在于补丁存储在 debian/patches/ 目录中。 $ cd debhello-0.0 $ dquilt new 000-prefix-usr.patch Patch debian/patches/000-prefix-usr.patch is now on top $ dquilt add Makefile File Makefile added to patch debian/patches/000-prefix-usr.patch ... hack, hack, hack, ... $ head -1 Makefile prefix = /usr $ dquilt refresh Refreshed patch debian/patches/000-prefix-usr.patch $ dquilt header -e --dep3 ... edit the DEP-3 patch header with editor $ tree -a . ├── .pc │   ├── .quilt_patches │   ├── .quilt_series │   ├── .version │   ├── 000-prefix-usr.patch │   │   ├── .timestamp │   │   └── Makefile │   └── applied-patches ├── LICENSE ├── Makefile ├── debian │   ├── README.Debian │   ├── changelog │   ├── control │   ├── copyright │   ├── patches     │   │   ├── 000-prefix-usr.patch │   │   └── series │   ├── rules │   ├── source │   │   ├── control │   │   ├── format │   │   ├── local-options │   │   ├── options │   │   └── patch-header │   ├── tests │   │   └── control │   ├── upstream │   │   └── metadata │   └── watch └── src └── hello.c 8 directories, 24 files $ cat debian/patches/series 000-prefix-usr.patch $ cat debian/patches/000-prefix-usr.patch Description: set prefix=/usr patch Author: Osamu Aoki Index: debhello-0.0/Makefile =================================================================== --- debhello-0.0.orig/Makefile +++ debhello-0.0/Makefile @@ -1,4 +1,4 @@ -prefix = /usr/local +prefix = /usr all: src/hello 这里，上游源码树中的 Makefile 文件没有恢复到原始状态的必要。在 Section 4.8, “第四步：使用 debuild 构建软件包” 描述的 Debian 打包     过程中调用的 dpkg-source 命令能够理解由 dquilt 程序在 .pc/ 目录中 记录的补丁应用情况。只要所有这些修改都是由 dquilt 命令完成的，那 么 Debian 源码包就可以从经过修改的源码树中进行构建。 Note     如果 .pc/ 目录不存在，dpkg-source 命令就会假定没有应用任何补丁。 这就是更为原始的补丁生成方法，例如 Section 4.9.1, “使用 diff -u 处理补丁” 中未生成 .pc/ 目录的情况下要求将上游源码树进行恢复的原 因。 4.9.3. 使用 dpkg-source --commit 处理补丁     这里给出使用“dpkg-source --commit”命令生成 000-prefix-usr.patch 的例子。     我们先来编辑上游源代码。 $ cd debhello-0.0 $ vim Makefile     ... hack, hack, hack, ... $ head -n1 Makefile prefix = /usr     我们来进行提交。 $ dpkg-source --commit . 000-prefix-usr.patch     ... editor to edit the DEP-3 patch header ...     我们来看看效果如何。 $ cat debian/patches/series 000-prefix-usr.patch $ cat debian/patches/000-prefix-usr.patch Description: set prefix=/usr patch Author: Osamu Aoki Index: debhello-0.0/Makefile --- debhello-0.0.orig/Makefile +++ debhello-0.0/Makefile @@ -1,4 +1,4 @@ -prefix = /usr/local +prefix = /usr all: src/hello $ tree -a . ├── .pc │   ├── .quilt_patches │   ├── .quilt_series │   ├── .version │   ├── 000-prefix-usr.patch │   │   ├── .timestamp │   │   └── Makefile │   └── applied-patches     ├── LICENSE ├── Makefile ├── debian │   ├── README.Debian │   ├── changelog │   ├── control │   ├── copyright │   ├── patches │   │   ├── 000-prefix-usr.patch │   │   └── series │   ├── rules │   ├── source │   │   ├── control │   │   ├── format │   │   ├── local-options │   │   ├── options │   │   └── patch-header │   ├── tests │   │   └── control │   ├── upstream │   │   └── metadata │   └── watch └── src └── hello.c 8 directories, 24 files     这里，dpkg-source 命令完成了与 Section 4.9.2, “使用 dquilt 处理补 丁” 一节中使用 dquilt 命令完全相同的流程。 --------------------------------------------------------------------- ^[9] 这里的做法是为了进行加固而强制启用只读重定位链接，以此避免     lintian 的警告“W: debhello: hardening-no-relro usr/bin/hello”。其 实它在本例中并不是必要的，但加上也没有什么坏处。对于没有外部链接 库的本例来说，lintian 似乎给出了误报的警告。 ^[10] 这里的做法是为了避免在依赖库情况复杂的情况下过度链接，例如     某些 GNOME 程序。这样做对这里的简单例子来说并不是必要的，但应当是 无害的。 Chapter 5. 基本内容     这里展示了 Debian 打包工作中针对非原生软件包使用“3.0 (quilt)”格式 进行打包所遵循基本规则的一个全局性概览。 Note     为简明起见，某些细节被有意跳过。请按需查阅对应命令的手册页，例如 dpkg-source(1)、dpkg-buildpackage(1)、dpkg(1)、dpkg-deb(1)、deb (5)，等等。     Debian 源码包是一组用于构建 Debian 二进制软件包的输入文件，而非单 个文件。     Debian 二进制软件包是一个特殊的档案文件，其中包含了一系列可安装的 二进制数据及与它们相关的信息。     单个 Debian 源码包可能根据 debian/control 文件定义的内容产生多个 Debian 二进制软件包。     使用 “3.0 (quilt)”格式的非原生 Debian 软件包是最普通的 Debian 源 码包格式。 Note     有许多封装脚本可用。合理使用它们可以帮助您理顺工作流程，但是请确 保您能理解它们内部的基本工作原理。 5.1. 打包工作流 创建 Debian 二进制软件包的 Debian 打包工作流涉及创建数个特定名称     的文件（参见 Section 5.4, “软件包名称和版本”），与《Debian 政策手 册》的定义保持一致。     一个极其简化的 Debian 打包工作流可以概括为以下十步。 1. 下载上游源码压缩包（tarball）并命名为 package-version.tar.gz 文件。 2. 使上游提供的源码压缩包解压缩后的所有文件存储在 package-version/ 目录中。 3. 上游的源码压缩包被复制（或符号链接）至一个特定的文件名 packagename_version.orig.tar.gz。 + 分隔 package 和 version 的符号从 -（连字符）更改为 _（下 划线） + 文件扩展名添加了 .orig 部分。 4. Debian 软件包规范文件将被添加至上游源代码中，存放在 package-version/debian/ 目录下。 + debian/* 目录下的必需技术说明文件： debian/rules 构建 Debian 软件包所需的可执行脚本（参见 Section 5.6, “debian/rules”） debian/control 软件包配置文件包含了源码包名称、源码构建依赖、二进制 软件包名称、二进制软件包依赖，等等。（参见 Section 5.7, “debian/control”） debian/changelog Debian 软件包历史文件，其中第一行定义了上游软件包版本 号和 Debian 修订版本号（参见 Section 5.8, “debian/ changelog”） debian/copyright 版权和许可证摘要信息（参看 Section 5.9, “debian/ copyright”） + 在 debian/* 下的可选配置文件（参见 Section 5.13, “其它 debian/* 文件”）： + 在 package-version/ 目录中调用 debmake 命令将会提供这些配 置文件的一套模板。 o 必备的配置文件总会生成，无论是否提供 -x0 选项。 o debmake 命令永远不会覆写任何已经存在的配置文件。 + 这些文件必须手工编辑以达到理想状态。请使用《Debian 政策手 册》和《Debian 开发者参考》作为编辑依据。     5. The dpkg-buildpackage command (usually from its wrapper debuild or sbuild) is invoked in the package-version/ directory to make the Debian source and binary packages by invoking the debian/rules script. + 当前工作目录会被设为：$(CURDIR)=/path/to/package-version/ + 使用 dpkg-source(1) 以“3.0 (quilt)”格式创建 Debian 源码包 o package_version.orig.tar.gz（package-version.tar.gz 的副本或符号链接） o package_version-revision.debian.tar.xz（ package-version/debian/* 的 tar 压缩包，即 tarball） o package_version-revision.dsc + 使用“debian/rules build”构建源代码并安装到 $(DESTDIR) 中 o DESTDIR=debian/binarypackage/（单二进制包） o DESTDIR=debian/tmp/（多个二进制包） + 使用 dpkg-deb(1)、dpkg-genbuildinfo(1) 和 dpkg-genchanges (1) 创建 Debian 二进制软件包。 o binarypackage_version-revision_arch.deb o ……（可能有多个 Debian 二进制包文件。） o package_version-revision_arch.changes o package_version-revision_arch.buildinfo 6. 使用 lintian 命令检查 Debian 软件包的质量。（推荐） + 遵守 ftp-master 的拒绝（rejection）指导方针。 o 软件包被拒绝常见问题解答（REJECT-FAQ） o 新软件包（NEW）检查清单 o Lintian 自动拒绝（autoreject）（lintian 标签列表） 7. 通过手工安装和运行软件包里的程序，来测试生成的 Debian 二进制 软件包的可用性。 8. After confirming the goodness, prepare files for the normal source-only upload to the Debian archive. 9. 使用 debsign 命令，用您的 GPG 私钥为软件包名称_版本-修订版本. dsc 和 '软件包名_版本-修订版本’_*source.changes* 文件进行签名 。 10. 使用 dput 命令向 Debian 仓库上传一套 Debian 源码包文件。 Test building and confirming of the binary package goodness as     above is the moral obligation as a diligent Debian developer but there is no physical barrier for people to skip such operations at this moment for the source-only upload. Under some exceptional situation such as NEW uploads, uploads to the Debian archive may need to include Debian binary package     files. For such situation, sign package_version-revision_arch. changes instead of 'package_version-revision’_*source.changes* in the step 9, and upload the set of the Debian source and binary package files in the step 10.     这里，请将文件名中对应的部分使用下面的方式进行替换： * 将 package 部分替换为 Debian 源码包名称 * 将 binarypackage 部分替换为 Debian 二进制软件包名称     * 将 version 部分替换为上游版本号 * 将 revision 部分替换为 Debian 修订号 * 将 arch 部分替换为软件包对应架构     参见 Source-only uploads。 Tip     有很多种通过实践摸索而得到的补丁管理方法和版本控制系统的使用策略 与技巧。您没有必要将它们全部用上。 Tip     在“Debian 开发者参考”一文的第 6 章最佳打包实践部分有十分详尽的相 关文档。请读一读这些内容。 5.1.1. debhelper 软件包 尽管 Debian 软件包可以仅由编写 debian/rules 脚本而不使用 debhelper 软件包来生成，其实这样做是不切实际的。现代的 Debian“政     策”对许多功能特性的实现做了要求，如应用适当的文件权限、使用合适的 与硬件架构相关的软件库安装路径、安装脚本钩子的插入、调试符号软件 包的生成、软件包依赖信息的生成、软件包信息文件的生成、对时间戳调 节以符合可重现构建的要求，等等。 Debhelper 软件包提供了一套实用脚本，用来简化 Debian 打包工作流并     减轻软件包维护者的负担。若能适当运用，它们可以帮助打包者自动地处 理并实现 Debian”政策“所要求的功能。     现代化的 Debian 打包工作流可以组织成一个简单的模块化工作流，如下 所示： * 使用 dh 命令以自动调用来自 debhelper 软件包的许多实用脚本，以     及 * 使用 debian/ 目录下的声明式配置文件配置它们的行为。 您几乎总是应当将 debhelper 列为您的软件包的构建依赖之一。本文档在     接下来的内容中也假设您正在使用一个版本足够新的 debhelper 协助进行 打包工作。 5.2. Historical perspective of Debian packaging practices     Let me oversimplify historical perspective of Debian packaging practices. Debian was started in 1990s when upstream packages were available     from public FTP sites such as Sunsite. In those early days, Debian packaging used dpkg-source currently known as "Format: 1.0": * Upstream released packages in tar.gz format. They were obtained from some FTP sites. * Debian applied "one big patch" as its source distribution and     made its binary distribution form it. * Many different approaches were adopted by different Debian developers to manage topic patches with custom scripts within the "one big patch". — Chaos!     In order to address issues of old dpkg-source "Format: 1.0", new dpkg-source "Format: 3.0 (quilt)" was invented around 2008: * Upstream released packages in tar.gz/tar.bz2/tar.xz format optionally with signature files. They were obtained from some HTTP sites. * Most Debian developers adopted patch queue mechanism of "Format: 3.0 (quilt)" to manage topic patches and made Debian packages while keeping files outside of debian/ directory     untouched. * VCS, especially git, became popular and most Debian developers and started to record this packaging practice in gbp-buildpackage(1) style. * The gbp-buildpackage(1) workflow records the exact same content of the upstream tarball to VCS for source files outside of debian/ directory (= patch-unapplied).     The use of Git repositories to distribute upstream packages with signed tags (supported feature since 2011) became very popular. * The tarball centric gbp-buildpackage(1) workflow to record changes to VCS was cumbersome for some Debian developers and dgit(1) was invented in 2013. * The Git centric dgit-maint-debrebase(7) and dgit-maint-merge (7) workflows to record changes to VCS are gaining popularity     among these Debian developers. * Source files recorded to VCS by dgit-maint-debrebase(7) and git-maint-merge(7) are modified upstream source files (= patch-applied). * Uploaded source packages by dgit-maint-debrebase(7) and git-maint-merge(7) workflows still use dpkg-source "Format: 3.0 (quilt)".     Debian also enforced the source-only upload when developing Debian/11 Bullseye (released in 2021). In this tutorial, mostly simple tarball based dpkg-source     "Format: 3.0 (quilt)" examples are presented as an introductory purpose.     Please assess these VCS usage approaches by yourself later to decide which one to deploy as your preferred one.     Please also read Notes on Debian by Russ Allbery which have best practices such as Using Git for Debian Packaging. 5.3. Future perspective on Debian packaging practices     Please look around to understand how Debian packaging practices are evolving and follow the current general trends if possible. * DEP - Debian Enhancement Proposals + Debian Enhancement Proposals (or DEPs, for short) offer a device to organize discussions about various kinds of enhancements in the Debian project, reflect their current status and, in particular, archive their outcomes.     * Debian Trends + This page provides some historical perspective about how those practices evolved. * Debian git packaging maintainer branch formats and workflows + Nice packaging summary by the latest dgit tool providers.     You can also search entire Debian source code by yourself, too. * Debian Sources — code search tool     + Debian Code Search — wiki page describing its usage * Debian Code Search — another code search tool 5.4. 软件包名称和版本     如果所获取上游源代码的形式为 hello-0.9.12.tar.gz，您可以将 hello 作为上游源代码名称，并将 0.9.12 作为上游版本号。 debmake 的目的是为软件包维护者提供开始工作的模板文件。注释行以 #     开始，其中包含一些教程性文字。您在将软件包上传至 Debian 仓库之前 必须删除或者修改这样的注释行。 许可证信息的提取和赋值过程应用了大量启发式操作，因此在某些情况下     可能不会正常工作。强烈建议您搭配使用其它工具，例如来自 devscripts 软件包的 licensecheck 工具，以配合 debmake 的使用。 组成 Debian 软件包名称的字符选取存在一定的限制。最明显的限制应当     是软件包名称中禁止出现大写字母。这里给出正则表达式形式的规则总结 ： * 上游软件包名称（-p）：[-+.a-z0-9]{2,}     * 二进制软件包名称（-b）：[-+.a-z0-9]{2,} * 上游版本号（-u）：[0-9][-+.:~a-z0-9A-Z]* * Debian 修订版本（-r）： [0-9][+.~a-z0-9A-Z]*     请在《Debian 政策手册》的第 5 章 - Control 文件及其字段一节中查看 其精确定义。 debmake 所假设的打包情景是相对简单的。因此，所有与解释器相关的程     序都会默认为“Architecture: all”的情况。当然，这个假设并非总是成立 。     您必须为 Debian 打包工作适当地调整软件包名称和上游版本号。 为了能有效地使用一些流行的工具（如 aptitude）管理软件包名称和版本     信息，最好能将软件包名称保持在 30 字符以下；版本号和修订号加起来 最好能不超过 14 个字符。^[11]     为了避免命名冲突，对用户可见的二进制软件包名称不应选择任何常用的 单词。 如果上游没有使用像 2.30.32 这样正常的版本编号方案，而是使用了诸如 11Apr29 这样包含日期、某些代号或者一个版本控制系统散列值等字符串 作为版本号的一部分的话，请在上游版本号中将这些部分移除。这些信息 可以稍后在 debian/changelog 文件中进行记录。如果您需要为软件设计     一个版本字符串，可以使用 YYYYMMDD 格式，如 20110429 的字符串作为 上游版本号。这样能保证 dpkg 命令在升级时能正确地确定版本的先后关 系。如果您想要确保万一上游在未来重新采纳正常版本编号方案，例如 0.1 时能够做到顺畅地迁移，可以另行使用 0~YYMMDD 的格式，如 0~110429 作为上游版本号。     版本字符串可以按如下的方式使用 dpkg 命令进行比较。     $ dpkg --compare-versions ver1 op ver2     版本比较的规则可以归纳如下： * 字符串按照起始到末尾的顺序进行比较。     * 字符比数字大。 * 数字按照整数顺序进行比较。 * 字符按照 ASCII 编码的顺序进行比较。     对于某些字符，如句点（.）、加号（+）和波浪号（~），有如下的特殊规 则。     0.0 < 0.5 < 0.10 < 0.99 < 1 < 1.0~rc1 < 1.0 < 1.0+b1 < 1.0+nmu1 < 1.1 < 2.0 有一个稍需注意的情况，即当上游将 hello-0.9.12-ReleaseCandidate-99.tar.gz 这样的版本当作预发布版本     ，而将 hello-0.9.12.tar.gz 作为正式版本时。为了确保 Debian 软件包 升级能够顺畅进行，您应当修改版本号命名，如将上游源代码压缩包重命 名为 hello-0.9.12~rc99.tar.gz。 5.5. 原生 Debian 软件包 使用“3.0 (quilt)”格式的非原生 Debian 软件包是最常见最标准的     Debian 源码包格式。根据 dpkg-source(1) 的描述，此时的 debian/ source/format 文件应当包含“3.0 (quilt) 的文字内容。上述的工作流和 接下来给出的打包示例都使用了这种格式。 而原生 Debian 软件包是较罕见的一种 Debian 软件包格式。它通常只用     于打包仅对 Debian 项目有价值、有意义的软件。因此，该格式的使用通 常不被提倡。 Caution 在上游 tarball 源码压缩包无法使用其正确名称 package_version. orig.tar.gz 被 dpkg-buildpackage 获取到的时候，会出现意外地构建了     本土 Debian 软件包的情况。这是新手常见的一个错误，通常是因构建中 错误地在符号链接名称中使用了“-”字符而非正确的“_”字符。[译注：此处 仍然假设打包的场景是已经获取或形成了名为 package-version.tar.gz 的上游源码 tarball。Debian 的打包工作很大程度上是以上游源码 tarball 作为基础的，这一点须时刻牢记在心。]     原生 Debian 软件包不对上游代码和 Debian 的修改进行区分，仅包含以 下内容： * package_version.tar.gz（package-version.tar.gz 文件的副本或符     号链接，包含 debian/* 的各个文件。） * package_version.dsc     如果您需要手动创建原生 Debian 软件包，可以使用 dpkg-source(1) 工 具以“3.0 (native)”格式进行创建。 Tip     一些人提议，给那些即使只为 Debian 写的程序，也打包成非原生的软件 包格式。在标准的打包工作流 Section 5.1, “打包工作流” 前，所需的没 有 debian/* 文件的 tarball 压缩包，需要用手工首先生成。^[12] 他们 声称，使用非原生软件包格式，能够和下游发行版更容易沟通。 Tip 如果使用原生软件包格式，没有必要事先创建 tarball 压缩包。要创建一     个原生 Debian 软件包，应当将 debian/source/format 文件的内容设置 为“3.0 (native)”，适当编写 debian/changelog 文件使得版本号中不包 含 Debian 修订号（例如，1.0 而非 1.0-1），最后在源码树中调用“ dpkg-source -b .”命令。这样做便可以自动生成包含源代码的 tarball。 5.6. debian/rules     debian/rules 脚本是用于实际构建 Debian 软件包的可执行脚本。 * debian/rules 脚本重新封装了上游的构建系统（参见 Section 5.18, “上游构建系统”）以达到将文件安装至 $(DESTDIR)并将生成的文件存 入各个 deb 格式文件中的目的。 + 这里的 deb 文件用于二进制的文件分发，并将被 dpkg 命令所使     用以将软件安装至系统中。 * dh 命令通常在 debian/rules 脚本中使用，用作构建系统的一个前端 。 * $(DESTDIR) 路径具体值依赖于构建的类型。 + $(DESTDIR)=debian/binarypackage（单个二进制软件包） + $(DESTDIR)=debian/tmp（多个二进制软件包） 5.6.1. dh 由 debhelper 软件包提供的 dh 命令与一些相关的软件包共同工作，作为     典型的上游构建系统的一层封装，同时它支持所有 Debian 政策（Debian Policy）规定必须在 debian/rules 实现的目标（target），以此提供一 个统一的访问接口。 * dh clean：清理源码树中的文件。 * dh build：在源码树中进行构建 * dh build-arch：在源码树中构建架构相关的软件包 * dh build-indep：在源代码中构建架构无关的软件包 * dh install：将二进制文件安装至 $(DESTDIR)     * dh install-arch：为架构相关的软件包将二进制文件安装至 $ (DESTDIR) 中 * dh install-indep：为架构无关的软件包将二进制文件安装进入 $ (DESTDIR) 中 * dh binary：产生 deb 文件 * dh binary-arch：为架构相关的软件包产生 deb 文件 * dh binary-indep：为架构无关的软件包产生 deb 文件 Note     对使用了 debhelper“compat >=9”的情况，dh 命令将在编译参数未事先设 置的情况下根据 dpkg-buildflags 命令返回的值设置并导出各个编译参数 （如 CFLAGS、CXXFLAGS、FFLAGS、CPPFLAGS 和 LDFLAGS）。（dh 命令将 调用在 Debian::Debhelper::Dh_Lib 模块中定义的 set_buildflags。） 5.6.2. 简单的 debian/rules 受益于 dh 命令对构建目标的抽象化 ^[13]，一个符合 Debian 政策而支     持所有必需目标（target）的 debian/rules 文件可以简单地写成如下形 式^[14]： 简单的 debian/rules：.  #!/usr/bin/make -f     #export DH_VERBOSE = 1 %: dh $@     从本质上来看，这里的 dh 命令的作用是作为一个序列化工具，在合适的 时候调用所有所需的 dh_* 命令。 Tip     设置“export DH_VERBOSE = 1”会输出构建系统中每一条会修改文件内容的 命令。它同时会在某些构建系统中启用详细输出构建日志的选项。 5.6.3. 自定义 debian/rules     通过添加合适的 override_dh_* 目标（target）并编写对应的规则，可以 实现对 debian/rules 脚本的灵活定制。 如果需要在 dh 命令调用某些特定的 dh_foo 命令时采取某些特别的操作     ，则任何自动执行的操作均可以被 debian/rules 中额外添加的 override_dh_foo 这样的 Makefile 目标所覆写。     构建的过程可以使用某些上游提供的接口进行定制化，如使用传递给标准 的源代码构建系统的参数。这些构建系统包括但不限于： * configure,     * Makefile, * setup.py，或 * Build.PL。 在这种情况下，您应该添加一个 override_dh_auto_build 目标并在其中     执行“dh_auto_build -- 自定义参数” 的命令。这样可以在 dh_auto_build 默认传递的参数之后确保将用户给出的自定义参数继续传 递给那些构建系统。 Tip     如果上文提到的构建系统命令已知得到了 dh_auto_build 命令的支持的话 ，请避免直接调用这些命令（而让 dh_auto_build 自动处理）。 debmake 命令所创建的初始模版文件除了应用了上文提到的简单 debian/ rules 文件的优点外，同时为后续可能涉及的软件包加固等情景添加了一     些额外的定制选项。您需要先了解整个构建系统背后的工作原理（参见 Section 5.18, “上游构建系统”），之后才能收放自如地定制软件包来处 理某些非常规的工作情况。 * 请参考 Section 4.7, “第三步：编辑模板文件” 一节以了解如何对 debmake 命令生成的 debian/rules 文件模版进行定制。     * 请参见 Section 5.22, “多体系结构” 以了解与 multiarch 相关的定 制方法。 * 请参见 Section 5.23, “编译加固” 以了解与软件包加固相关的定制 方法。 5.6.4. debian/rules 中的变量     某些对自定义 debian/rules 有用的变量定义可以在 /usr/share/dpkg/ 目录下的文件中找到。比较重要的包括： pkg-info.mk DEB_SOURCE, DEB_VERSION, DEB_VERSION_EPOCH_UPSTREAM, DEB_VERSION_UPSTREAM_REVISION, DEB_VERSION_UPSTREAM, and DEB_DISTRIBUTION variables. These are useful for backport support etc.. vendor.mk DEB_VENDOR and DEB_PARENT_VENDOR variables; and dpkg_vendor_derives_from macro. These are useful for vendor support (Debian, Ubuntu, …). architecture.mk     Set DEB_HOST_* and DEB_BUILD_* variables. An alternative method of retrieving those variables is to invoke dpkg-architecture directly and query the value of a single variable. With explicit invocation of dpkg-architecture to retrieve necessary variables, there is no need to include architecture.mk in debian/rules, which would import all architecture-related variables. buildflags.mk 设置 CFLAGS、CPPFLAGS、CXXFLAGS、OBJCFLAGS、OBJCXXFLAGS、 GCJFLAGS、FFLAGS、FCFLAGS 和 LDFLAGS 这些构建标志（build flags）。 如果您希望在 debian/rules 中使用其中的某些变量，您可以将相关的代     码复制到 debian/rules 文件中，或是重写一份简单的替代实现。总而言 之请保持 debian/rules 文件尽量简单。     例如，您按如下的方法在 debian/rules 文件中添加内容，从而为 linux-any 目标架构添加额外的 CONFIGURE_FLAGS： DEB_HOST_ARCH_OS ?= $(shell dpkg-architecture -qDEB_HOST_ARCH_OS) ...     ifeq ($(DEB_HOST_ARCH_OS),linux) CONFIGURE_FLAGS += --enable-wayland endif Tip 历史上对于 debhelper 兼容等级小于等于 8 的情况下，在 debian/rules 文件中包含 buildflags.mk 文件是很有用的，它可以合适地设置一些构建     标志，如 CPPFLAGS、CFLAGS、LDFLAGS 等，同时保证对特定选项，如 DEB_CFLAGS_MAINT_APPEND 和 DEB_BUILD_MAINT_OPTIONS 的合适处理。现 在您应当使用的 debhelper 兼容等级大于等于 9，故如无特殊原因，请不 要继续包含 buildflags.mk，请交由 dh 命令来处理和设置这些构建标志 。     参见 Section 5.22, “多体系结构”、dpkg-architecture(1) 和 dpkg-buildflags(1)。 5.6.5. 可重现的构建     为了做到软件包可重现的构建，这里给出一些相关的建议。 * 不要嵌入基于系统时间的时间戳。 * 在 debian/rules 中使用“dh $@”以应用最新的 debhelper 特性。 * 在构建环境中导出环境变量“LC_ALL=C.UTF-8”（参见 Section 7.15, “在 UTF-8 环境下构建”）。     * 对上游源代码中使用的时间戳，使用 debhelper 提供的环境变量 $SOURCE_DATE_EPOCH 的值。 * 阅读可重现构建了解更多信息。 + 可重现构建操作方法。 + 可重现构建时间戳处理提议。 由 dpkg-genbuildinfo(1) 生成的控制文件     source-name_source-version_arch.buildinfo 记录了构建环境信息。参 见 deb-buildinfo(5) 5.7. debian/control     debian/control 文件包含了由空行分隔的数块元信息数据。每块元数据按 照如下的顺序定义了下面这些内容：     * Debian 源码包的元信息数据 * Debian 二进制软件包的元信息     参见《Debian 政策手册》中的第 5 章 - Control 文件及其字段一章以了 解每块元信息的具体定义。 Note     debmake 命令会在 debian/control 文件中写入“Build-Depends: debhelper-compat (= 13)”以设置 debhelper 兼容等级。 Tip     If an existing package has lower than debhelper compatibility level 9, probably it’s time to update its packaging. 5.7.1. Debian 二进制软件包的拆分     对行为良好的构建系统来说，对 Debian 二进制包的拆分可以由如下方式 实现。 * 为所有二进制软件包在 debian/control 文件中创建对应的二进制软     件包条目。 * 在对应的 debian/二进制软件包名.install 文件中列出所有文件的路 径（相对于 debian/tmp 目录）。     请查看本指南中相关的例子： * Section 8.11, “Autotools（多个二进制软件包）”（基于 Autotools     ） * Section 8.12, “CMake（多个二进制软件包）”（基于 CMake） 5.7.1.1. debmake -b debmake 命令的 -b 选项提供了一个符合直觉又灵活的功能，可以用来创     建 debian/control 的初始模板文件，其中可以定义多个 Debian 二进制 软件包，每节中含有如下字段： * Package: * Architecture:     * Multi-Arch: * Depends: * Pre-Depends:     debmake 命令也会在每个适当的依赖字段中设置合适的变量替换占位符（ substvars）。     我们在这里直接引用 debmake 手册页中的相关一部分内容。 -b "二进制软件包名[:type],…", --binaryspec "二进制软件包名 [:type],…" 设置二进制软件包的指定类型内容，使用一个用逗号分隔的二进制软 件包名:类型成对列表；例如，使用完整形式“ foo:bin,foo-doc:doc,libfoo1:lib,libfoo-dev:dev”或者使用短形式 ，“-doc,libfoo1,libfoo-dev”。 这里，二进制软件包是二进制软件包名称，可选的类型应当从下面的 类型值中进行选取： o bin：C/C++ 预编译 ELF 二进制代码软件包（any，foreign）（ 默认，别名：""，即，空字符串） o data：数据（字体、图像、……）软件包（all，foreign）（别名 ：da） o dev：库开发软件包（any，same）（别名：de） o doc：文档软件包（all，foreign）（别名：do）     o lib：库软件包（any，same）（别名：l） o perl：Perl 脚本软件包（all，foreign）（别名：pl） o python3：Python（版本 3）脚本软件包（all，foreign）（别名 ：py3） o ruby：Ruby 脚本软件包（all，foreign）（别名：rb） o nodejs：基于 Node.js 的 JavaScript 软件包（all，foreign） （别名：js） o script：Shell 脚本软件包（all，foreign）（别名：sh） 括号内成对的值，例如（any，foreign），是软件包的架构和多架构 （Multi-Arch）特性的值，它们将设置在 debian/control 文件中。 大多数情况下，debmake 命令可以有效地从二进制软件包的名称猜测 出正确的类型。如果类型的值并不明显，程序将回退到将类型设置为 bin。例如，libfoo 设置类型为 lib，而 font-bar 会令程序设置类 型为 data，…… 如果源码树的内容和类型的设置不一致，debmake 命令会发出警告。 5.7.1.2. 拆包的场景和例子     对于下面这样的上游源代码示例，我们在这里给出使用 debmake 处理时一 些典型的 multiarch 软件包拆分的场景和做法： * 一个软件库源码 libfoo-1.0.tar.gz     * 一个软件工具源码 bar-1.0.tar.gz，软件由编译型语言编写 * 一个软件工具源码 baz-1.0.tar.gz，软件由解释型语言编写 +---------------------------------------------------------------+ |二进制软件包| 类型 |Architecture:|Multi-Arch:| 软件包内容 | |------------+------+-------------+-----------+-----------------| |libfoo1 |lib^* |any |same |共享库，可共同安 | | | | | |装 | |------------+------+-------------+-----------+-----------------| |libfoo-dev |dev^* |any |same |共享库头文件及相 | | | | | |关开发文件，可共 | | | | | |同安装 | |------------+------+-------------+-----------+-----------------| |libfoo-tools|bin^* |any |foreign |运行时支持程序， |     | | | | |不可共同安装 | |------------+------+-------------+-----------+-----------------| |libfoo-doc |doc^* |all |foreign |共享库文档 | |------------+------+-------------+-----------+-----------------| |bar |bin^* |any |foreign |编译好的程序文件 | | | | | |，不可共同安装 | |------------+------+-------------+-----------+-----------------| |bar-doc |doc^* |all |foreign |程序的配套文档文 | | | | | |件 | |------------+------+-------------+-----------+-----------------| |baz |script|all |foreign |解释型程序文件 | +---------------------------------------------------------------+ 5.7.1.3. 库软件包名称 我们考虑 libfoo 这个库的上游 tarball 源码压缩包的名字从 lib     foo-7.0.tar.gz 更新为了 libfoo-8.0.tar.gz，同时带有一次 SONAME 大 版本的跳跃（并因此影响了其它软件包）。 库的二进制软件包将必须从 libfoo7 重命名为 libfoo8 以保持使用     unstable 套件的系统上所有依赖该库的软件包在上传了基于 libfoo-8.0 .tar.gz 的新库后仍然能够正常运行。 Warning     如果这个二进制库软件包没有得到更名，许多使用 unstable 套件的系统 上的各个依赖该库的软件包会在新的库包上传后立刻破损，即便立刻请求 进行 binNMU 上传也无法避免这个问题。由于种种原因，binNMU 不可能在 上传后立刻开始进行，故无法缓解问题。     -dev 软件包必须遵循以下命名规则： * 使用不带版本号的 -dev 软件包名称：libfoo-dev + 该情况通常适用于依赖关系处于叶节点的库软件包。 + 仓库内只允许存在一个版本的库源码包。 o 其相关联的库软件包在库变迁进行时需要从 libfoo7 重命名 为 libfoo8 以避免 unstable 仓库内依赖关系的破坏。 + 该方法适用于简单 binNMU 可以快速解决所有受影响软件包对该 库依赖的情况下。（ABI 有变化，过时的 API 被移除而常用、活 跃的 API 未变化。） + 该方法有时也能适用于可协调进行手动的代码更新，影响范围限 定在有限的一些软件包中的情况下。（API 有变化） * 使用带版本的 -dev 软件包名称：libfoo7-dev 和 libfoo8-dev     + 该情况通常适用于各类重要库软件包。 + 两个版本的库源码包可同时出现在发行版仓库中。 o 令所有依赖该库的软件包依赖 libfoo-dev。 o 令 libfoo7-dev 和 libfoo8-dev 两者都提供 libfoo-dev。 o 源码包需要从 libfoo-?.0.tar.gz 相应地重命名为 lib foo7-7.0.tar.gz 和 libfoo8-8.0.tar.gz。 o 需要仔细选择 libfoo7 和 libfoo8 软件包文件安装时的路 径，如头文件等等，以保证它们可以同时安装。 + 可能的话，不要使用这个重量级的、需要大量人为干预的方法。 + 该方法适用于存在多个依赖该库的软件包，且升级时常常涉及手 动代码更新的场景。（API 有变化）否则，受影响的软件包会无 法从源码重新构建并导致对发行而言致命的 bug 出现。 Tip     如果包内数据文件编码方案有所变化（如，从 latin1 变为 utf-8），该 场景应比照 API 变化做类似的考虑与处理。     参见 Section 5.20, “库软件包”。 5.7.2. Substvar debian/control 也定义了软件包的依赖关系，其中变量替换机制（     substvar）的功能可以用来将软件包维护者从跟踪（大多数简单的）软件 包依赖的重复劳动中解放出来。请参见 deb-substvars(5)。     debmake 命令支持下列变量替换指令： * ${misc:Depends}，可用于所有二进制软件包 * ${misc:Pre-Depends}，可用于所有 multiarch 软件包 * ${shlibs:Depends}，可用于所有含有二进制可执行文件或库的软件包     * ${python:Depends}，可用于所有 Python 软件包 * ${python3:Depends}，可用于所有 Python3 软件包 * ${perl:Depends}，用于所有 Perl 软件包 * ${ruby:Depends}，用于所有 Ruby 软件包 对共享链接库来说，所需要的依赖库是由运行“objdump -p /path/to/     program | grep NEEDED”这样的命令来得到的，由 shlib 占位符进行变量 替换。 对于 Python 和其它解释器来说，所需的模块通常由对包含类似“import”     、“use”、“require”等等关键字的行进行解析，并会体现在各自对应的变 量替换占位符所在位置上。     对其它没有部署属于自己范畴内的变量替换机制的情况，misc 变量替换占 位符通常用来覆盖对应的依赖替换需求。     对 POSIX shell 程序来说，并没有简单的办法来验证其依赖关系， substvar 的变量替换也无法自动得出它们的依赖。 对使用动态加载机制，包括 GObject introspection 机制的库和模块来说     ，现在没有简单的方法可以检查依赖关系，变量替换机制也无法自动推导 出所需的依赖。 5.7.3. binNMU 安全 一个 binNMU（二进制非维护者上传）是为库迁移或其它目的所作的非维护 者软件包上传。在一次 binNMU 上传中，只有“Architecture: any”的软件     包会被重构建，其版本号会在末尾附加一个编号（例如，原来版本为 2.3.4-3，新上传的包版本会变成 2.3.4-3+b1）。所有“Architecture: all”的包将不会重新构建。 来自同一个源码包的各个二进制包如果在 debian/control 文件中有互相 的依赖关系，这些二进制包通常情况下应当对 binNMU 是安全的（即，进     行 binNMU 不会破坏依赖关系）。然而，在“Architecture: any”和“ Architecture: all”的软件包同时由同一源码包产出，且互相之间有依赖 关系时，需要小心对待所依赖的版本，必要时应做出调整。 * “Architecture: any”的软件包依赖于“Architecture: any”foo 软件 包 + Depends: foo (= ${binary:Version}) * “Architecture: any”的软件包依赖于“Architecture: all”bar 软件 包     + Depends: bar (= ${source:Version}) * “Architecture: all”的软件包依赖于“Architecture: any”baz 软件 包 + Depends: baz (>= ${source:Version}), baz (<< $ {source:Version}.0~) 5.8. debian/changelog debian/changelog 文件记录了 Debian 软件包的历史并在其第一行定义了     上游软件包的版本和 Debian 修订版本。所有改变的内容应当以明确、正 式而简明的语言风格进行记录。 * 即便您在自己独立进行软件包上传，您也必须记录所有较重要、用户 可见的变更，例如： + 安全相关的漏洞修复。 + 用户界面变动。     * 如果您需要他人协助您进行上传，您应当更详尽地记录变更内容，包 括所有打包相关的变动，从而方便他人对您的软件包进行审查。 + 协助上传的人员不应该也通常不会猜测您没有写出来的想法，所 以请认真书写变更信息。 + 通常来说，协助您上传的人的时间比您的时间更宝贵。 debmake 命令会创建初始的模板文件，其中带有上游软件包版本和 Debian     打包修订编号。发行版部分被设置为 UNRELEASED 以避免半成品不小心被 上传进入 Debian 仓库。     通常使用 debchange 命令（它具有一个别名，即 dch）对其进行编辑。 Tip     您也可以手动使用任何文本编辑器修改 debian/changelog 文件，只要您 能够遵循 debchange 命令所使用的特定文本排版格式即可。 Tip     debian/changelog 文件使用的日期字符串可以使用“LC_ALL=C date -R”命 令手动生成。     该文件将由 dh_installchangelogs 命令安装到 /usr/share/doc/ binarypackage 目录，文件名为 changelog.Debian.gz。     上游的变更日志则会安装至 /usr/share/doc/binarypackage 目录中，文 件名为 changelog.gz。 上游的变更日志是由 dh_installchangelogs 程序自动进行搜索和处理的 ；它会使用大小写不敏感的搜索方式寻找上游代码中特定名称的文件，如     changelog、changes、changelog.txt、changes.txt、history、 history.txt 或 changelog.md。除了根目录，程序还会在 doc/ 目录和 docs/ 目录内进行搜索。 当您完成了主要打包工作并验证了其质量之后，请考虑运行“dch -r”命令 并将最终完成的 debian/changelog 文件中发行版（distribution）部分     进行设置，通常该字段应当使用 unstable。^[15] 如果您的打包是一次向 后移植（backports）、是安全更新或是对长期支持版的上传等等其它情况 ，请使用相应合适的发行版名称。 5.9. debian/copyright     Debian 以十分严肃的态度对待版权和许可证信息。《Debian 政策手册》 强制规定软件包的 debian/copyright 文件中需要提供相关信息的摘要。     您应当按照机器可解析的 debian/copyright 文件（DEP-5）对其进行排版 。 Caution     这里的 debian/copyright 文件中描述的许可证信息匹配信息应当合适地 进行排序，以确保越宽泛的文件匹配越靠前。请参见 Section 6.4, “debmake -k”。     debmake 命令会以扫描整个源码树的方式创建初步的、兼容 DEP-5 的模板 文件。它会内部调用许可证检查工具来对许可证文本进行分类。^[16]     除非明确指定（有些严格过头的） -P 选项，debmake 命令会为了实用性 而跳过对自动生成的文件的检查与报告，默认它们采用宽松的许可证。 Note     如果您发现了这个许可证检查工具存在一些问题，请向 debmake 软件包提 交缺陷报告并提供包含出现问题的许可证和版权信息在内的相关文本内容 。 Note debmake 命令专注于在创建 debian/copyright 模板时聚合相同的授权和     许可证信息并收录其详细内容。为了在有限的时间内尽可能完成工作，工 具将只会提取文件中第一块看起来像授权文本或许可证声明的部分。因此 ，生成的许可证信息可能并不完美。请同时考虑使用其它工具，如 licensecheck 辅助进行检查。 Tip     我们强烈推荐您使用 licensecheck(1) 命令再次检查源码许可证的状态， 并在有必要的情况下进行人工代码审查。 5.10. debian/patches/* 在构建过程开始之前，debian/patches/ 目录内的 -p1 等级的补丁将会按     照在 debian/patches/series 文件中指定的顺序依次应用于上游代码树中 。 Note     原生 Debian 软件包（参见 Section 5.5, “原生 Debian 软件包”）将不 使用这些文件。     要准备这一系列 -p1 等级的补丁，有几种不同的方式可供您选择。 * diff 命令 + 参见 Section 4.9.1, “使用 diff -u 处理补丁” + 原始但万能的方法 o 补丁的来源多种多样，它可以来自其它发行版、邮件列表中 的帖文或是来自上游 git 仓库的拣选补丁，由“git format-patches”生成 + 不涉及 .pc/ 目录的问题 + 不修改上游源代码树 + 手工更新 debian/patches/series 文件 * dquilt 命令 + 参见 Section 3.4, “quilt” + 基本的便利方案 + 会以合适方式生成 .pc/ 目录及其中的数据 + 会修改上游源代码树 * “dpkg-source --commit”命令 + 参见 Section 4.9.3, “使用 dpkg-source --commit 处理补丁” + 更新、更优雅一些的方案 + 会以合适方式生成 .pc/ 目录及其中的数据 + 会修改上游源代码树     * 由 dpkg-buildpackage 自动生成补丁 + 参见 Section 5.16, “在版本控制系统中进行记录（备选方案）” + 在 debian/source/local-options 文件中添加 single-debian-patch 这一行 + 设置 debian/source/local-patch-header 文件 + 不涉及 .pc/ 目录的问题 + 在 Debian 分支中（常见为 master 分支）存储经过修改的上游 源代码树 * The gbp pq command + 配合 git-buildpackage 工具的基本 git 工作流 + 不涉及 .pc/ 目录的问题 + 在可丢弃分支上保存经过修改的上游源码树（patch-queue/ master） + 在 Debian 分支中（常见为 master 分支）存储未经修改的源码 树 * The git-dpm command + 配合 git-dpm 软件包的更细致的 git 工作流 + 不涉及 .pc/ 目录的问题 + 在补丁分支中（通常命名为 patched/随便啥名字）存储经过修改 的上游源码树 + 在 Debian 分支中（通常命名为 master/随便啥名字）存储未经 修改的上游源码树     无论这些补丁的来源如何，都建议使用兼容于 DEP-3 的头部信息对其进行 标记。 Tip     dgit 软件包提供了另外一套直接使用 git 集成操作 Debian 软件包仓库 的工具。 5.10.1. dpkg-source -x     “dpkg-source -x” 命令可以对 Debian 源码包进行解压缩。     该命令通常会将 debian/patches/ 目录内的补丁应用在源码树中，并将补 丁状态记录在 .pc/ 目录中。 如果您想保持源码树不做修改（例如，为了在 Section 5.15, “在版本控     制系统中进行记录（标准）” 中继续使用），请在命令行中使用 --skip-patches 选项。 5.10.2. dquilt 和 dpkg-source 在 dpkg-source 工具 1.16.1 版本之前，该工具还未提供 --commit 选项     对应的功能，此时需要 quilt 命令（或者对它的封装，dquilt 命令）来 管理 debian/patches/ 目录中的 -p1 等级的补丁。 在使用 dpkg-source 命令时，补丁应当能够干净地进行应用。因此在补丁     行数出现偏移或者其它情况出现时，您不能直接将旧补丁原封不动地复制 到新版上游发布对应打包版本的目录中。     与此相对的是 dquilt 命令（参见 Section 3.4, “quilt”）对补丁的处理 更加宽容。您可以调用 dquilt 命令对补丁进行正常化。     $ while dquilt push; do dquilt refresh ; done $ dquilt pop -a 使用 dpkg-source 命令比起使用 dquilt 命令来说存在一大优势：dquilt     命令无法自动处理二进制文件出现变更的情况，而 dpkg-source 命令能够 探测出现内容变动的二进制文件，并将其列入 debian/source/ include-binaries 文件以便在 Debian 打包用压缩包中将文件囊括其中。 5.11. debian/upstream/signing-key.asc     某些软件包由 GPG 密钥进行了签名。     例如，GNU hello 可使用 HTTP 协议从 https://ftp.gnu.org/gnu/hello/ 下载。它含有以下文件：     * hello-version.tar.gz（上游源代码） * hello-version.tar.gz.sig（分离的签名）nature)     我们现在来选择最新的版本套装。 $ wget https://ftp.gnu.org/gnu/hello/hello-2.9.tar.gz ... $ wget https://ftp.gnu.org/gnu/hello/hello-2.9.tar.gz.sig     ... $ gpg --verify hello-2.9.tar.gz.sig gpg: Signature made Thu 10 Oct 2013 08:49:23 AM JST using DSA key ID 80EE4A00 gpg: Can't check signature: public key not found 如果您从邮件列表获知上游维护者所使用的 GPG 公钥信息，请将它作为     debian/upstream/signing-key.asc 文件进行存储。否则，请使用 hkp 公 钥服务器并经由您的信任网进行验证。 $ gpg --keyserver hkp://keys.gnupg.net --recv-key 80EE4A00 gpg: requesting key 80EE4A00 from hkp server keys.gnupg.net gpg: key 80EE4A00: public key "Reuben Thomas " imported gpg: no ultimately trusted keys found gpg: Total number processed: 1     gpg: imported: 1 $ gpg --verify hello-2.9.tar.gz.sig gpg: Signature made Thu 10 Oct 2013 08:49:23 AM JST using DSA key ID 80EE4A00 gpg: Good signature from "Reuben Thomas " ... Primary key fingerprint: 9297 8852 A62F A5E2 85B2 A174 6808 9F73 80EE 4A00 Tip     如果您的网络环境阻挡了对 HKP 11371 端口的访问，请考虑使用“hkp:// keyserver.ubuntu.com:80”。     在确认密钥身份 80EE4A00 值得信任之后，应当下载其公钥并将其保存在 debian/upstream/signing-key.asc 文件中。     $ gpg --armor --export 80EE4A00 >debian/upstream/signing-key.asc     之后，应相应地在 debian/watch 文件中做如下的修改。     version=4 pgpsigurlmangle=s/$/.sig/ https://ftp.gnu.org/gnu/hello/ hello-(\d[\d.]*)\.tar\.(?:gz|bz2|xz)     现在 uscan 命令会在扫描时自动使用 GPG 签名验证上游源码包的真实性 。 5.12. debian/watch 和 DFSG     Debian 严肃地对待软件自由，遵循 Debian 自由软件指导方针（DFSG）。 在使用 uscan 命令来更新 Debian 打包所用代码时，上游源码包（     tarball）中不符合Debian 自由软件指导方针（DFSG）的部分可以利用该 工具简单地进行移除。 * 在 debian/copyright 文件中的 Files-Excluded 一节中列出需要移 除的文件。 * 在 debian/watch 文件中列出下载上游源码包（tarball）所使用的 URL。     * 运行 uscan 命令以下载新的上游源码包（tarball）。 + 作为替代方案，您也可以使用“gbp import-orig --uscan --pristine-tar”命令。 * 最后得到 tarball 的版本编号会附加一个额外的后缀 +dfsg。 5.13. 其它 debian/* 文件 另外也可以添加一些可选的配置文件并放入 debian/ 目录。它们大多用于     控制由 debhelper 软件包提供的 dh_* 命令的行为，但也有一些文件会影 响 dpkg-source、lintian 和 gbp 这些命令。 Tip     请检查 debhelper(7) 的内容以了解当前可用的 dh_* 命令列表。 这些 debian/binarypackage.* 的文件提供了设置文件安装路径的强大功     能。即使上游源代码没有构建系统，这个软件依然可以利用这里提到的这 些文件来进行打包。请参考 Section 8.2, “无 Makefile（shell，命令行 界面）” 的示例。     下面列表中出现的“-x[1234]”上标指示了 debmake -x 选项生成对应模板 文件所需要的最小值。请参考 debmake(1) 以了解详情。     下面按照字母表顺序列出一些值得注意的可选配置文件。 binarypackage.bug-control ^-x3 将安装至 binarypackage 软件包的 usr/share/bug/binarypackage/ control 位置。另请参考Section 5.27, “错误报告”。 binarypackage.bug-presubj ^-x3 将安装至 binarypackage 软件包的 usr/share/bug/binarypackage/ presubj 位置。另请参考Section 5.27, “错误报告”。 binarypackage.bug-script ^-x3 将安装至 binarypackage 软件包的 usr/share/bug/binarypackage or usr/share/bug/binarypackage/script 位置。另请参考 Section 5.27, “错误报告”。 binarypackage.bash-completion 列出需要安装的 bash 补全脚本。 需要在构建环境和用户环境内均安装 bash-completion 软件包。 另请参考dh_bash-completion(1)。 clean ^-x2 列出（构建前）未被 dh_auto_clean 命令清理，且需要手工清理的文 件。 另请参考 dh_auto_clean(1) 和 dh_clean(1)。 compat ^-x3 Previously, this set the debhelper compatibility level. 现在，在 debian/control 文件中使用 Build-Depends: debhelper-compat (= 13) 以指定兼容等级。 另请参考 debhelper(8) 中“COMPATIBILITY LEVELS”一节。 binarypackage.conffile No need for this file now since all files in the etc/ directory are conffiles for recent “compat >= 3”. 如果您正要打包的程序要求每个用户都对 /etc 目录下的配置文件进 行修改，可以采取两种常见办法使其不作为 conffile 配置文件出现 ，避免 dpkg 命令处理软件包时给出不必要的处理选项。 o 在 /etc 目录下创建一个符号链接，指向 /var 目录下的某些文 件；实际存在的文件则使用维护者脚本（maintainer script）予 以创建。 o 使用维护者脚本（maintainer script）在 /etc 目录下创建并维 护配置所需的文件。 另请参考 dh_installdeb(1)。 binarypackage.config 这是 debconf config 脚本，用来在配置软件包时向用户询问任何必 需的问题。另请参见Section 5.21, “debconf”。 binarypackage.cron.hourly ^-x3 安装至 binarypackage 包内的 etc/cron/hourly/binarypackage 文 件。 另请参见 dh_installcron(1) 和 cron(8)。 binarypackage.cron.daily ^-x3 安装至 binarypackage 包内的 etc/cron/daily/binarypackage 文件 。 另请参见 dh_installcron(1) 和 cron(8)。 binarypackage.cron.weekly ^-x3 安装至 binarypackage 包内的 etc/cron/weekly/binarypackage 文 件。 另请参见 dh_installcron(1) 和 cron(8)。 binarypackage.cron.monthly ^-x3 安装至 binarypackage 包内的 etc/cron/monthly/binarypackage 文 件。 另请参见 dh_installcron(1) 和 cron(8)。 binarypackage.cron.d ^-x3 安装至 binarypackage 包内的 etc/cron.d/binarypackage 文件。 参见 dh_installcron(1)、cron(8) 和 crontab(5)。 binarypackage.default ^-x3 若该文件存在，它将被安装至 binarypackage 包中的 etc/default/ binarypackage 位置。 参见 dh_installinit(1)。 binarypackage.dirs ^-x3 列出 binarypackage 包中要创建的目录。 参见 dh_installdirs(1)。 通常情况下您并不需要这么做，因为所有的 dh_install* 命令都会自 动创建所需的目录。请仅在遇到问题时考虑使用这一工具。 binarypackage.doc-base ^-x2 作为 binarypackage 包中的 doc-base 控制文件进行安装。 参见 dh_installdocs(1) 和 doc-base 软件包提供的 Debian doc-base 手册。 binarypackage.docs ^-x2 列出要安装在 binarypackage 包中的文档文件。 参见 dh_installdocs(1)。 binarypackage.emacsen-compat ^-x3 安装至 binarypackage 包中的 usr/lib/emacsen-common/packages/ compat/binarypackage 文件。 参见 dh_installemacsen(1)。 binarypackage.emacsen-install ^-x3 安装至 binarypackage 包中的 usr/lib/emacsen-common/packages/ install/binarypackage 文件。 参见 dh_installemacsen(1)。 binarypackage.emacsen-remove ^-x3 安装至 binarypackage 包中的 usr/lib/emacsen-common/packages/ remove/binarypackage 文件。 参见 dh_installemacsen(1)。 binarypackage.emacsen-startup ^-x3 安装至 binarypackage 包中的 usr/lib/emacsen-common/packages/ startup/binarypackage 文件。 参见 dh_installemacsen(1)。 binarypackage.examples ^-x2 列出要安装至 binarypackage 包中 usr/share/doc/binarypackage/ examples/ 位置下的示例文件或目录。 参见 dh_installexamples(1)。 gbp.conf 如果该文件存在，它将作为 gbp 命令的配置文件发挥作用。 参见 gbp.conf(5)、gbp(1) 和 git-buildpackage(1)。 binarypackage.info ^-x2 列出要安装至 binarypackage 包中的 info 文件。 参见 dh_installinfo(1)。 binarypackage.init ^-x3 安装至 binarypackage 包中的 etc/init.d/binarypackage 文件。 参见 dh_installinit(1)。 binarypackage.install ^-x2 列出未被 dh_auto_install 命令安装的其它应当安装的文件。 参见 dh_install(1) 和 dh_auto_install(1)。 license-examples/* ^-x4     这是 debmake 命令生成的版权声明文件示例，请用它们作为 debian/ copyright 文件的参考。 请在最终工作成果中删除这些文件。 binarypackage.links ^-x2 列出要生成符号链接的源文件和目标文件对。每一对链接均应在单独 的一行中列出，源文件和目标文件之间使用空白字符分隔。 参见 dh_link(1)。 binarypackage.lintian-overrides ^-x3 安装至软件包构建目录的 usr/share/lintian/overrides/ binarypackage 位置。该文件用于消除 lintian 错误生成的诊断信息 。 参见 dh_lintian(1)、lintian(1) 和 Lintian 用户手册。 manpage.* ^-x3 这些文件是 debmake 命令生成的 man 手册页模板文件。请将其重命 名为合适的文件名并更新其内容。 Debian 的政策要求软件包为其包含的每个程序、工具和函数同时提供 一份相关的手册页。手册页使用 nroff(1) 语法写成。 如果您不熟悉如何编写用户手册页，请以 manpage.asciidoc 或 manpage.1 为起点。 binarypackage.manpages ^-x2 列出要安装的 man 手册页。 参见 dh_installman(1)。 binarypackage.menu （已过时，不再安装） tech-ctte #741573 决定“Debian 应该在合适的情况下使用 .desktop 文件”。 安装至 binarypackage 包中的 usr/share/menu/binarypackage Debian 菜单文件。 参见 menufile(5) 以了解其格式。另请参见 dh_installmenu(1)。 NEWS 安装至 usr/share/doc/binarypackage/NEWS.Debian 文件。 参见 dh_installchangelogs(1)。 patches/* 这是 -p1 补丁文件的集合，它们将在使用源代码构建之前应用在上游 源码上。 参见 dpkg-source(1)、Section 3.4, “quilt” 和 Section 4.9, “第 三步（备选）：修改上游源代码”。 debmake 默认不会生成补丁文件。 patches/series ^-x1 patches/* 补丁文件的应用顺序。 binarypackage.preinst ^-x2 , binarypackage.postinst ^-x2 , binarypackage.prerm ^-x2 , binarypackage.postrm ^-x2 这些维护者脚本将安装至软件包的 DEBIAN 目录下。 在这些脚本中，#DEBHELPER# 记号将由其它 debhelper 命令进行处理 ，将其替换为相应的 shell 脚本片段。 参考《Debian 政策手册》的 dh_installdeb(1) 和第六章 - 软件包 维护脚本和安装过程一节。 参考《Debian 政策手册》的 debconf-devel(7) 和 3.9.1 维护者脚 本中的用户交互提示一节。 README.Debian ^-x1 安装至 debian/control 文件列出的第一个二进制软件包中的 usr/ share/doc/binarypackage/README.Debian 位置。 参见 dh_installdocs(1)。 该文件提供了针对该 Debian 软件包的信息。 binarypackage.service ^-x3 如果该文件存在，它将被安装到 binarypackage 包下面的 lib/ systemd/system/binarypackage.service 位置。 参见 dh_systemd_enable(1)、dh_systemd_start(1) 和 dh_installinit(1)。 source/format ^-x1 Debian 软件包格式。 o 使用“3.0 (quilt)”以制作这个非原生软件包（推荐） o 使用“3.0 (native)”以制作这个原生软件包 参见 dpkg-source(1) 的“源码包格式”一节。 source/lintian-overrides 或 source.lintian-overrides ^-x3 这些文件不会最终被安装，但 lintian 会对它们进行扫描以提供源码 包的 override 信息。 另请参考 dh_lintian(1) 和 lintian(1)。 source/local-options ^-x1 dpkg-source 命令使用此内容作为它的选项，比较重要的选项有： o unapply-patches o abort-on-upstream-changes o auto-commit o single-debian-patch 该文件不会包含在生成的源码包中，仅对维护者在版本控制系统中维 护软件包有意义。 参见 dpkg-source(1) 中的“文件格式”一节。 source/local-patch-header 自由格式的文本，将被包含在自动生成补丁的顶部。 该文件不会包含在生成的源码包中，仅对维护者在版本控制系统中维 护软件包有意义。 + 参见 dpkg-source(1) 的“文件格式”一节。 binarypackage.symbols ^-x2 这些符号文件如果存在，将交由 dpkg-gensymbols 命令进行处理和安 装。 参见 dh_makeshlibs(1) 和 Section 5.20.1, “库符号”。 binarypackage.templates 这是 debconf 模板文件，用于在安装过程中向用户询问必需的问题以 正确配置软件包。请参阅 Section 5.21, “debconf”。 tests/control 这是一个 RFC822 格式的测试元数据文件，定义在 DEP-8。参见 autopkgtest(1) 和Section 5.24, “持续集成”。 TODO 安装至 debian/control 文件列出的第一个二进制包中的 usr/share/ doc/binarypackage/TODO.Debian 文件。 参见 dh_installdocs(1)。 binarypackage.tmpfile ^-x3 如果该文件存在，它将被安装至 binarypackage 包中的 usr/lib/ tmpfiles.d/binarypackage.conf 文件。 参见 dh_systemd_enable(1)、dh_systemd_start(1) 和 dh_installinit(1)。 binarypackage.upstart ^-x3 如果该文件存在，它将被安装至软件包构建目录的 etc/init/ package.conf 位置。（已弃用） 参见 dh_installinit(1) 和 Section 8.1, “挑选最好的模板”。 watch ^-x1 用于下载最新上游版本的 uscan 命令的控制文件。 该控制文件也可配置以使用其 GPG 签名自动验证上游 tarball 的真 实性（参见 Section 5.11, “debian/upstream/signing-key.asc”） 。 参见 Section 5.12, “debian/watch 和 DFSG” 和 uscan(1)。     这里给出针对上面列表中信息的一些额外提醒。 * 对只生成一个二进制包的情况，列表文件名中的 binarypackage. 这 一部分可以不出现。 * 对有多个二进制包的源码包，一个缺少文件名里 binarypackage. 部 分的配置文件，会被应用于 debian/control 里列出的第一个二进制 包。 * 在生成多个二进制包的情况下，各个二进制包可以分别指定配置文件 ；只需在其对应配置文件的文件名之前加上它们各自对应的包名即可     ，如 package-1.install、package-2.install 等等。 * debmake 可能没有自动生成某些模板配置文件。如遇到这种情况，您 可以使用文本编辑器手动创建缺失的文件。 * debmake 命令生成的带额外 .ex 后缀名的配置文件必须在移除这个多 余后缀名后才能发挥作用。 * 您应当删除 .ex 命令生成但对您无用的配置模板文件。 * 请按需复制配置模板文件以匹配其对应的二进制包名称以及您的需求 。 5.14. Debian 打包的定制化     我们来重新归纳一下 Debian 打包定制化的相关内容。 所有对 Debian 软件包进行定制化的数据都存在于 debian/ 目录中。我们     在Section 4.7, “第三步：编辑模板文件”这里给出了一个简单的例子。通 常情况下，定制化会涉及以下各个项目： * Debian 软件包构建系统可以经由 debian/rules 文件进行定制（参见 Section 5.6.3, “自定义 debian/rules”）。     * 可以使用额外的配置文件（如 debian/ directory 目录下的 package .install 和 package.docs 文件）以配合来自 debhelper 软件包的 dh_* 命令自定义 Debian 软件包文件的安装路径等信息（请参见 Section 5.13, “其它 debian/* 文件”）。 如果以上提到的手段仍然不足以制作满足要求的 Debian 软件包的话，对 上游源代码的修改应当使用 -p1 补丁文件存放在打包源码树 debian/     patches/ 目录下。这些补丁将按照 debian/patches/series 文件所规定 的顺序在构建软件包之前应用（参见 Section 5.10, “debian/patches/*” ）。Section 4.9, “第三步（备选）：修改上游源代码” 这里给出了一些 简单的例子。     您应当以引入最少修改的方式解决打包中出现的根本问题。所生成的软件 包应当考虑到未来的更新需求并有一定的健壮性。 Note     如果补丁对上游有所帮助的话，也请将解决根本问题的补丁反馈给上游作 者和维护者。 5.15. 在版本控制系统中进行记录（标准）     通常情况下，Debian 打包活动使用 Git 作为版本控制系统（VCS）进行记 录；通常会用到下列的分支。 * master 分支 + 记录用于 Debian 打包的源代码树。 + 源码树的上游部分将照原样记录，不做修改。     + Debian 打包中需要对上游源代码所作的修改记录在 debian/ patches/ 目录中，以 -p1 等级的补丁形式存在。 * upstream 分支 + 记录从上游发布的 tarball（源码压缩文件）解压缩所得到的源 代码树。 Tip     添加一个 .gitignore 文件并将 .pc 文件列入其中也是一个好主意。 Tip     可以在 debian/source/local-options 文件中添加 unapply-patches 和 abort-on-upstream-changes 这两行以保持上游源码处于未修改状态。 Tip     您也可以使用除 upstream 分支以外其它名称的分支跟踪上游版本控制数 据以方便拣选补丁。 5.16. 在版本控制系统中进行记录（备选方案）     您也可以选择不创建 -p1 等级的补丁。这时，您可以使用下列分支来记录 Debian 打包活动。 * master 分支 + 记录用于 Debian 打包的源代码树。 + 源码树的上游部分在应用了为 Debian 打包所作的修改之后进行     记录。 * upstream 分支 + 记录从上游发布的 tarball（源码压缩文件）解压缩所得到的源 代码树。     如下在 debian/ 目录下额外添加一些文件即可达到目的。 $ tar -xvzf .tar.gz $ ln -sf .orig.tar.gz $ cd / ... hack...hack...     $ echo "single-debian-patch" >> debian/source/local-options $ cat >debian/source/local-patch-header <=13)，同时移除 Build-Depends 中对 debhelper 的依赖。     如果在 debian/control 文件中曾经定义过 -dbg 软件包，在 Stretch 9.0 发布之后对旧软件包更新需要进行额外的处理。 * 在 debian/control 文件中删除 -dbg 软件包定义的部分。 * 将 debian/rules 文件中“dh_strip --dbg-package=package”这部分 替换为“dh_strip --dbgsym-migration=package”以避免自动产生的调     试软件包与（现在过时的）-dbg 文件产生冲突。参见 dh_strip(1)。 * 移除 debian/compat。 * 编辑 debian/control 文件，在 Build-Depends 中写入 debhelper-compat (>=13)，同时移除 Build-Depends 中对 debhelper 的依赖。 5.20. 库软件包     打包软件库需要您投入更多的工作。下面有一些打包软件库的提醒和建议 ： * 库二进制软件包必须根据 Section 5.7.1.3, “库软件包名称” 进行命 名。 * Debian 按照 /usr/lib//libfoo-0.1.so.1.0.0 这样的路径     提供共享链接库（参见 Section 5.22, “多体系结构”）。 * Debian 鼓励在共享库中使用带版本的符号（见 Section 5.20.1, “库 符号”）。 * Debian 不提供 *.la libtool 库归档文件。 * Debian 不推荐使用、提供 *.a 静态库文件。     在打包共享库软件之前，请查阅： * 《Debian 政策手册》的第八章 - 共享库     * 《Debian 政策手册》的 10.2 软件库 * 《Debian 开发者参考》中的 6.7.2. 软件库     如需研究其历史背景，请参见： * 逃离依赖地狱 ^[17]     + 该文档鼓励在共享库中使用带版本的符号。 * Debian 库打包指南 ^[18] + 也请阅读这里的公告后面跟随的讨论串。 5.20.1. 库符号 Debian lenny（5.0，2009年5月）中引入的 dpkg 符号支持可以帮助我们     管理同一共享链接库软件包的向后 ABI 兼容性（backward ABI compatibility）。二进制软件包中的 DEBIAN/symbols 文件提供了每个符 号及其对应的最小版本号。     一个极其简化的软件库打包流程大概如下所示。 * 从前一个二进制软件包中使用“dpkg-deb -e”命令解压缩得到旧有的 DEBIAN/symbols 文件。 + 或者，mc 命令也可以用来解压得到 DEBIAN/symbols 文件。 * 将其复制为 debian/binarypackage.symbols 文件。 + 如果这是第一次打包的话，可以只创建一个空文件。 * 构建二进制软件包。     + 如果 dpkg-gensymbols 命令警告添加了新的符号的话： o 使用“dpkg-deb -e”命令解压得到更新的 DEBIAN/symbols 文 件。 o 将其中的 Debian 修订版本号，例如 -1，从文件中去除。 o 将其复制为 debian/binarypackage.symbols 文件。 o 重新构建二进制软件包。 + 如果 dpkg-gensymbols 命令不报和新链接符号有关的警告： o 您已完成了共享库的打包工作。     如需了解详细信息，您应当阅读下列第一手参考资料。 * 《Debian 政策手册》的 8.6.3 符号（symbols）系统 * dh_makeshlibs(1)     * dpkg-gensymbols(1) * dpkg-shlibdeps(1) * deb-symbols(5)     您也应当查看： * Debian 维基使用符号文件 * Debian 维基项目/改进的 DpkgShlibdeps     * Debian kde 团队处理 symbols 文件 * Section 8.11, “Autotools（多个二进制软件包）” * Section 8.12, “CMake（多个二进制软件包）” Tip     对于 C++ 软件库或者其它一些难以跟踪符号变化的场景，请按照《Debian 政策手册》的 8.6.4 The shlibs system 一节的内容来代替。请确保这样 操作时，事先删除 debmake 命令生成的空的 debian/binarypackage .symbols 文件。在这种情况下，应当转而使用 DEBIAN/shlibs 文件。 5.20.2. 库变迁 当您打包新版本的库软件包而且此次更新影响到其它的软件包时，您必须     向 release.debian.org 伪软件包提交一个变迁 bug 报告并附带一个 ben 文件；您可以使用 reportbug 工具进行提交。提交后，请等待发行团队的 审核批准方可进行下一步。     发行团队提供了变迁跟踪系统。参见变迁（Transition）。 Caution     请确保您按照 Section 5.7.1.3, “库软件包名称” 的描述正确地对二进制 软件包进行了重命名。 5.21. debconf     debconf 软件包可以帮助我们在下列两种情况下配置软件包： * 在 debian-installer（Debian 安装器）预安装时进行非交互式配置 。 * 使用菜单界面进行交互式配置（对话框（dialog）、gnome、kde 等等     ） + 软件包安装时：由 dpkg 命令调用 + 对已安装软件包：由 dpkg-reconfigure 命令调用     软件包安装时的所有用户交互都必须由这里的 debconf 系统进行处理，下 列配置文件对这个过程进行控制。 * debian/binarypackage.config + 这是 debconf config 脚本，用于向用户询问对于配置软件包必 需的问题。 * debian/binarypackage.template     + 这是 debconf templates（模板）文件，用于向用户询问对于配 置软件包必需的问题。 * 软件包配置脚本 + debian/binarypackage.preinst + debian/binarypackage.prerm + debian/binarypackage.postinst + debian/binarypackage.postrm     参见 dh_installdebconf(1)、debconf(7)、debconf-devel(7) 和《 Debian 政策手册》中的 3.9.1 维护者脚本中的用户交互提示。 5.22. 多体系结构 Debian wheezy（7.0，2013年5月）在 dpkg 和 apt 中引入了对跨架构二     进制软件包安装的多架构支持（特别是 i386 架构和 amd64 架构，但也支 持其它的组合），这部分内容值得我们额外关注。     您应当详细阅读下列参考内容。 * Ubuntu 维基（上游） + 多架构规范（MultiarchSpec）     * Debian 维基（Debian 的现状） + Debian 多架构支持 + 多架构支持/实现（Multiarch/Implementation） 多架构支持使用三元组（）的值，例如 i386-linux-gnu 和     x86_64-linux-gnu；它们出现在共享链接库的安装路径中，例如 /usr/lib //，等等。 * 三元组 的值由 debhelper 脚本隐式提前设置好，软件包维护 者无需担心。 * 不过，在 debian/rules 文件中用于 override_dh_* 目标的三元组 值需要由维护者手动进行显式设置。三元组 的值可 由 $(DEB_HOST_MULTIARCH) 变量在 debian/rules 文件中获取到，具体方     法如下： DEB_HOST_MULTIARCH = $(shell dpkg-architecture -qDEB_HOST_MULTIARCH) ... override_dh_install: mkdir -p package1/lib/$(DEB_HOST_MULTIARCH) cp -dR tmp/lib/. package1/lib/$(DEB_HOST_MULTIARCH)     参见： * Section 5.6.4, “debian/rules 中的变量”     * dpkg-architecture(1) * Section 5.7.1.1, “debmake -b” * Section 5.7.1.2, “拆包的场景和例子” 5.22.1. 多架构库路径 Debian 政策要求遵守文件系统层级标准。其中 /usr/lib：程序和软件包     的库声明“/usr/lib 包含目标文件、库和其它不应由用户或 shell 脚本直 接调用的内部二进制文件。” Debian 在文件系统层级标准的基础上添加一项例外，即使用 /usr/lib/     / 而非 /usr/lib/（例如，/lib32/ 和 /lib64/）以对多 架构库提供支持。 Table 5.1. 多架构库路径选项 +-------------------------------------------------------------+ |经典路径 | i386 多体系结构路径 | amd64 多体系结构路径 |     |---------+------------------------+--------------------------| |/lib/ |/lib/i386-linux-gnu/ |/lib/x86_64-linux-gnu/ | |---------+------------------------+--------------------------| |/usr/lib/|/usr/lib/i386-linux-gnu/|/usr/lib/x86_64-linux-gnu/| +-------------------------------------------------------------+     对基于 Autotools 且由 debhelper （compat>=9）管理的软件包来说，这 些路径设置已由 dh_auto_configure 命令自动处理。     对于其它使用不支持的构建系统的软件包，您需要按照下面的方式手动调 整安装路径。 * 如果在 debian/rules 文件中设置了 override_dh_auto_configure 目标且其中手动调用了“./configure”命令，请确保将其替换为“     dh_auto_configure --”，这样可以将安装路径从 /usr/lib/ 替换为 /usr/lib/$(DEB_HOST_MULTIARCH)/。 * 请在 debian/foo.install 文件中将所有出现的 /usr/lib/ 字符串替 换为 /usr/lib/*/。 所有启用多架构的软件包安装至相同路径的文件必须内容完全相同。您必     须小心处理，避免数据字节序或者压缩算法等等问题带来的文件内容差异 。 Note ./configure 的 --libexecdir选项指定了由程序而非用户所使用的可执行 文件的默认安装路径。其 Autotools 的默认值为 /usr/libexec/ 但在未 启用多架构特性的 Debian 系统上其默认值是 /usr/lib/。如果这些可执     行程序属于被标记为“Multi-arch: foreign”的软件包，最好还是使用例如 /usr/lib/ 或者 /usr/lib/软件包名这样的路径而非使用 dh_auto_configure 设置的 /usr/lib// 路径。GNU 编程规范： 7.2.5 用于安装目录的变量对 libexecdir 的描述是“libexecdir 的定义 对所有软件包相同，所以您应当将您的数据安装在其下的一个子目录中。 大多数软件包将数据安装至 $(libexecdir)/package-name/ 之中……”（在 与 Debian 政策不冲突的前提下，遵守 GNU 的标准总是更好的。）     位于默认路径 /usr/lib/ 和 /usr/lib// 的共享库可被自动加 载。     对位于其它路径的共享库，必须使用 pkg-config 命令设置 GCC 选项 -l 以正确进行加载。 5.22.2. 多架构头文件路径     在支持多架构的 Debian 系统上，GCC 默认会同时包含、使用 /usr/ include/ 和 /usr/include// 下的头文件。     如果头文件不在这些路径中，必须使用 pkg-config 命令设置 GCC 的 -I 参数以使得“#include ”正常工作。 Table 5.2. 多架构头文件路径选项 +---------------------------------------------------------------+ | 经典路径 | i386 多体系结构路径 | amd64 多体系结构路径 | |--------------+-----------------------+------------------------| |/usr/include/ |/usr/include/ |/usr/include/ | | |i386-linux-gnu/ |x86_64-linux-gnu/ | |--------------+-----------------------+------------------------|     |/usr/include/ |/usr/include/ |/usr/include/ | |软件包名/ |i386-linux-gnu/软件包名|x86_64-linux-gnu/软件包 | | |/ |名/ | |--------------+-----------------------+------------------------| | |/usr/lib/i386-linux-gnu|/usr/lib/ | | |/软件包名/ |x86_64-linux-gnu/软件包 | | | |名/ | +---------------------------------------------------------------+ 为库文件使用 /usr/lib//软件包名/ 路径可帮助上游维护者对     使用 /usr/lib/ 的多架构系统和使用 /usr/lib/ 的双架 构系统使用相同的安装脚本。^[19]     使用包含 packagename 的文件路径也使得在同一系统上同时安装多个架构 的开发库成为可能。 5.22.3. 多架构支持下的 *.pc 文件路径     packagename 用来获取系统上已安装库的信息。它在 *.pc 文件中存储配 置参数，用来设置 GCC 的 -I 和 -l 选项。 Table 5.3. *.pc 文件路径选项 +----------------------------------------------------------------+ | 经典路径 |i386 多体系结构 | amd64 多体系结构路径 |     | | 路径 | | |----------------+----------------+------------------------------| |/usr/lib/ |/usr/lib/ |/usr/lib/x86_64-linux-gnu/ | |pkgconfig/ |pkgconfig/ |pkgconfig/ | +----------------------------------------------------------------+ 5.23. 编译加固     自 Debian jessie（8.0 开始）的编译器加固支持要求我们在打包时加以 注意。     您应当详细阅读下列参考内容。     * Debian 维基 Hardening（加固） * Debian 维基 Hardening Walkthrough（加固指南） debmake 命令会向 debian/rules 文件中按需添加     DEB_BUILD_MAINT_OPTIONS、DEB_CFLAGS_MAINT_APPEND 和 DEB_LDFLAGS_MAINT_APPEND 的项目（参见 Chapter 4, 简单例子和 dpkg-buildflags(1)）。 5.24. 持续集成     DEP-8 定义了 debian/tests/control 文件的格式，它是 RFC822 风格的 测试元数据文件，用于 Debian 软件包的持续集成（CI）。 它在完成构建包含 debian/tests/control 文件的源码包、得到二进制包     之后发挥作用。在运行 autopkgtest 命令时，所生成的二进制软件包会根 据这个文件在虚拟环境中自动进行安装和测试。 See documents in the /usr/share/doc/autopkgtest/ directory and 4.     autopkgtest: Automatic testing for packages of the “Ubuntu Packaging Guide”. Note     Testing of the binary packages during their building time can be accomodated by dh_auto_test.     您可以在 Debian 系统上探索使用不同的持续集成系统。     * debci 软件包：建立在 autopkgtest 之上的持续集成平台 * jenkins 软件包：通用持续集成平台 5.25. Other new requirements     Debian packaging practices are moving target. Please keep your eyes on DEP - Debian Enhancement Proposals. 5.26. 自举 Debian 关心对新硬件架构的移植工作。新架构的移植工作对自举（     bootstrapping）操作有所要求，以完成对初始最小本地构建系统的交叉编 译。为了在自举（bootstrapping）时避免构建依赖成环的问题，需要使用 配置类型（profile）的构建功能特性来缩减所需构建依赖。 Tip     如果一个核心软件包 foo 构建时依赖于 bar 软件包，但后者会引入一长 串构建依赖链而且 bar 仅在 foo 的 test 目标中使用（即仅用于构建后 测试），那么您可以安全地在 foo 软件包的 Build-depends 一栏中将 bar 标记为 以规避构建依赖环。 5.27. 错误报告     reportbug 命令用于提交 binarypackage 软件包的错误报告；usr/share/ bug/binarypackage/ 可以对针对该软件所提交报告的内容进行自定义。     dh_bugfiles 命令将安装以下位于 debian/ 目录中的的模板文件。 * debian/binarypackage.bug-control → usr/share/bug/ binarypackage/control + 该文件包含诸如重定向错误报告至其它软件包的一些指导性内容 。 * debian/binarypackage.bug-presubj → usr/share/bug/     binarypackage/presubj + 该文件的内容将由 reportbug 命令向用户展示。 * debian/binarypackage.bug-script → usr/share/bug/binarypackage or usr/share/bug/binarypackage/script + reportbug 命令运行此脚本以生成错误报告的模板文件。     参见 dh_bugfiles(1) 和为开发者提供的 reportbug 功能特性 Tip     如果您总是需要提醒提交报告的用户某些注意事项或询问他们某些问题， 使用这些文件可以将这个过程自动化。 --------------------------------------------------------------------- ^[11] 对九成以上的软件包来说，软件包名称都不会超过 24 个字符；上     游版本号通常不超过 10 个字符，而 Debian 修订版本号也通常不超过 3 个字符。 ^[12] 使用“debmake -t …”命令或者“git deborig -f HEAD”能够帮助这个     工作流。参见 Section 6.2, “Snapshot upstream tarball (-d, -t)” 和 dgit-maint-merge(7)。     ^[13] 这个简化形式在 debhelper 软件包第七版或更新的版本中可用。本 指南内容假设您在使用 debhelper 第 13 版或更新的版本。     ^[14] debmake 命令会产生稍微复杂一些的 debian/rules 文件。虽然如 此，其核心结构没有什么变化。     ^[15] 如果您在使用 vim 编辑器，请确保使用“:wq”命令对内容进行保存 。 ^[16] 程序以前会在内部调用来自 devscripts 软件包的 licensecheck     命令来进行检查。现在的 licensecheck 命令由独立的 licensecheck 软 件包所提供，相较从前的实现也有了较大的改进。     ^[17] 该文档是在 symbols 文件被引入之前写成的。 ^[18] 在第六章 - 开发（-DEV）软件包中，存在强烈的使用含有 SONAME     版本号的 -dev 软件包名而非仅使用 -dev 作为名称的偏好，但前 ftp-master 成员（Steve Langasek）对此有不同意见。请注意该文档在 multiarch 系统和 symbols 引入之前写成，可能有一定程度的过时。 ^[19] 这个路径和 FHS 兼容。文件系统层级标准：/usr/lib：程序和软件     包的库称“应用程序可以使用 /usr/lib 下的一个子目录。如果一个应用程 序使用一个子目录，所有由此程序所使用的架构相关数据均须放置于该子 目录下。” Chapter 6. debmake 选项     这里提供 debmake 命令的一些重要选项。 6.1. 快捷选项（-a，-i）     debmake 命令提供了两个快捷选项。     * -a：打开上游源码压缩包 * -i：执行构建二进制包的脚本     前文中Chapter 4, 简单例子的例子可以使用下面的命令直接达到目的。     $ debmake -a package-1.0.tar.gz -i debuild Tip     -a 选项也可以使用“https://www.example.org/DL/package-1.0.tar.gz” 这样的 URL。 Tip     -a 选项也可以使用“https://arm.koji.fedoraproject.org/packages/ ibus/1.5.7/3.fc21/src/ibus-1.5.7-3.fc21.src.rpm”这样的 URL。 6.1.1. Python 模块 您可以使用以源码压缩包（tarball）形式提供的 pythonmodule-1.0     .tar.gz Python 模块包直接生成一个独立二进制 Debian 软件包。这里的 -b 选项可以指定软件包类型为 python，-s 选项可以从上游压缩包中提取 并复制软件包描述内容至指定位置。     $ debmake -s -b':python' -a pythonmodule-1.0.tar.gz -i debuild     对其他支持 -b 选项的解释式编程语言，请给 -b 选项指定恰当的 type 。 对没有 -b 选线支持的其它解释性语言，您可以指定其为脚本类型（     script 类型）并调整 debian/control 文件而将解释器对应的软件包添加 为软件包依赖。 6.2. Snapshot upstream tarball (-d, -t) This test building scheme is good for the git repository     organized as described in gbp-buildpackage(7) which uses the master, upstream, and pristine-tar branches.     如果上游软件包支持“make dist”或者等效的目标，您可以使用 -d 选项从 上游源码树版本控制系统中得到上游代码的快照。     $ cd /path/to/upstream-vcs $ debmake -d -i debuild     除此之外，也可使用 -t 选项以使用 tar 命令生成上游源码包。     $ cd /path/to/upstream-vcs $ debmake -p package -t -i debuild 除非您明确使用 -u 选项或者在 debian/changelog 文件中提前指定好版     本号，默认情况下快照生成的上游版本号将应用协调世界时的日期和时间 使用 0~%y%m%d%H%M 格式生成，例如 0~1403012359。     如果上游版本控制系统位于软件包名/ 目录而非任意的上游版本控制系统/ 目录，参数中的“-p 软件包名”这部分可以跳过。 如果版本控制系统中的上游源码树包含了 debian/* 文件，debmake 命令     在带有 -d 选项或者 -t 选项并结合 -i 选项可以自动化进行使用这些 debian/* 文件从版本控制系统快照中构建非原生软件包的流程。 $ cp -r /path/to/package-0~1403012359/debian/. /path/to/upstream-vcs/debian $ dch     ... update debian/changelog $ git add -A .; git commit -m "vcs with debian/*" $ debmake -t -p package -i debuild This non-native Debian binary package building scheme without the real upstream tarball using the “debmake -t -i debuild” command     may be considered as the quasi-native Debian package scheme since the packaging situation resembles the native Debian binary package building case using the debuild command without the upstream tarball. Use of a non-native Debian package building scheme helps to ease     communication with the downstream distros such as Ubuntu for bug fixes etc. 6.3. debmake -cc     debmake 命令在带上 -cc 选项时可以向标准输出打印整个源码树的版权和 许可证概要信息。 $ tar -xvzf package-1.0.tar.gz     $ cd package-1.0 $ debmake -cc | less     如果转而使用 -c 选项，程序将提供较短的报告。 6.4. debmake -k 在使用上游新发行版本更新软件包时，debmake 可以使用已有的 debian/     copyright 文件和整个更新的源码树文件进行对比验证版权和许可证信息 。 $ cd package-vcs     $ gbp import-orig --uscan --pristine-tar ... update source with the new upstream release $ debmake -k | less “debmake -k”命令可以完整解析 debian/copyright 并将当前软件包中的     所有非二进制文件内含的许可证信息按照最后一项匹配的方式与 debian/ copyright 文件中的信息进行对比。     在您编辑自动生成的 debian/copyright 文件时，请确保将最通用的文件 匹配模式放在文件前部，最精确的匹配模式放在后部。 Tip     对所有上游发布新版本的情况，运行“debmake -k”可以确保 debian/ copyright 文件一直处于最新状态。 6.5. debmake -j     生成多个二进制软件包通常比只生成一个二进制软件包需要投入更多的工 作量。对源码包进行测试构建是其中的必要一环。     例如，我们考虑将相同的 package-1.0.tar.gz（参见 Chapter 4, 简单例 子）打包并生成多个二进制软件包。 * 调用 debmake 命令并使用 -j 选项以测试构建并报告结果。 $ debmake -j -a package-1.0.tar.gz * 请检查 package.build-dep.log 文件最后的几行以确定 Build-Depends 所需填写的构建依赖。（您不需要在 Build-Depends 中列出 debhelper、perl 或 fakeroot 所使用的软件包。在只生成单 个软件包的情况下也是如此。） * 请检查 package.install.log 的文件内容以确定各个文件的安装路径 ，从而决定如何将它们拆分成多个软件包。 * 调用 debmake 命令以开始准备打包信息。     $ rm -rf package-1.0 $ tar -xvzf package-1.0.tar.gz $ cd package-1.0 $ debmake -b"package1:type1, ..." * 请使用以上信息更新 debian/control 和 debian/binarypackage .install 文件。 * 按需更新其它 debian/* 文件。 * 使用 debuild 或等效的其它工具构建 Debian 软件包。 $ debuild * 所有由 debian/binarypackage.install 文件指定的二进制软件包条 目均会生成 binarypackage_version-revision_arch.deb 的安装包。 Note binarypackage_version-revision_arch.deb 命令的 -j 选项会调用     dpkg-depcheck(1) 以在 strace(1) 之下运行 debian/rules，从而获得库 依赖信息。然而，这样操作的运行速度极慢。如果您由其他途径获知了软 件包的库软件包依赖信息，例如外部的 SPEC 文件等等，您可以直接运行“ debmake …”命令而不带 -j 选项并运行“debian/rules install”命令以检 查所生成文件的安装路径。 6.6. debmake -x     debmake 生成的模板文件数量由 -x[01234] 选项进行控制。     * 请参见 Section 8.1, “挑选最好的模板” 以了解与拣选使用模板文件 的方式。 Note     debmake 命令不会修改任何已存在的配置文件。 6.7. debmake -P     调用 debmake 命令并带上 -P 选项将会严厉地检查所有自动生成文件的版 权和许可证文本信息；即使它们都使用宽松的许可证也是如此。     此选项不止会影响正常执行过程中所生成的 debian/copyright 文件的内 容，也会影响带参数 -k、-c、-cc 和 -ccc 选项的输出内容。 6.8. debmake -T     调用 debmake 命令并带上 -T 选项会额外输出详细的教程注释行。这些行 在模板文件中用 ### 进行标注。 Chapter 7. 提示     这里有一些关于 Debian 打包的值得注意的提示。     Debian now enforces the source-only upload when developing packages. So there may be 2 different *.changes files: * 'package_version-revision’_*source.changes* for the normal     source-only upload * package_version-revision_arch.changes for the binary upload 7.1. debdiff     您可以使用 debdiff 命令来对比两个 Debian 软件包组成的差别。     $ debdiff old-package.dsc new-package.dsc     您也可以使用 debdiff 命令来对比两组二进制 Debian 软件包中的文件列 表。     $ debdiff old-package.changes new-package.changes 当检查源代码包中哪些文件被修改时，这个命令非常有用。它还可以用来     检测二进制包中是否有文件在更新过程中发生变动，比如被意外替换或删 除。 7.2. dget     您可以使用 dget 命令来下载 Debian 源包的文件集。     $ dget https://www.example.org/path/to/package_version-rev.dsc 7.3. debc     您应该使用 debc 命令安装生成的软件包以在本地测试它。     $ debc package_version-rev_arch.changes 7.4. piuparts     您应该使用 piuparts 命令安装生成的软件包以自动进行测试。     $ sudo piuparts package_version-rev_arch.changes Note     这是一个非常慢的过程，因为它需要访问远程 APT 软件包仓库。 7.5. debsign     完成软件包的测试后，您可以使用 debsign 命令对其进行签名。     For uploading source-only package (normal):     $ debsign package_version-rev_source.changes     For uploading binary package:     $ debsign package_version-rev_arch.changes 7.6. dput     使用 debsign 命令对包进行签名后，您可以使用 dput 命令上传 Debian 源和二进制包的文件集。     For uploading source-only package (normal):     $ dput package_version-rev_source.changes     For uploading binary package:     $ dput package_version-rev_arch.changes 7.7. bts     上传软件包后，您将收到错误报告。如《Debian 开发者参考》5.8. 处理 缺陷中所述，正确地管理这些错误是软件包维护者的一项重要职责。     bts 命令是一个用以处理 Debian 缺陷追踪系统上的错误的便捷工具。     $ bts severity 123123 wishlist , tags -1 pending 7.8. git-buildpackage     git-buildpackage 软件包提供了许多命令来使用 git 仓库自动打包。 * gbp import-dsc：向 git 仓库中导入先前的 Debian 源码包。 * gbp import-orig：向 git 仓库中导入新的上游源码。 + git import-orig 命令的 --pristine-tar 选项允许将上游源码 包储存在同一个 git 仓库中。 + 将 --uscan 选项作为 gbp import-orig 命令的最后一个参数会 允许下载上游原始码并提交到 git 仓库中。 * gbp dch：从 git 提交信息中生成 Debian 变更信息（changelog）。 * gbp buildpackage：从 git 仓库中构建 Debian 二进制包。 + The sbuild package can be used as its clean chroot build     backend either by configuration or adding --git-builder= 'sbuild -A -s --source-only-changes -v -d unstable' * gbp pull：从远程仓库中完全更新 debian、upstream 和 pristine-tar 分支。 * gbp pq、git-dpm 或 quilt（或者其别名 dquilt）命令用于管理兼容 quilt 的补丁。 + dquilt 命令是学起来最简单的，它只要求您使用 git 命令手动 提交最后的文件至 master 分支。 + “gbp pq” 命令提供了等效的补丁集管理功能，而不需要使用 dquilt 并且使用 git 的拣选（cherry-pick）功能简化了包含上 游 git 仓库修改的操作流程。 + “git dpm” 命令提供了比 “gbp pq” 更强大的功能。     使用git-buildpackage软件包来管理软件包历史正成为绝大多数 Debian 维护者的实践标准。     参见： * 使用 git-buildpackage 构建 Debian 软件包 * https://wiki.debian.org/GitPackagingWorkflow * https://wiki.debian.org/GitPackagingWorkflow/DebConf11BOF     * https://raphaelhertzog.com/2010/11/18/ 4-tips-to-maintain-a-3-0-quilt-debian-source-package-in-a-vcs / * systemd 打包实践文档在从源码构建。 Tip     放松。您并不需要使用全部的打包工具，您只需要使用您所需要的那个就 行。 7.8.1. gbp import-dscs --debsnap 对于记录在 snapshot.debian.org 归档中的名为 的     Debian 源码包，可以生成包含所有 Debian 版本历史的初始 git 存储库 ，如下所示。     $ gbp import-dscs --debsnap --pristine-tar '' 7.8.2. 上游 git 仓库     对于使用 git-buildpackage 打包的 Debian 软件包，远程存储库 origin 上的 upstream 分支通常用于跟踪已发布的上游原始码的内容。 也可以通过将其远程存储库命名为 upstream 而不是默认的 origin 来跟     踪上游 git 仓库。然后，您可以通过使用 gitk 命令和 gbp-pq 命令进行 挑选，轻松地将最近的上游更改添加到 Debian 修订版中。 Tip     “gbp import-orig --upstream-vcs-tag” 命令可以通过使用上游 git 仓 库中的指定标签在 upstream 分支上创建一个合并提交的方式来生成干净 的打包历史信息。 Caution     已发布的上游原始码的内容可能与上游 git 存储库的相应内容并不完全匹 配。它可能包含一些自动生成的文件或遗漏一些文件。（Autotools、 distutils......） 7.9. dgit The new dgit package offers commands to automate packaging     activities using the git repository as an alternative to still popular gbp-buildpackage. Please read their guide: * dgit-maint-merge(7) — for dpkg-source "Format: 3.0 (quilt)" package with its changes flowing both ways between the upstream Git repository and the Debian Git repository which are tightly coupled. * dgit-maint-debrebase(7) — for dpkg-source "Format: 3.0     (quilt)" package with its changes flowing mostly one way from the upstream Git repository to the Debian Git repository. * dgit-maint-gbp(7) — for dpkg-source "Format: 3.0 (quilt)" package with its Debian Git repository which is kept usable also for people using gbp-buildpackage(1). * dgit-maint-native(7) — for dpkg-source "Format: 3.0 (native)" package in the Debian Git repository. The dgit(1) command can push the easy-to-trace change history to     the https://browse.dgit.debian.org/ site and can upload Debian package to the Debian repository properly without using dput(1).     * dgit push-source — for uploading source-only package (normal) * dgit push — for uploading binary package If you already use main and upstream branches in the Debian     packaging repository (salsa.debian.org), you can use your local upstream-vcs-main branch to track the main branch of the upstream-vcs repository as:     $ git fetch upstream-vcs main:upstream-vcs-main Cherry picking bug fix commits from latest upstream commits are intuitive operation with dgit-maint-merge(7) and     dgit-maint-debrebase(7). Just right-click those commits interactively on the upstream-vcs-main branch of the gitk(1) GUI dialog. 7.9.1. Snapshot upstream tarball (alternative git deborig approach) For quasi-native Debian binary package scheme situation described in Section 6.2, “Snapshot upstream tarball (-d, -t)” can be     addressed using alternative git deborig approach adopting the dgit-maint-merge(7) scheme when debian/changelog contains the non-native version number with revision like 0.16-1. $ cd /path/to/upstream-git $ git rm -rf debian     $ git tag -s upstream/0.16 $ git reset --hard HEAD^ $ git deborig $ sbuild Here, for source format 3.0 (quilt), removal of files under     debian/ directory in the upstream tarball is non-essential operation to quiet false positive warning from lintian.     For -1 revision, this use of git-deborig(1) as above is how this debmake-doc package generates the upstream tarball.     对于 -2, -3, … 修订版本号，你需要获取已经上传的上游 tarball 压缩 包来代替。origtargz(1) 可以便利的做这个事情。 7.10. chroot     用于一个干净软件包构建环境的 chroot，可以使用 Chapter 3, 工具的配 置里描述的工具来创建和管理。^[20]     以下是可用的软件包构建命令的快速总结。有很多方法可以做同样的事情 。 * dpkg-buildpackage = 软件包打包工具的核心 * debuild = dpkg-buildpackage + lintian （在清理后的环境变量下 构建）     * schroot = core of the Debian chroot environment tool * sbuild = schroot + dpkg-buildpackage (build in the chroot) * gbp = 在 git 下管理 Debian 源代码 * gbp buildpackage = sbuild + dpkg-buildpackage + gbp (if configured with sbuild)     A clean unstable distribution chroot environment can be used as follows. * The chroot filesystem creation command for the unstable distribution + sudo sbuild-createchroot --include=auto-apt-proxy unstable /srv/chroot/unstable-amd64-sbuild http:// deb.debian.org/debian * The master chroot filesystem path for the unstable distribution chroot filesystem + path: /srv/chroot/unstable-amd64-sbuild     * The package build command for the unstable distribution chroot + sbuild + gbp buildpackage * The command to update the unstable chroot + sudo sbuild-update -udcar u * The command to login to the unstable chroot filesystem to modify it + sudo sbuild-shell u     Here, single "u" is predefined short alias for "unstable".     可以根据如下方式使用任意的 dist 版本环境。 * 用于 dist 版本的 chroot 文件系统创建命令 + sudo sbuild-createchroot --include=auto-apt-proxy dist / srv/chroot/dist-amd64-sbuild http://deb.debian.org/debian * dist 版本的 chroot 文件系统的文件路径 + path: /srv/chroot/dist-amd64-sbuild * dist 版本 chroot 的包构建命令     + sbuild -d dist + gbp buildpackage --git-dist=dist * 更新 dist chroot 的命令 + sudo sbuild-update -udcar dist * The command to login to the master chroot (source:dist) of the dist distribution environment to modify it persistently + sudo sbuild-shell dist Tip For building new experimental packages or for debugging buggy     packages without using slow network access, this “sudo sbuild-shell dist” command can be used to pre-loaded some packages. Make sure to retain the backup of the original minimal chroot since changes are persistent and interfere with the normal test package building with the minimal chroot. Tip     If your old chroot filesystem is missing packages such as libeatmydata1, ccache, and lintian, you may want to install these with the “sudo sbuild-shell dist” command. Tip When the orig.tar.gz file needs to be uploaded for a Debian     revision other than 0 or 1 (e.g., for a security upload), add the -sa option to the end of dpkg-buildpackage, debuild, and sbuild commands. For the “gbp buildpackage” command, temporarily modify the builder setting of ~/.gbp.conf. Note     本节中的描述过于简洁，对大多数潜在的维护者都没用。这是作者的有意 为之。我们强烈建议您搜索并阅读与所用命令相关的所有文档。 Note     When an essential package becomes a non-essential one (e.g., adduser), you need to remove it manually from the existing chroot environment for its use by piuparts. 7.11. 新的 Debian 版本 让我们假设有提交一个针对您的软件包的错误报告 #bug_number ，它描述     了一个问题，您可以通过编辑上游源码中的 buggy 文件来解决。使用含有 记录修复的 bugname.patch 文件，创建一个新的 Debian 修订版软件包， 以下是所需的操作。 使用 dquilt 命令准备新的 Debian 软件包修订版本.  $ dquilt push -a $ dquilt new bugname.patch $ dquilt add buggy     $ vim buggy ... $ dquilt refresh $ dquilt header -e $ dquilt pop -a $ dch -i     此外，如果软件包是用 git-buildpackage 命令以其默认配置管理的 git 仓库： 使用 gbp-pq 命令进行新的 Debian 修订.  $ git checkout master $ gbp pq import $ vim buggy $ git add buggy     $ git commit $ git tag pq/ $ gbp pq export $ gbp pq drop $ git add debian/patches/* $ dch -i $ git commit -a -m "Closes: #"     请确保简明扼要地描述修复报告错误的更改并通过在 debian/changelog 文件中添加 “Closes: #” 来关闭这些错误。 Tip     在实验时使用带有版本字符串的 debian/changelog 条目，例如 1.0.1-1~rc1 。然后，将这些更改日志条目整理到官方软件包的条目中。 7.12. 新上游版本 如果 foo 包是以现代“3.0 (native)”或“3.0 (quilt)”格式正确打包的， 则打包新的上游版本时需要将旧的 debian/ 目录移动到新的源码路径中。     这可以通过在新提取的源码路径中运行“tar -xvzf /path/to/ foo_oldversion.debian.tar.gz”命令来完成。^[21] 当然，你还需要做一 些修改。 有很多的工具可以用以处理这些情况。在使用这些软件来更新上游版本后     ，请在 debian/changelog 文件中简要描述修复错误的上游修改，并添加 “Closes: #bug_number” 来关闭错误。 7.12.1. uupdate + tarball     您可以使用来自 uupdate 软件包中的 uupdate 命令来自动更新到新的上 游源码。该命令需要旧的 Debian 源码包和新的上游源码包。 $ wget https://example.org/foo/foo-newversion.tar.gz $ cd foo-oldversion $ uupdate -v newversion ../foo-newversion.tar.gz     ... $ cd ../foo-newversion $ while dquilt push; do dquilt refresh; done $ dch 7.12.2. uscan     您可以使用来自 uupdate 软件包中的 uscan 命令来自动更新到新的上游 源码。该命令需要包含 debian/watch 文件的旧的 Debian 源码包。 $ cd foo-oldversion $ uscan     ... $ while dquilt push; do dquilt refresh; done $ dch 7.12.3. gbp 您可以使用来自 git-buildpackage 软件包中的 “gbp import-orig     --pristine-tar” 命令来自动更新到新的上游源码。该命令需要在 git 仓 库中的 Debian 源码和新的上游源码包。 $ ln -sf foo-newversion.tar.gz foo_newversion.orig.tar.gz $ cd foo-vcs $ git checkout master $ gbp pq import $ git checkout master $ gbp import-orig --pristine-tar ../foo_newversion.orig.tar.gz     ... $ gbp pq rebase $ git checkout master $ gbp pq export $ gbp pq drop $ git add debian/patches $ dch -v $ git commit -a -m "Refresh patches" Tip     如果上游也使用 git 仓库，请为 gbp import-orig 命令加上 --upstream-vcs-tag 选项。 7.12.4. gbp + uscan 您可以使用来自 git-buildpackage 软件包中的“gbp import-orig     --pristine-tar --uscan”命令来自动更新到新的上游源码。该命令需要在 git 仓库中的包含 debian/watch 文件的 Debian 源码。 $ cd foo-vcs $ git checkout master $ gbp pq import $ git checkout master $ gbp import-orig --pristine-tar --uscan ...     $ gbp pq rebase $ git checkout master $ gbp pq export $ gbp pq drop $ git add debian/patches $ dch -v $ git commit -a -m "Refresh patches" Tip     如果上游也使用 git 仓库，请为 gbp import-orig 命令加上 --upstream-vcs-tag 选项。 7.13. 3.0 源代码格式     更新软件包的风格并不是更新软件包所必须的步骤。但是，这么做可以让 您充分利用现代 debhelper 和 3.0 源码格式的所有能力。 * 如果您因任何原因需要重新创建已删除的模板文件，您可以在同一个 Debian 软件包源码树中再次运行 debmake。然后适当地编辑它们。 * 如果软件包还未更新到可为 debian/rules 文件使用 dh 命令，请升 级它以便使用该命令（参见 Section 5.6.2, “简单的 debian/rules” ）。请根据具体情况更新 debian/control 文件。 * 如果你有一个带有 foo.diff.gz 文件的 1.0 格式的源码包，你可以 通过创建带有“3.0 (quilt)”的 debian/source/format 文件来升级至 新的 “3.0 (quilt)”格式。剩下的 debian/* 文件可以直接复制。如 果需要的话，可以将“filterdiff -z -x /debian/ foo.diff.gz >     big.diff”命令生成的 big.diff 文件导入到你的 quilt 系统中。^ [22] * 如果它使用了其他的补丁系统，例如 dpatch、dbs 或者是带有 -p0、 -p1、-p2 参数的 cdbs。请使用 quilt 包中的 deb3 脚本来转换它。 * 如果它使用了带有 “--with quilt” 选项的 dh 命令或者使用了 dh_quilt_patch 和 dh_quilt_unpatch 命令，请移除这些并且使其使 用新的 “3.0 (quilt)” 格式。 * 如果您有一个不带 foo.diff.gz 文件的 1.0 格式的源码包，您可以 通过创建包含“3.0 (native)”的 debian/source/format 文件，然后 将其余的 debian/* 文件直接复制的方式来更新至新的“3.0 (native) ”的源码格式。     您应该核对一下 DEP——Debian 增强提议并且采用已接受的提议。     参见 ProjectsDebSrc3.0 以核对 Debian 工具链对新 Debian 源码格式的 支持情况。 7.14. CDBS Common Debian Build System （CDBS）是 debhelper 软件包的包装系统     。CDBS 基于 Makefile 包含机制并且由 debian/rules 文件中设置的 DEB_* 变量配置。     在将 dh 命令引入第七版的 debhelper 软件包之前，CDBS 是创建简单干 净的 debian/rules 文件的唯一方法。     对于很多简单的软件包，现在 dh 命令使 debian/rules 文件很简洁，建 议保持构建系统简洁，而非使用冗长的 CDBS。 Note     “CDBS 神奇地让我用更少的命令来完成工作”和“我不懂新的 dh 的语法”都 不是您继续使用旧的 CDBS 系统的借口。 对于一些复杂的软件包，比如与 GNOME 相关的，当前的维护者有理由利用     CDBS 自动化完成他们的统一包装。如果是这种情况，请不要费心从 CDBS 转换为 dh 语法。 Note     如果您正在与维护团队合作，请遵循团队的既定惯例。     将软件包从 CDBS 转换为 dh 语法时，请使用以下内容作为参考：     * CDBS 文档 * The Common Debian Build System (CDBS), FOSDEM 2009 7.15. 在 UTF-8 环境下构建     构建环境的默认语言环境是 C。     某些程序（如 Python3 的 read 函数）会根据区域设置改变行为。     添加以下代码到 debian/rules 文件可以确保程序使用 C.UTF-8 的区域语 言设置（locale）进行构建。     LC_ALL := C.UTF-8 export LC_ALL 7.16. UTF-8 转换     如果上游文档是用旧编码方案编码的，那么将它们转换为 UTF-8 是个好主 意。     请使用 libc-bin 包中的 iconv 命令来转换纯文本文件的编码。     $ iconv -f latin1 -t utf8 foo_in.txt > foo_out.txt     使用 w3m(1) 将 HTML 文件转换为 UTF-8 纯文本文件。执行此操作时，请 确保在 UTF-8 语言环境下执行它。 $ LC_ALL=C.UTF-8 w3m -o display_charset=UTF-8 \     -cols 70 -dump -no-graph -T text/html \ < foo_in.html > foo_out.txt     在 debian/rules 文件的 override_dh_* 目标中运行这些脚本。 7.17. 上传 orig.tar.gz     当您第一次向归档上传软件包时，您还需要包含原始的 orig.tar.gz 源码 。     如果 Debian 修订码是 1 或者 0，这都是默认的。否则，您必须使用带有 -sa 选项的 dpkg-buildpackage 命令。 * dpkg-buildpackage -sa     * debuild -sa * *sbuild * 对于 gbp buildpackage，请编辑 ~/.gbp.conf 文件。 Tip     另一方面，-sd 选项将会强制排除原始的 orig.tar.gz 源码。 Tip     添加至 ~/.bashrc 文件。 7.18. 跳过的上传 如果当跳过上传时，你在 debian/changelog 中创建了多个条目，你必须     创建一个包含自上次上传以来所有变更的 debian/changelog 文件。这可 以通过指定 dpkg-buildpackage 选项 -v 以及上次上传的版本号，比如 1.2 来完成。 * dpkg-buildpackage -v1.2     * debuild -v1.2 * sbuild --debbuildopts -v1.2 * 对于 gbp buildpackage，请编辑 ~/.gbp.conf 文件。 7.19. 高级打包     关于以下内容的提示可以在 debhelper(7) 手册页中找到： * debhelper 工具在 “compat <= 8” 选项下不同的行为 * 在数种不同构建条件下构建多种二进制包 + 制作上游源码的多个副本 + 在 override_dh_auto_configure 目标中调用多个 “ dh_auto_configure -S …” 指令 + 在 override_dh_auto_build 目标中调用多个 “dh_auto_build -S …” 指令     + 在 override_dh_auto_install 目标中调用多个 “ dh_auto_install -S …” 指令 * 在 debian/control 中以 “Package-Type: udeb” 选项来构建 udeb 包（参见 Package-Type） * 从引导进程中排除某些包（参见 BuildProfileSpec） + 在 debian/control 中的二进制包节中添加 Build-Profiles 字 段 + 在 DEB_BUILD_PROFILES 环境变量设置成相关配置文件名的条件 下构建软件包     关于以下内容的提示可以在 dpkg-source(1) 手册页中找到： * 多个上游源码包的命名约定 + 软件包名_版本.orig.tar.gz     + 软件包名_版本.orig-部件名.tar.gz * 将 Debian 更改记录到上游源码包中 + dpkg-source --commit 7.20. 其他发行版     尽管上游的原始码有着所有构建 Debian 软件包所需的信息，找出使用何 种选项的组合仍然不是一件简单的事。     此外，上游的包可能更专注于功能的增强，而并不那么重视向后兼容性等 特性，这是 Debian 打包实践中的一个重要方面。     利用其他发行版的信息是解决上述问题的一种选择。     如果其他发行版是由 Debian 派生的，重新使用它是没有价值的。     如果其他发行版是基于 RPM 的发行版，请参见 Repackage src.rpm。     通过 rget 命令，可以下载并打开 src.rpm文件。（请将 rget 脚本添加 至 PATH 中） rget 脚本.  #!/bin/sh     FCSRPM=$(basename $1) mkdir ${FCSRPM}; cd ${FCSRPM}/ wget $1 rpm2cpio ${FCSRPM} | cpio -dium 许多上游源码包包含 RPM 系统使用的、以 packagename.spec 或者     packagename.spec.in 命名的SPEC 文件。这可以被用做 Debian 软件包的 基点。 7.21. 除错     当您遇到构建问题或者生成的二进制程序核心转储时，您需要自行解决他 们。这就是除错（debug）。     This is too deep a topic to describe here. So, let me just list few pointers and hints for some typical debug tools. * 核心转储 + “man core” + 更新 “/etc/security/limits.conf” 文件来包含以下代码： * soft core unlimited + 在 ~/.bashrc 中添加“ulimit -c unlimited” + 使用 “ulimit -a” 来检查 + 按下 Ctrl-\ 或者“kill -ABRT PID” 来建立一个核心转储文件 * gdb - The GNU Debugger + “info gdb” + 参见 /usr/share/doc/gdb-doc/html/gdb/index.html 中的 “Debugging with GDB” * strace - 跟踪系统调用和信号     + 使用 /usr/share/doc/strace/examples/ 中的 strace-graph 脚 本来建立一个好看的树形图 + “man strace” * ltrace - 跟踪库调用 + “man ltrace” * “sh -n script.sh” - Shell 脚本的语法检查 * “sh -x script.sh” - 跟踪 Shell 脚本 * “python -m py_compile script.py” - Python 脚本的语法检查 * “python -mtrace --trace script.py” - 跟踪 Python 脚本 * “perl -I ../libpath -c script.pl” - Perl 脚本的语法检查 * “perl -d:Trace script.pl” - 跟踪 Perl 脚本 + 安装 libterm-readline-gnu-perl 软件包或者同类型软件来添加 输入行编辑功能与历史记录支持。 * lsof - 按进程列出打开的文件 + “man lsof” Tip     script 命令能帮助记录控制台输出。 Tip     在 ssh 命令中搭配使用 screen 和 tmux 命令，能够提供安全并且强健的 远程连接终端。 Tip     libreply-perl（新的）软件包和来自 libdevel-repl-perl（旧的）软件 包的 re.pl 命令为 Perl 提供了一个类似 Python 和 Shell 的 REPL (= READ + EVAL + PRINT + LOOP) 环境。 Tip     rlwrap 和 rlfe 命令为所有交互命令提供了输入行编辑功能。例如 “ rlwrap dash -i”。 --------------------------------------------------------------------- ^[20] The sbuild style chroot organization is deployed here. See     https://wiki.debian.org/sbuild . Be careful since many HOWTOs use different chroot setups. ^[21] 如果 foo 包是以旧的 1.0 格式打包的，则相对的，只要在新的源     代码路径中执行“zcat /path/to/foo_oldversion.diff.gz|patch -p1”命 令。     ^[22] 您可以使用 splitdiff 命令来将 big.diff 文件分割成多个小的增 量更新补丁文件。 Chapter 8. 更多示例     有一句古老的拉丁谚语：“fabricando fit faber”（“熟能生巧”）。     强烈建议使用简单的包来练习和试验 Debian 打包的所有步骤。本章为您 的练习提供了许多上游案例。     这也可以作为许多编程主题的介绍性示例。 * 在 POSIX shell，Python3 和 C 中编程。 * 使用图标图形创建桌面 GUI 程序启动器的方法。 * 将命令行界面命令转换为图形界面命令。     * 转化程序以使用 gettext 来为 POSIX shell、Python3 和 C 源码的 程序进行国际化和本地化。 * 构建系统概述：Makefile、Python distutils、Autotools 以及 CMake。     请注意，Debian 对以下事项非常注意： * 自由软件 * 操作系统的稳定性与安全性 * 通过以下方式以实现通用操作系统：     + 上游源码的自由选择， + CPU架构的自由选择，以及 + 用户界面语言的自由选择。     在 Chapter 4, 简单例子中介绍的典型打包示例是本章节的先决条件。     在以下数小节中，有些细节被刻意模糊。请尝试阅读相关文件，并且尝试 自行厘清它们。 Tip     打包示例的最佳来源就是目前的 Debian 归档本身。请使用 “Debian 代码 搜索” 服务来查找相关示例。 8.1. 挑选最好的模板     以下是一个从空目录由零开始构建简单的 Debian 软件包的示例。     这是一个很棒的平台，可以使您获得所有的模板文件，而不会使您正在处 理的上游源码树变得一团糟。     让我们假设这个空目录为 debhello-0.1。 $ mkdir debhello-0.1 $ tree     . └── debhello-0.1 1 directory, 0 files     让我们通过指定 -x4 选项来生成最大数量的模板文件。     此外，让我们使用 “-p debhello -t -u 0.1 -r 1” 选项来制作缺失的上 游源码包。 $ debmake -t -p debhello -u 0.1 -r 1 -x4 I: set parameters I: ================================================================= ... I: sanity check of parameters W: -p "debhello" != auto set value "" W: -u "0.1" != auto set value "0~2107020726" W: -r "1" != auto set value "" ...     I: debmake -x "4" ... I: creating => debian/control I: creating => debian/copyright I: substituting => /usr/share/debmake/extra0/changelog ... I: creating => debian/license-examples/GPL-3.0+ I: substituting => /usr/share/debmake/extra4/LGPL-2.1+ I: creating => debian/license-examples/LGPL-2.1+ I: substituting => /usr/share/debmake/extra4/LGPL-3.0+ I: creating => debian/license-examples/LGPL-3.0+ I: $ wrap-and-sort     我们来检查一下自动产生的模板文件。 $ cd .. $ tree . ├── debhello-0.1 │   └── debian │   ├── README.Debian │   ├── changelog │   ├── clean │   ├── compat.ex │   ├── control │   ├── copyright │   ├── debhello.bug-control.ex │   ├── debhello.bug-presubj.ex │   ├── debhello.bug-script.ex │   ├── debhello.conffiles.ex │   ├── debhello.cron.d.ex │   ├── debhello.cron.daily.ex │   ├── debhello.cron.hourly.ex │   ├── debhello.cron.monthly.ex │   ├── debhello.cron.weekly.ex │   ├── debhello.default.ex │   ├── debhello.dirs.ex │   ├── debhello.emacsen-install.ex │   ├── debhello.emacsen-remove.ex │   ├── debhello.emacsen-startup.ex │   ├── debhello.init.ex │   ├── debhello.lintian-overrides.ex │   ├── debhello.service.ex │   ├── debhello.tmpfile.ex │   ├── debhello.upstart.ex │   ├── install │   ├── license-examples │   │   ├── Apache-2.0     │   │   ├── Artistic-1.0 │   │   ├── BSD-3-Clause │   │   ├── Expat │   │   ├── GPL-2.0+ │   │   ├── GPL-3.0+ │   │   ├── LGPL-2.1+ │   │   └── LGPL-3.0+ │   ├── links │   ├── manpage.1.ex │   ├── manpage.asciidoc.ex │   ├── manpage.sgml.ex │   ├── manpage.xml.ex │   ├── patches │   │   └── series │   ├── postinst │   ├── postrm │   ├── preinst │   ├── prerm │   ├── rules │   ├── source │   │   ├── control │   │   ├── format │   │   ├── local-options │   │   ├── options │   │   └── patch-header │   ├── source.lintian-overrides.ex │   ├── tests │   │   └── control │   ├── upstream │   │   └── metadata │   └── watch ├── debhello-0.1.tar.gz └── debhello_0.1.orig.tar.gz -> debhello-0.1.tar.gz 7 directories, 56 files     现在，您可以复制 debhello-0.1/debian/ 目录下所有生成的模板文件到 您的软件包中。 Tip     通过使用 -T 选项（教程模式）调用 debmake 命令，可以使生成的模板文 件更加详细。 8.2. 无 Makefile（shell，命令行界面）     此处是一个从 POSIX shell 命令行界面程序创建简单的 Debian 软件包的 示例，我们假设它没有使用任何构建系统。     让我们假设上游的源码包为 debhello-0.2.tar.gz。     此类源码不具有自动化方法，所以必须手动安装文件。     For example: $ tar -xzmf debhello-0.2.tar.gz     $ cd debhello-0.2 $ sudo cp scripts/hello /bin/hello ...     Let’s get this source as tar file from a remote site and make it the Debian package. 下载 debhello-0.2.tar.gz.  $ wget http://www.example.org/download/debhello-0.2.tar.gz ... $ tar -xzmf debhello-0.2.tar.gz $ tree . ├── debhello-0.2 │   ├── LICENSE     │   ├── data │   │   ├── hello.desktop │   │   └── hello.png │   ├── man │   │   └── hello.1 │   └── scripts │   └── hello └── debhello-0.2.tar.gz 4 directories, 6 files     这里的 POSIX shell 脚本 hello 非常的简单。 hello（v=0.2）.  $ cat debhello-0.2/scripts/hello     #!/bin/sh -e echo "Hello from the shell!" echo "" echo -n "Type Enter to exit this program: " read X     此处的 hello.desktop 支持桌面项（Desktop Entry）规范。 hello.desktop（v=0.2）.  $ cat debhello-0.2/data/hello.desktop [Desktop Entry] Name=Hello Name[fr]=Bonjour     Comment=Greetings Comment[fr]=Salutations Type=Application Keywords=hello Exec=hello Terminal=true Icon=hello.png Categories=Utility;     此处的 hello.png 是图标的图像文件。     让我们使用 debmake 命令来打包。这里使用 -b':sh' 选项来指明生成的 二进制包是一个 shell 脚本。 $ cd debhello-0.2 $ debmake -b':sh' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="0.2", rev="1" I: *** start packaging in "debhello-0.2". *** I: provide debhello_0.2.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-0.2.tar.gz debhello_0.2.orig.tar.gz I: pwd = "/path/to/debhello-0.2" I: parse binary package settings: :sh I: binary package=debhello Type=script / Arch=all M-A=foreign I: analyze the source tree I: build_type = Unknown I: scan source for copyright+license text and file extensions I: 33 %, ext = desktop ...     让我们来检查一下自动产生的模板文件。 执行基本的 debmake 命令后的源码树。（v=0.2）.  $ cd .. $ tree . ├── debhello-0.2 │   ├── LICENSE │   ├── data │   │   ├── hello.desktop │   │   └── hello.png │   ├── debian │   │   ├── README.Debian │   │   ├── changelog │   │   ├── control │   │   ├── copyright │   │   ├── patches │   │   │   └── series │   │   ├── rules     │   │   ├── source │   │   │   ├── control │   │   │   ├── format │   │   │   ├── local-options │   │   │   ├── options │   │   │   └── patch-header │   │   ├── tests │   │   │   └── control │   │   ├── upstream │   │   │   └── metadata │   │   └── watch │   ├── man │   │   └── hello.1 │   └── scripts │   └── hello ├── debhello-0.2.tar.gz └── debhello_0.2.orig.tar.gz -> debhello-0.2.tar.gz 9 directories, 21 files debian/rules（模板文件，v=0.2）：.  $ cat debhello-0.2/debian/rules #!/usr/bin/make -f     # You must remove unused comment lines for the released package. #export DH_VERBOSE = 1 %: dh $@ 这基本上是带有 dh 命令的标准 debian/rules 文件。因为这是个脚本软     件包，所以这个 debian/rules 模板文件没有与构建标记（build flag） 相关的内容。 debian/control（模板文件，v=0.2）：.  $ cat debhello-0.2/debian/control Source: debhello Section: unknown Priority: optional Maintainer: "Firstname Lastname" Build-Depends: debhelper-compat (= 13) Standards-Version: 4.5.1     Homepage: Rules-Requires-Root: no Package: debhello Architecture: all Multi-Arch: foreign Depends: ${misc:Depends} Description: auto-generated package by debmake This Debian binary package was auto-generated by the debmake(1) command provided by the debmake package. 因为这是个 shell 脚本包，所以 debmake 命令设置了“Architecture:     all”和“Multi-Arch: foreign”。此外，它还将所需的 substvar 参数设置 为“Depends: ${misc:Depends}”。Chapter 5, 基本内容对此进行了解释。 因为这个上游源码缺少上游的 Makefile，所以这个功能需要由维护者提供 。这个上游源码仅包含脚本文件和数据文件，没有 C 的源码文件，因此构     建（build）的过程可以被跳过，但是需要实现安装（install）的过程。 对于这种情况，通过添加 debian/install 和 debian/manpages 文件可以 很好地实现这一功能，且不会使 debian/rules 文件变得复杂。     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=0.2）：.  $ vim debhello-0.2/debian/rules ... hack, hack, hack, ...     $ cat debhello-0.2/debian/rules #!/usr/bin/make -f export DH_VERBOSE = 1 %: dh $@ debian/control（维护者版本，v=0.2）：.  $ vim debhello-0.2/debian/control ... hack, hack, hack, ... $ cat debhello-0.2/debian/control Source: debhello Section: devel Priority: optional Maintainer: Osamu Aoki Build-Depends: debhelper-compat (= 13)     Standards-Version: 4.5.1 Homepage: https://salsa.debian.org/debian/debmake-doc Rules-Requires-Root: no Package: debhello Architecture: all Multi-Arch: foreign Depends: ${misc:Depends} Description: Simple packaging example for debmake This Debian binary package is an example package. (This is an example only) Warning     如果您对 debian/control 模板文件中的“Section: unknown”部分不作修 改的话，后续的 lintian 错误可能导致构建失败。 debian/install（维护者版本，v=0.2）：.  $ vim debhello-0.2/debian/install     ... hack, hack, hack, ... $ cat debhello-0.2/debian/install data/hello.desktop usr/share/applications data/hello.png usr/share/pixmaps scripts/hello usr/bin debian/manpages（维护者版本，v=0.2）：.      $ vim debhello-0.2/debian/manpages ... hack, hack, hack, ... $ cat debhello-0.2/debian/manpages man/hello.1     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。 debian/ 目录下的模板文件。（v=0.2）：.  $ tree debhello-0.2/debian debhello-0.2/debian ├── README.Debian ├── changelog ├── control ├── copyright ├── install ├── manpages ├── patches │   └── series     ├── rules ├── source │   ├── control │   ├── format │   ├── local-options │   ├── options │   └── patch-header ├── tests │   └── control ├── upstream │   └── metadata └── watch 4 directories, 16 files 您可以在此源代码树中使用 debuild 命令（或其等效命令）创建非原生的     Debian 软件包。如下所示，该命令的输出非常详细，并且解释了它所做的 事。 $ cd debhello-0.2 $ debuild dpkg-buildpackage -us -uc -ui -i -i ... debian/rules clean dh clean ... debian/rules binary dh binary     dh_update_autotools_config dh_autoreconf create-stamp debian/debhelper-build-stamp dh_prep rm -f -- debian/debhello.substvars rm -fr -- debian/.debhelper/generated/debhello/ debian/debhello/ debi... dh_install install -d debian/debhello/usr/bin cp --reflink=auto -a ./scripts/hello debian/debhello/usr/bin/ ...     现在我们来看看成果如何。 通过 debuild 生成的第 0.2 版的 debhello 文件：.  $ cd .. $ tree -FL 1 . ├── debhello-0.2/ ├── debhello-0.2.tar.gz     ├── debhello_0.2-1.debian.tar.xz ├── debhello_0.2-1.dsc ├── debhello_0.2-1_all.deb ├── debhello_0.2-1_amd64.build ├── debhello_0.2-1_amd64.buildinfo ├── debhello_0.2-1_amd64.changes └── debhello_0.2.orig.tar.gz -> debhello-0.2.tar.gz 1 directory, 8 files     您可以看见生成的全部文件。 * debhello_0.2.orig.tar.gz 是指向上游源码包的符号链接。 * debhello_0.2-1.debian.tar.xz 包含了维护者生成的内容。 * debhello_0.2-1.dsc 是 Debian 源码包的元数据文件。 * The debhello_0.2-1_all.deb 是 Debian 二进制软件包。     * debhello_0.2-1_amd64.build 是 Debian 二进制软件包。 * debhello_0.2-1_amd64.buildinfo 文件是由 dpkg-genbuildinfo(1) 自动生成的元文件。 * debhello_0.2-1_amd64.changes 是 Debian 二进制软件包的元数据文 件。     debhello_0.2-1.debian.tar.xz 包含了 Debian 对上游源代码的修改，具 体如下所示。 压缩过的归档文件 debhello_0.2-1.debian.tar.xz 中的内容物：.  $ tar -tzf debhello-0.2.tar.gz debhello-0.2/ debhello-0.2/data/ debhello-0.2/data/hello.desktop debhello-0.2/data/hello.png debhello-0.2/man/ debhello-0.2/man/hello.1 debhello-0.2/scripts/ debhello-0.2/scripts/hello debhello-0.2/LICENSE $ tar --xz -tf debhello_0.2-1.debian.tar.xz debian/ debian/README.Debian debian/changelog     debian/control debian/copyright debian/install debian/manpages debian/patches/ debian/patches/series debian/rules debian/source/ debian/source/control debian/source/format debian/source/options debian/source/patch-header debian/tests/ debian/tests/control debian/upstream/ debian/upstream/metadata debian/watch     debhello_0.2-1_amd64.deb 包含了将要安装至系统中的文件，如下所示。 debhello_0.2-1_all.deb 二进制软件包中的内容：.  $ dpkg -c debhello_0.2-1_all.deb drwxr-xr-x root/root ... ./ drwxr-xr-x root/root ... ./usr/ drwxr-xr-x root/root ... ./usr/bin/ -rwxr-xr-x root/root ... ./usr/bin/hello drwxr-xr-x root/root ... ./usr/share/ drwxr-xr-x root/root ... ./usr/share/applications/     -rw-r--r-- root/root ... ./usr/share/applications/hello.desktop drwxr-xr-x root/root ... ./usr/share/doc/ drwxr-xr-x root/root ... ./usr/share/doc/debhello/ -rw-r--r-- root/root ... ./usr/share/doc/debhello/README.Debian -rw-r--r-- root/root ... ./usr/share/doc/debhello/changelog.Debian.gz -rw-r--r-- root/root ... ./usr/share/doc/debhello/copyright drwxr-xr-x root/root ... ./usr/share/man/ drwxr-xr-x root/root ... ./usr/share/man/man1/ -rw-r--r-- root/root ... ./usr/share/man/man1/hello.1.gz drwxr-xr-x root/root ... ./usr/share/pixmaps/ -rw-r--r-- root/root ... ./usr/share/pixmaps/hello.png     此处是生成的 debhello_0.2-1_all.deb 的依赖项列表。 debhello_0.2-1_all.deb 的依赖项列表：.      $ dpkg -f debhello_0.2-1_all.deb pre-depends depends recommends conflicts br...     (No extra dependency packages required since this is a POSIX shell program.) Note If you wish to replace upstream provided PNG file data/hello.png     with maintainer provided one debian/hello.png, editing debian/ install isn’t enough. When you add debian/hello.png, you need to add a line "include-binaries" to debian/source/options since PNG is a binary file. See dpkg-source(1). 8.3. Makefile（shell，命令行界面）     下面是从 POSIX shell 命令行界面程序创建简单的 Debian 软件包的示例 ，我们假设它使用 Makefile 作为构建系统。     让我们假设上游的源码包为 debhello-1.0.tar.gz。     这一类源代码设计可以用这样的方式安装成为非系统文件： $ tar -xzmf debhello-1.0.tar.gz     $ cd debhello-1.0 $ make install     Debian 的打包需要对“make install”流程进行改变，从而将文件安装至目 标系统镜像所在位置，而非通常使用的 /usr/local 下的位置。     让我们取得源码并制作 Debian 软件包。 下载 debhello-1.0.tar.gz.  $ wget http://www.example.org/download/debhello-1.0.tar.gz ... $ tar -xzmf debhello-1.0.tar.gz $ tree . ├── debhello-1.0 │   ├── LICENSE     │   ├── Makefile │   ├── data │   │   ├── hello.desktop │   │   └── hello.png │   ├── man │   │   └── hello.1 │   └── scripts │   └── hello └── debhello-1.0.tar.gz 4 directories, 7 files 这里的 Makefile 正确使用 $(DESTDIR) 和 $(prefix)。其他的所有文件     都和 Section 8.2, “无 Makefile（shell，命令行界面）” 中的一样，并 且大多数的打包工作也都一样。 Makefile（v=1.0）.  $ cat debhello-1.0/Makefile prefix = /usr/local all: : # do nothing install: install -D scripts/hello \ $(DESTDIR)$(prefix)/bin/hello install -m 644 -D data/hello.desktop \ $(DESTDIR)$(prefix)/share/applications/hello.desktop install -m 644 -D data/hello.png \     $(DESTDIR)$(prefix)/share/pixmaps/hello.png install -m 644 -D man/hello.1 \ $(DESTDIR)$(prefix)/share/man/man1/hello.1 clean: : # do nothing distclean: clean uninstall: -rm -f $(DESTDIR)$(prefix)/bin/hello -rm -f $(DESTDIR)$(prefix)/share/applications/hello.desktop -rm -f $(DESTDIR)$(prefix)/share/pixmaps/hello.png -rm -f $(DESTDIR)$(prefix)/share/man/man1/hello.1 .PHONY: all install clean distclean uninstall     让我们使用 debmake 命令来打包。这里使用 -b':sh' 选项来指明生成的 二进制包是一个 shell 脚本。 $ cd debhello-1.0 $ debmake -b':sh' -e osamu@debian.org -f 'Osamu Aoki' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="1.0", rev="1" I: *** start packaging in "debhello-1.0". *** I: provide debhello_1.0.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-1.0.tar.gz debhello_1.0.orig.tar.gz I: pwd = "/path/to/debhello-1.0" I: parse binary package settings: :sh I: binary package=debhello Type=script / Arch=all M-A=foreign I: analyze the source tree I: build_type = make I: scan source for copyright+license text and file extensions I: 33 %, ext = desktop ...     让我们来检查一下自动产生的模板文件。 debian/rules（模板文件，v=1.0）：.  $ cat debhello-1.0/debian/rules #!/usr/bin/make -f # You must remove unused comment lines for the released package. #export DH_VERBOSE = 1     %: dh $@ #override_dh_auto_install: # dh_auto_install -- prefix=/usr #override_dh_install: # dh_install --list-missing -X.pyc -X.pyo     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=1.0）：.  $ vim debhello-1.0/debian/rules ... hack, hack, hack, ... $ cat debhello-1.0/debian/rules #!/usr/bin/make -f     export DH_VERBOSE = 1 %: dh $@ override_dh_auto_install: dh_auto_install -- prefix=/usr     因为上游源码含有正确的上游 Makefile 文件，所以没有必要再去创建 debian/install 和 debian/manpages 文件。     debian/control 文件和 Section 8.2, “无 Makefile（shell，命令行界 面）” 中的完全一致。     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。 debian/ 目录下的模板文件。（v=1.0）：.  $ tree debhello-1.0/debian debhello-1.0/debian ├── README.Debian ├── changelog ├── control ├── copyright ├── patches │   └── series ├── rules     ├── source │   ├── control │   ├── format │   ├── local-options │   ├── options │   └── patch-header ├── tests │   └── control ├── upstream │   └── metadata └── watch 4 directories, 14 files     其余的打包操作基本上和 Section 8.2, “无 Makefile（shell，命令行界 面）” 中的相同。 8.4. setup.py（Python3，命令行界面） Many interesting upstream Python program packages are packaged using the setuptools based setup.py. Usually, these source packages are built into Python specific binary distribution     format wheel and wheel packages are distributed to end users. Then, end users find these from package listing sites such as the Python Package Index (PyPI) and install these wheel packages using pip to the user’s environment. In order to make Debian package of these Python programs, you must start with their source packages. The current Debian packaging practice of such Python programs uses dh_python3(1) and     pybuild(1) from dh_python package. Although setuptools isn’t mentioned in pybuild(1), you can treat these as if these are packaged using the distutils based setup.py since setuptools is an enhanced extension of distutils. ^[23]     Let’s assume the upstream tarball to be debhello-1.1.tar.gz. "Installing Python Modules (Legacy version)" explains how to     install source to the system using distutils. Essentially, the source is installed using distutils as: $ tar -xzmf debhello-1.1.tar.gz     $ cd debhello-1.1 $ python3 setup.py install Debian packaging requires changing the last line to “python3     setup.py install --install-layout=deb” to install files into the target system image location. This is automatically addressed when using the dh command for Debian packaging. Here is an example of creating a simple Debian package from a     Python3 CLI program using the setuptools based setup.py as its build system.     让我们取得源码并制作 Debian 软件包。 下载 debhello-1.1.tar.gz.  $ wget http://www.example.org/download/debhello-1.1.tar.gz ... $ tar -xzmf debhello-1.1.tar.gz $ tree . ├── debhello-1.1 │   ├── LICENSE │   ├── MANIFEST.in │   ├── README.md │   ├── data     │   │   ├── hello.desktop │   │   └── hello.png │   ├── manpages │   │   └── hello.1 │   ├── pyproject.toml │   ├── setup.cfg │   ├── setup.py │   └── src │   └── debhello │   ├── __init__.py │   └── __main__.py └── debhello-1.1.tar.gz 5 directories, 12 files     Here, the content of this debhello source tree as follows. setup.py (v=1.1) — a boilar plate setup.py for the backward compatibility.      $ cat debhello-1.1/setup.py # coding: utf-8 import setuptools setuptools.setup() setup.cfg (v=1.1) — modern static metadata.  $ cat debhello-1.1/setup.cfg [metadata] name = debhello version = attr: debhello.__version__ description = Hello Python (CLI) long_description = file: README.md classifiers = Development Status :: 5 - Production/Stable Intended Audience :: Developers Topic :: System :: Archiving :: Packaging License :: OSI Approved :: MIT License Programming Language :: Python Programming Language :: Python :: 3 Programming Language :: Python :: 3.5 Programming Language :: Python :: 3.6 Programming Language :: Python :: 3.7 Programming Language :: Python :: 3.8 Programming Language :: Python :: 3.9 author = Osamu Aoki     author_email = osamu@debian.org maintainer = Osamu Aoki maintainer_email = osamu@debian.org url = https://salsa.debian.org/debian/debmake-doc project_urls = Documentation = https://salsa.debian.org/debian/debmake-doc keywords = debhello license = MIT [options] package_dir = = src packages = find: python_requires = >=3.4 setup_requires = setuptools >= 42 [options.packages.find] where = src [options.entry_points] console_scripts = hello = debhello.__main__:main pyproject.toml (v=1.1) — PEP 517 configuration.  $ cat debhello-1.1/pyproject.toml [build-system]     requires = [ "setuptools>=42", "wheel" ] build-backend = "setuptools.build_meta" MANIFEST.in (v=1.1) — for distutils to make sdist.      $ cat debhello-1.1/MANIFEST.in include data/* include manpages/* src/debhello/__init__.py (v=1.1) — program version definition.      $ cat debhello-1.1/src/debhello/__init__.py __version__ = '1.1.0' src/debhello/__main__.py (v=1.1) — command entry point.  $ cat debhello-1.1/src/debhello/__main__.py """ debhello command line entry (enable python -m debhello syntax) """ import sys import debhello     def main(): # needed for console script print(' ========== Hello Python3 ==========') print('argv = {}'.format(sys.argv)) print('version = {}'.format(debhello.__version__)) return if __name__ == "__main__": sys.exit(main())     让我们使用 debmake 命令来打包。这里使用 -b':py3' 选项来指明生成的 二进制包包含 Python3 脚本和模块文件。 $ cd debhello-1.1 $ debmake -b':py3' -e osamu@debian.org -f 'Osamu Aoki' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="1.1", rev="1" I: *** start packaging in "debhello-1.1". *** I: provide debhello_1.1.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-1.1.tar.gz debhello_1.1.orig.tar.gz I: pwd = "/path/to/debhello-1.1" I: parse binary package settings: :py3 I: binary package=debhello Type=python3 / Arch=all M-A=foreign I: analyze the source tree W: unknown python version. check setup.py. I: build_type = I: scan source for copyright+license text and file extensions ...     让我们来检查一下自动产生的模板文件。 debian/rules（模板文件，v=1.1）：.  $ cat debhello-1.1/debian/rules #!/usr/bin/make -f     # You must remove unused comment lines for the released package. #export DH_VERBOSE = 1 %: dh $@ --with python3     这基本上是带有 dh 命令的标准 debian/rules 文件。     使用“--with python3”选项会调用 dh_python3 来计算 Python 依赖项、 将维护者脚本添加到字节码文件等。参见 dh_python3(1)。     使用“--buildsystem=pybuild”选项会为要求的 Python 版本调用各种构建 系统，以便构建模块和扩展。参见 pybuild(1)。 debian/control（模板文件，v=1.1）：.  $ cat debhello-1.1/debian/control Source: debhello Section: unknown Priority: optional Maintainer: Osamu Aoki Build-Depends: debhelper-compat (= 13), dh-python, python3-all Standards-Version: 4.5.1     Homepage: Rules-Requires-Root: no Package: debhello Architecture: all Multi-Arch: foreign Depends: ${misc:Depends}, ${python3:Depends} Description: auto-generated package by debmake This Debian binary package was auto-generated by the debmake(1) command provided by the debmake package. 因为这是 Python3 软件包，debmake 命令会设置“Architecture: all”和“     Multi-Arch: foreign”。此外，它还将所需的 substvar 参数设置为“ Depends: ${python3:Depends}, ${misc:Depends}”。Chapter 5, 基本内 容对这些做出了解释。     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=1.1）：.  $ vim debhello-1.1/debian/rules ... hack, hack, hack, ... $ cat debhello-1.1/debian/rules     #!/usr/bin/make -f export PYBUILD_NAME=debhello export PYBUILD_VERBOSE=1 export DH_VERBOSE=1 %: dh $@ --with python3 --buildsystem=pybuild debian/control（维护者版本，v=1.1）：.  $ vim debhello-1.1/debian/control ... hack, hack, hack, ... $ cat debhello-1.1/debian/control Source: debhello Section: devel Priority: optional Maintainer: Osamu Aoki Build-Depends: debhelper-compat (= 13), dh-python, python3-all, python3-setuptools     Standards-Version: 4.5.1 Rules-Requires-Root: no Vcs-Browser: https://salsa.debian.org/debian/debmake-doc Vcs-Git: https://salsa.debian.org/debian/debmake-doc.git Homepage: https://salsa.debian.org/debian/debmake-doc Package: debhello Architecture: all Depends: ${misc:Depends}, ${python3:Depends} Description: Simple packaging example for debmake This is an example package to demonstrate Debian packaging using the debmake command. . The generated Debian package uses the dh command offered by the debhelper package and the dpkg source format `3.0 (quilt)'.     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。 This debhello command comes with the upstream-provided manpage     and desktop file but the upstream setup.cfg doesn’t install them. So you need to update debian/install and debian/manpages as follows: debian/install (maintainer version, v=1.1):  $ vim debhello-1.1/debian/install     ... hack, hack, hack, ... $ cat debhello-1.1/debian/install data/hello.desktop usr/share/applications data/hello.png usr/share/pixmaps debian/manpages (maintainer version, v=1.1):      $ vim debhello-1.1/debian/manpages ... hack, hack, hack, ... $ cat debhello-1.1/debian/manpages manpages/hello.1     其余的打包工作与 Section 8.3, “Makefile（shell，命令行界面）” 中 的几乎一致。 debian/ 目录下的模板文件。（v=1.1）：.  $ tree debhello-1.1/debian debhello-1.1/debian ├── README.Debian ├── changelog ├── control ├── copyright ├── install ├── manpages ├── patches │   └── series     ├── rules ├── source │   ├── control │   ├── format │   ├── local-options │   ├── options │   └── patch-header ├── tests │   └── control ├── upstream │   └── metadata └── watch 4 directories, 16 files     此处是生成的 debhello_1.1-1_all.deb 包的依赖项列表。 debhello_1.1-1_all.deb 的依赖项列表：.      $ dpkg -f debhello_1.1-1_all.deb pre-depends depends recommends conflicts br... Depends: python3:any 8.5. Makefile（shell，图形界面）     此处是一个从 POSIX shell 图形界面程序构建简单的 Debian 软件包的示 例，我们假设程序使用 Makefile 作为构建系统。     上游是基于 Section 8.3, “Makefile（shell，命令行界面）” 中的源代 码，并带有增强的图形界面支持。     让我们假设上游的源码包为 debhello-1.2.tar.gz。     让我们取得源码并制作 Debian 软件包。 下载 debhello-1.2.tar.gz.  $ wget http://www.example.org/download/debhello-1.2.tar.gz ... $ tar -xzmf debhello-1.2.tar.gz $ tree . ├── debhello-1.2 │   ├── LICENSE     │   ├── Makefile │   ├── data │   │   ├── hello.desktop │   │   └── hello.png │   ├── man │   │   └── hello.1 │   └── scripts │   └── hello └── debhello-1.2.tar.gz 4 directories, 7 files     此处的 hello 已经被重写以便使用 zenity 命令来使其成为 GTK+ 图形界 面程序。 hello（v=1.2）.      $ cat debhello-1.2/scripts/hello #!/bin/sh -e zenity --info --title "hello" --text "Hello from the shell!"     这里，作为图形界面程序，桌面文件被更新为 Terminal=false。 hello.desktop（v=1.2）.  $ cat debhello-1.2/data/hello.desktop [Desktop Entry] Name=Hello Name[fr]=Bonjour     Comment=Greetings Comment[fr]=Salutations Type=Application Keywords=hello Exec=hello Terminal=false Icon=hello.png Categories=Utility;     其余的所有文件都与 Section 8.3, “Makefile（shell，命令行界面）” 中的一致。     让我们使用 debmake 命令来打包。这里使用 -b':sh' 选项来指明生成的 二进制包是一个 shell 脚本。 $ cd debhello-1.2 $ debmake -b':sh' -e osamu@debian.org -f 'Osamu Aoki' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="1.2", rev="1" I: *** start packaging in "debhello-1.2". *** I: provide debhello_1.2.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-1.2.tar.gz debhello_1.2.orig.tar.gz I: pwd = "/path/to/debhello-1.2" I: parse binary package settings: :sh I: binary package=debhello Type=script / Arch=all M-A=foreign I: analyze the source tree I: build_type = make I: scan source for copyright+license text and file extensions I: 33 %, ext = desktop ...     让我们来检查一下自动产生的模板文件。 debian/control（模板文件，v=1.2）：.  $ cat debhello-1.2/debian/control Source: debhello Section: unknown Priority: optional Maintainer: Osamu Aoki Build-Depends: debhelper-compat (= 13) Standards-Version: 4.5.1     Homepage: Rules-Requires-Root: no Package: debhello Architecture: all Multi-Arch: foreign Depends: ${misc:Depends} Description: auto-generated package by debmake This Debian binary package was auto-generated by the debmake(1) command provided by the debmake package.     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/control（维护者版本，v=1.2）：.  $ vim debhello-1.2/debian/control ... hack, hack, hack, ... $ cat debhello-1.2/debian/control Source: debhello Section: devel Priority: optional Maintainer: Osamu Aoki Build-Depends: debhelper-compat (= 13)     Standards-Version: 4.5.1 Homepage: https://salsa.debian.org/debian/debmake-doc Rules-Requires-Root: no Package: debhello Architecture: all Multi-Arch: foreign Depends: zenity, ${misc:Depends} Description: Simple packaging example for debmake This Debian binary package is an example package. (This is an example only)     请注意，这里需要手动添加 zenity 依赖。     debian/rules 文件与 Section 8.3, “Makefile（shell，命令行界面）” 中的完全一致。     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。 debian/ 目录下的模板文件。（v=1.2）：.  $ tree debhello-1.2/debian debhello-1.2/debian ├── README.Debian ├── changelog ├── control ├── copyright ├── patches │   └── series ├── rules     ├── source │   ├── control │   ├── format │   ├── local-options │   ├── options │   └── patch-header ├── tests │   └── control ├── upstream │   └── metadata └── watch 4 directories, 14 files     其余的打包工作与 Section 8.3, “Makefile（shell，命令行界面）” 中 的几乎一致。     此处是 debhello_1.2-1_all.deb 的依赖项列表。 debhello_1.2-1_all.deb 的依赖项列表：.      $ dpkg -f debhello_1.2-1_all.deb pre-depends depends recommends conflicts br... Depends: zenity 8.6. setup.py（Python3，图形界面） Here is an example of creating a simple Debian package from a     Python3 GUI program using the setuptools based setup.py as its build system.     上游是基于 Section 8.4, “setup.py（Python3，命令行界面）” 中的源 代码，并带有增强的图形界面、桌面图标、手册页。     让我们假设上游源码包为 debhello-1.3.tar.gz。     让我们取得源码并制作 Debian 软件包。 下载 debhello-1.3.tar.gz.  $ wget http://www.example.org/download/debhello-1.3.tar.gz ... $ tar -xzmf debhello-1.3.tar.gz $ tree . ├── debhello-1.3 │   ├── LICENSE │   ├── MANIFEST.in │   ├── README.md │   ├── data     │   │   ├── hello.desktop │   │   └── hello.png │   ├── manpages │   │   └── hello.1 │   ├── pyproject.toml │   ├── setup.cfg │   ├── setup.py │   └── src │   └── debhello │   ├── __init__.py │   └── __main__.py └── debhello-1.3.tar.gz 5 directories, 12 files     Here, the content of this debhello source tree as follows. setup.py (v=1.3) — a boilar plate setup.py for the backward compatibility.      $ cat debhello-1.3/setup.py import setuptools setuptools.setup() setup.cfg (v=1.3) — modern static metadata.  $ cat debhello-1.3/setup.cfg [metadata] name = debhello version = attr: debhello.__version__ description = Hello Python (GUI) long_description = file: README.md classifiers = Development Status :: 5 - Production/Stable Intended Audience :: Developers Topic :: System :: Archiving :: Packaging License :: OSI Approved :: MIT License Programming Language :: Python Programming Language :: Python :: 3 Programming Language :: Python :: 3.5 Programming Language :: Python :: 3.6 Programming Language :: Python :: 3.7 Programming Language :: Python :: 3.8 Programming Language :: Python :: 3.9 author = Osamu Aoki     author_email = osamu@debian.org maintainer = Osamu Aoki maintainer_email = osamu@debian.org url = https://salsa.debian.org/debian/debmake-doc project_urls = Documentation = https://salsa.debian.org/debian/debmake-doc keywords = debhello license = MIT [options] package_dir = = src packages = find: python_requires = >=3.4 setup_requires = setuptools >= 42 [options.packages.find] where = src [options.entry_points] console_scripts = hello = debhello.__main__:main pyproject.toml (v=1.3) — PEP 517 configuration.  $ cat debhello-1.3/pyproject.toml [build-system]     requires = [ "setuptools>=42", "wheel" ] build-backend = "setuptools.build_meta" MANIFEST.in (v=1.3) — for distutils to make sdist.      $ cat debhello-1.3/MANIFEST.in include data/* include manpages/* src/debhello/__init__.py (v=1.3) — program version definition.      $ cat debhello-1.3/src/debhello/__init__.py __version__ = '1.3.0' src/debhello/__main__.py (v=1.3) — command entry point.  $ cat debhello-1.3/src/debhello/__main__.py #!/usr/bin/python3 from gi.repository import Gtk class TopWindow(Gtk.Window): def __init__(self): Gtk.Window.__init__(self) self.title = "Hello World!" self.counter = 0 self.border_width = 10 self.set_default_size(400, 100) self.set_position(Gtk.WindowPosition.CENTER) self.button = Gtk.Button(label="Click me!")     self.button.connect("clicked", self.on_button_clicked) self.add(self.button) self.connect("delete-event", self.on_window_destroy) def on_window_destroy(self, *args): Gtk.main_quit(*args) def on_button_clicked(self, widget): self.counter += 1 widget.set_label("Hello, World!\nClick count = %i" % self.counter) def main(): window = TopWindow() window.show_all() Gtk.main() if __name__ == '__main__': main()     让我们使用 debmake 命令来打包。这里使用 -b':py3' 选项来指明生成的 二进制包包含 Python3 脚本和模块文件。 $ cd debhello-1.3 $ debmake -b':py3' -e osamu@debian.org -f 'Osamu Aoki' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="1.3", rev="1" I: *** start packaging in "debhello-1.3". *** I: provide debhello_1.3.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-1.3.tar.gz debhello_1.3.orig.tar.gz I: pwd = "/path/to/debhello-1.3" I: parse binary package settings: :py3 I: binary package=debhello Type=python3 / Arch=all M-A=foreign I: analyze the source tree W: unknown python version. check setup.py. I: build_type = I: scan source for copyright+license text and file extensions ...     其余的步骤与 Section 8.4, “setup.py（Python3，命令行界面）” 中的 基本一致。     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=1.3）：.  $ vim debhello-1.3/debian/rules ... hack, hack, hack, ... $ cat debhello-1.3/debian/rules     #!/usr/bin/make -f export PYBUILD_NAME=debhello export PYBUILD_VERBOSE=1 export DH_VERBOSE=1 %: dh $@ --with python3 --buildsystem=pybuild debian/control（维护者版本，v=1.3）：.  $ vim debhello-1.3/debian/control ... hack, hack, hack, ... $ cat debhello-1.3/debian/control Source: debhello Section: devel Priority: optional Maintainer: Osamu Aoki Build-Depends: debhelper-compat (= 13), dh-python, python3-all     Standards-Version: 4.5.1 Homepage: https://salsa.debian.org/debian/debmake-doc Rules-Requires-Root: no Package: debhello Architecture: all Multi-Arch: foreign Depends: gir1.2-gtk-3.0, python3-gi, ${misc:Depends}, ${python3:Depends} Description: Simple packaging example for debmake This Debian binary package is an example package. (This is an example only)     请注意，此处需要手动添加 python3-gi 和 gir1.2-gtk-3.0 依赖。     其余的打包工作与 Section 8.4, “setup.py（Python3，命令行界面）” 中的几乎完全一致。     此处是 debhello_1.3-1_all.deb 的依赖项列表。 debhello_1.3-1_all.deb 的依赖项列表：.      $ dpkg -f debhello_1.3-1_all.deb pre-depends depends recommends conflicts br... Depends: gir1.2-gtk-3.0, python3-gi, python3:any 8.7. Makefile（单个二进制软件包）     这里给出了从简单的 C 语言源代码创建简单的 Debian 软件包的例子，并 假设上游使用了 Makefile 作为构建系统。 此处的上游源代码是 Chapter 4, 简单例子中的源代码的增强版本。它带     有手册页、桌面文件和桌面图标。并且为了更加贴合实际，它还有一个外 部库文件 libm。     让我们假设上游源码包为 debhello-1.4.tar.gz。     这一类源代码设计可以用这样的方式安装成为非系统文件： $ tar -xzmf debhello-1.4.tar.gz     $ cd debhello-1.4 $ make $ make install     Debian 的打包需要对“make install”流程进行改变，从而将文件安装至系 统镜像所在位置，而非通常使用的 /usr/local 下的位置。     让我们取得源码并制作 Debian 软件包。 下载 debhello-1.4.tar.gz.  $ wget http://www.example.org/download/debhello-1.4.tar.gz ... $ tar -xzmf debhello-1.4.tar.gz $ tree . ├── debhello-1.4 │   ├── LICENSE │   ├── Makefile     │   ├── data │   │   ├── hello.desktop │   │   └── hello.png │   ├── man │   │   └── hello.1 │   └── src │   ├── config.h │   └── hello.c └── debhello-1.4.tar.gz 4 directories, 8 files     此处的源码如下所示。 src/hello.c（v=1.4）：.  $ cat debhello-1.4/src/hello.c #include "config.h" #include #include     int main() { printf("Hello, I am " PACKAGE_AUTHOR "!\n"); printf("4.0 * atan(1.0) = %10f8\n", 4.0*atan(1.0)); return 0; } src/config.h（v=1.4）：.      $ cat debhello-1.4/src/config.h #define PACKAGE_AUTHOR "Osamu Aoki" Makefile（v=1.4）：.  $ cat debhello-1.4/Makefile prefix = /usr/local all: src/hello src/hello: src/hello.c $(CC) $(CPPFLAGS) $(CFLAGS) $(LDFLAGS) -o $@ $^ -lm install: src/hello install -D src/hello \ $(DESTDIR)$(prefix)/bin/hello install -m 644 -D data/hello.desktop \ $(DESTDIR)$(prefix)/share/applications/hello.desktop     install -m 644 -D data/hello.png \ $(DESTDIR)$(prefix)/share/pixmaps/hello.png install -m 644 -D man/hello.1 \ $(DESTDIR)$(prefix)/share/man/man1/hello.1 clean: -rm -f src/hello distclean: clean uninstall: -rm -f $(DESTDIR)$(prefix)/bin/hello -rm -f $(DESTDIR)$(prefix)/share/applications/hello.desktop -rm -f $(DESTDIR)$(prefix)/share/pixmaps/hello.png -rm -f $(DESTDIR)$(prefix)/share/man/man1/hello.1 .PHONY: all install clean distclean uninstall     请注意，此 Makefile 含有正确的手册页、桌面文件、桌面图标的 install 对象。     让我们使用 debmake 命令打包。 $ cd debhello-1.4 $ debmake -e osamu@debian.org -f 'Osamu Aoki' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="1.4", rev="1" I: *** start packaging in "debhello-1.4". *** I: provide debhello_1.4.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-1.4.tar.gz debhello_1.4.orig.tar.gz I: pwd = "/path/to/debhello-1.4" I: parse binary package settings: I: binary package=debhello Type=bin / Arch=any M-A=foreign I: analyze the source tree I: build_type = make I: scan source for copyright+license text and file extensions I: 40 %, ext = c ...     其余的工作与 Section 4.6, “第二步：使用 debmake 产生模板文件” 中 的几乎一致。     像 Section 4.7, “第三步：编辑模板文件” 中所写的一样，让我们这些维 护者来把这个 Debian 软件包做的更好。 如果环境变量 DEB_BUILD_MAINT_OPTIONS 没有在 debian/rules 文件中进     行导出，lintian 会在链接 libm 时抛出警告：“W: debhello: hardening-no-relro usr/bin/hello”。 debian/control 文件与 Section 4.7, “第三步：编辑模板文件” 中的完     全一致，因为 libm 库是 libc6 库的一部分，所以它总是可获得的（优先 级：必需 / Priority: required）。     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。 debian/ 目录下的模板文件。（v=1.4）：.  $ tree debhello-1.4/debian debhello-1.4/debian ├── README.Debian ├── changelog ├── control ├── copyright ├── patches │   └── series ├── rules     ├── source │   ├── control │   ├── format │   ├── local-options │   ├── options │   └── patch-header ├── tests │   └── control ├── upstream │   └── metadata └── watch 4 directories, 14 files     其余的打包步骤与 Section 4.8, “第四步：使用 debuild 构建软件包” 中的基本一致。     此处是生成的二进制包的依赖项列表。 生成的二进制包的依赖项列表（v=1.4）：.      $ dpkg -f debhello-dbgsym_1.4-1_amd64.deb pre-depends depends recommends con... Depends: debhello (= 1.4-1) $ dpkg -f debhello_1.4-1_amd64.deb pre-depends depends recommends conflicts ... Depends: libc6 (>= 2.3.4) 8.8. Makefile.in + configure（单个二进制软件包）     这里给出了从简单的 C 语言源代码创建简单的 Debian 软件包的例子，并 假设上游使用了 Makefile.in 和 configure 作为构建系统。 此处的源码示例是 Section 8.7, “Makefile（单个二进制软件包）” 中的     源代码的增强版本。它也有一个外部链接库 libm，并且它的源代码可以使 用 configure 脚本进行配置，然后生成相应的 Makefile、src/config.h 文件。     让我们假设上游源码包为 debhello-1.5.tar.gz。     此类型的源码旨在作为非系统文件安装，例如： $ tar -xzmf debhello-1.5.tar.gz $ cd debhello-1.5     $ ./configure --with-math $ make $ make install     让我们取得源码并制作 Debian 软件包。 下载 debhello-1.5.tar.gz.  $ wget http://www.example.org/download/debhello-1.5.tar.gz ... $ tar -xzmf debhello-1.5.tar.gz $ tree . ├── debhello-1.5 │   ├── LICENSE │   ├── Makefile.in     │   ├── configure │   ├── data │   │   ├── hello.desktop │   │   └── hello.png │   ├── man │   │   └── hello.1 │   └── src │   └── hello.c └── debhello-1.5.tar.gz 4 directories, 8 files     此处的源码如下所示。 src/hello.c（v=1.5）：.  $ cat debhello-1.5/src/hello.c #include "config.h" #ifdef WITH_MATH # include #endif #include int     main() { printf("Hello, I am " PACKAGE_AUTHOR "!\n"); #ifdef WITH_MATH printf("4.0 * atan(1.0) = %10f8\n", 4.0*atan(1.0)); #else printf("I can't do MATH!\n"); #endif return 0; } Makefile.in（v=1.5）：.  $ cat debhello-1.5/Makefile.in prefix = @prefix@ all: src/hello src/hello: src/hello.c $(CC) @VERBOSE@ \ $(CPPFLAGS) \ $(CFLAGS) \ $(LDFLAGS) \ -o $@ $^ \ @LINKLIB@ install: src/hello install -D src/hello \ $(DESTDIR)$(prefix)/bin/hello     install -m 644 -D data/hello.desktop \ $(DESTDIR)$(prefix)/share/applications/hello.desktop install -m 644 -D data/hello.png \ $(DESTDIR)$(prefix)/share/pixmaps/hello.png install -m 644 -D man/hello.1 \ $(DESTDIR)$(prefix)/share/man/man1/hello.1 clean: -rm -f src/hello distclean: clean uninstall: -rm -f $(DESTDIR)$(prefix)/bin/hello -rm -f $(DESTDIR)$(prefix)/share/applications/hello.desktop -rm -f $(DESTDIR)$(prefix)/share/pixmaps/hello.png -rm -f $(DESTDIR)$(prefix)/share/man/man1/hello.1 .PHONY: all install clean distclean uninstall configure（v=1.5）：.  $ cat debhello-1.5/configure #!/bin/sh -e # default values PREFIX="/usr/local" VERBOSE="" WITH_MATH="0" LINKLIB="" PACKAGE_AUTHOR="John Doe" # parse arguments while [ "${1}" != "" ]; do VAR="${1%=*}" # Drop suffix =* VAL="${1#*=}" # Drop prefix *= case "${VAR}" in --prefix) PREFIX="${VAL}" ;; --verbose|-v) VERBOSE="-v" ;;     --with-math) WITH_MATH="1" LINKLIB="-lm" ;; --author) PACKAGE_AUTHOR="${VAL}" ;; *) echo "W: Unknown argument: ${1}" esac shift done # setup configured Makefile and src/config.h sed -e "s,@prefix@,${PREFIX}," \ -e "s,@VERBOSE@,${VERBOSE}," \ -e "s,@LINKLIB@,${LINKLIB}," \ Makefile if [ "${WITH_MATH}" = 1 ]; then echo "#define WITH_MATH" >src/config.h else echo "/* not defined: WITH_MATH */" >src/config.h fi echo "#define PACKAGE_AUTHOR \"${PACKAGE_AUTHOR}\"" >>src/config.h     请注意，configure 命令替换 Makefile.in 文件中的 @…@ 字符串以生成 Makefile 与 src/config.h。     让我们使用 debmake 命令打包。 $ cd debhello-1.5 $ debmake -e osamu@debian.org -f 'Osamu Aoki' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="1.5", rev="1" I: *** start packaging in "debhello-1.5". *** I: provide debhello_1.5.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-1.5.tar.gz debhello_1.5.orig.tar.gz I: pwd = "/path/to/debhello-1.5" I: parse binary package settings: I: binary package=debhello Type=bin / Arch=any M-A=foreign I: analyze the source tree I: build_type = configure I: scan source for copyright+license text and file extensions I: 20 %, ext = in ...     结果与 Section 4.6, “第二步：使用 debmake 产生模板文件” 中的相似 ，但是并不完全一致。     让我们来检查一下自动产生的模板文件。 debian/rules（模板文件，v=1.5）：.  $ cat debhello-1.5/debian/rules #!/usr/bin/make -f # You must remove unused comment lines for the released package.     #export DH_VERBOSE = 1 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all #export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=1.5）：.  $ vim debhello-1.5/debian/rules ... hack, hack, hack, ... $ cat debhello-1.5/debian/rules #!/usr/bin/make -f export DH_VERBOSE = 1 export DEB_BUILD_MAINT_OPTIONS = hardening=+all     export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ override_dh_auto_configure: dh_auto_configure -- \ --with-math \ --author="Osamu Aoki"     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。     其余的打包步骤与 Section 4.8, “第四步：使用 debuild 构建软件包” 中的基本一致。 8.9. Autotools（单个二进制文件） 这里给出了从简单的 C 语言源代码创建简单的 Debian 软件包的例子，并     假设上游使用了 Autotools = Autoconf （Makefile.am 和 configure.ac ）作为构建系统。参见 Section 5.18.1, “Autotools”。 此种源码通常也带有上游自动生成的 Makefile.in 和 configure 文件。     在 autotools-dev 软件包的帮助下，我们可以按 Section 8.8, “Makefile.in + configure（单个二进制软件包）” 中所介绍的，使用这 些文件进行打包。 更好的做法是，如果上游提供的 Makefile.am 和 configure.ac 兼容最新 版本，我们可以使用最新的 Autoconf 和 Automake 软件包重新生成这些     （Makefile 和 configure）文件。这么做有利于移植到新的 CPU 架构上 等优势。此项工作可以使用带有 “--with autoreconf” 选项的 dh 命令来 自动化。     让我们假设上游的源码包为 debhello-1.6.tar.gz。     此类型的源码旨在作为非系统文件安装，例如： $ tar -xzmf debhello-1.6.tar.gz $ cd debhello-1.6     $ autoreconf -ivf # optional $ ./configure --with-math $ make $ make install     让我们取得源码并制作 Debian 软件包。 下载 debhello-1.6.tar.gz.  $ wget http://www.example.org/download/debhello-1.6.tar.gz ... $ tar -xzmf debhello-1.6.tar.gz $ tree . ├── debhello-1.6 │   ├── LICENSE │   ├── Makefile.am │   ├── configure.ac     │   ├── data │   │   ├── hello.desktop │   │   └── hello.png │   ├── man │   │   ├── Makefile.am │   │   └── hello.1 │   └── src │   ├── Makefile.am │   └── hello.c └── debhello-1.6.tar.gz 4 directories, 10 files     此处的源码如下所示。 src/hello.c（v=1.6）：.  $ cat debhello-1.6/src/hello.c #include "config.h" #ifdef WITH_MATH # include #endif #include int     main() { printf("Hello, I am " PACKAGE_AUTHOR "!\n"); #ifdef WITH_MATH printf("4.0 * atan(1.0) = %10f8\n", 4.0*atan(1.0)); #else printf("I can't do MATH!\n"); #endif return 0; } Makefile.am（v=1.6）：.  $ cat debhello-1.6/Makefile.am SUBDIRS = src man     $ cat debhello-1.6/man/Makefile.am dist_man_MANS = hello.1 $ cat debhello-1.6/src/Makefile.am bin_PROGRAMS = hello hello_SOURCES = hello.c configure.ac（v=1.6）：.  $ cat debhello-1.6/configure.ac # -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ([2.69]) AC_INIT([debhello],[2.1],[foo@example.org]) AC_CONFIG_SRCDIR([src/hello.c]) AC_CONFIG_HEADERS([config.h]) echo "Standard customization chores" AC_CONFIG_AUX_DIR([build-aux]) AM_INIT_AUTOMAKE([foreign]) # Add #define PACKAGE_AUTHOR ... in config.h with a comment AC_DEFINE(PACKAGE_AUTHOR, ["Osamu Aoki"], [Define PACKAGE_AUTHOR]) echo "Add --with-math option functionality to ./configure" AC_ARG_WITH([math], [AS_HELP_STRING([--with-math], [compile with math library @<:@default=yes@:>@])], [], [with_math="yes"] )     echo "==== withval := \"$withval\"" echo "==== with_math := \"$with_math\"" # m4sh if-else construct AS_IF([test "x$with_math" != "xno"],[ echo "==== Check include: math.h" AC_CHECK_HEADER(math.h,[],[ AC_MSG_ERROR([Couldn't find math.h.] ) ]) echo "==== Check library: libm" AC_SEARCH_LIBS(atan, [m]) #AC_CHECK_LIB(m, atan) echo "==== Build with LIBS := \"$LIBS\"" AC_DEFINE(WITH_MATH, [1], [Build with the math library]) ],[ echo "==== Skip building with math.h." AH_TEMPLATE(WITH_MATH, [Build without the math library]) ]) # Checks for programs. AC_PROG_CC AC_CONFIG_FILES([Makefile man/Makefile src/Makefile]) AC_OUTPUT Tip     如果没有像上述例子中，在 AM_INIT_AUTOMAKE() 中指定严格级别（ strictness level）为 “foreign”，那么 automake 会默认严格级别为 “ gnu”，并需要在顶级目录中有若干文件。参见 automake 文档的 “3.2 Strictness”。     让我们使用 debmake 命令打包。 $ cd debhello-1.6 $ debmake -e osamu@debian.org -f 'Osamu Aoki' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="1.6", rev="1" I: *** start packaging in "debhello-1.6". *** I: provide debhello_1.6.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-1.6.tar.gz debhello_1.6.orig.tar.gz I: pwd = "/path/to/debhello-1.6" I: parse binary package settings: I: binary package=debhello Type=bin / Arch=any M-A=foreign I: analyze the source tree I: build_type = Autotools with autoreconf I: scan source for copyright+license text and file extensions I: 38 %, ext = am ...     结果与 Section 8.8, “Makefile.in + configure（单个二进制软件包）” 中的类似，但是并不完全一致。     让我们来检查一下自动产生的模板文件。 debian/rules（模板文件，v=1.6）:  $ cat debhello-1.6/debian/rules #!/usr/bin/make -f # You must remove unused comment lines for the released package. #export DH_VERBOSE = 1 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all     #export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ --with autoreconf #override_dh_install: # dh_install --list-missing -X.la -X.pyc -X.pyo     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=1.6）：.  $ vim debhello-1.6/debian/rules ... hack, hack, hack, ... $ cat debhello-1.6/debian/rules #!/usr/bin/make -f export DH_VERBOSE = 1 export DEB_BUILD_MAINT_OPTIONS = hardening=+all     export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ --with autoreconf override_dh_auto_configure: dh_auto_configure -- \ --with-math     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。     其余的打包步骤与 Section 4.8, “第四步：使用 debuild 构建软件包” 中的基本一致。 8.10. CMake（单个二进制软件包） 此处是一个从简单的 C 语言源码程序生成简单的 Debian 软件包的示例，     我们假设上游使用 CMake（CMakeLists.txt 和若干形似 config.h.in 的 文件）作为构建系统。参见 Section 5.18.2, “CMake”。 cmake 命令根据 CMakeLists.txt 文件和它的 -D 选项来生成 Makefile     文件。此外，它还会根据 configure_file(…) 中指定的条目来替换带有 @…@ 的字符串、更改 #cmakedefine …。     让我们假设上游的源码包为 debhello-1.7.tar.gz。     此类型的源码旨在作为非系统文件安装，例如： $ tar -xzmf debhello-1.7.tar.gz $ cd debhello-1.7 $ mkdir obj-x86_64-linux-gnu # for out-of-tree build     $ cd obj-x86_64-linux-gnu $ cmake .. $ make $ make install     让我们取得源码并制作 Debian 软件包。 下载 debhello-1.7.tar.gz.  $ wget http://www.example.org/download/debhello-1.7.tar.gz ... $ tar -xzmf debhello-1.7.tar.gz $ tree . ├── debhello-1.7 │   ├── CMakeLists.txt │   ├── LICENSE │   ├── data     │   │   ├── hello.desktop │   │   └── hello.png │   ├── man │   │   ├── CMakeLists.txt │   │   └── hello.1 │   └── src │   ├── CMakeLists.txt │   ├── config.h.in │   └── hello.c └── debhello-1.7.tar.gz 4 directories, 10 files     此处的源码如下所示。 src/hello.c（v=1.7）：.  $ cat debhello-1.7/src/hello.c #include "config.h" #ifdef WITH_MATH # include #endif #include int     main() { printf("Hello, I am " PACKAGE_AUTHOR "!\n"); #ifdef WITH_MATH printf("4.0 * atan(1.0) = %10f8\n", 4.0*atan(1.0)); #else printf("I can't do MATH!\n"); #endif return 0; } src/config.h.in（v=1.7）：.  $ cat debhello-1.7/src/config.h.in     /* name of the package author */ #define PACKAGE_AUTHOR "@PACKAGE_AUTHOR@" /* math library support */ #cmakedefine WITH_MATH CMakeLists.txt（v=1.7）：.  $ cat debhello-1.7/CMakeLists.txt cmake_minimum_required(VERSION 2.8) project(debhello) set(PACKAGE_AUTHOR "Osamu Aoki") add_subdirectory(src) add_subdirectory(man) $ cat debhello-1.7/man/CMakeLists.txt install( FILES ${CMAKE_CURRENT_SOURCE_DIR}/hello.1 DESTINATION share/man/man1 ) $ cat debhello-1.7/src/CMakeLists.txt     # Always define HAVE_CONFIG_H add_definitions(-DHAVE_CONFIG_H) # Interactively define WITH_MATH option(WITH_MATH "Build with math support" OFF) #variable_watch(WITH_MATH) # Generate config.h from config.h.in configure_file( "${CMAKE_CURRENT_SOURCE_DIR}/config.h.in" "${CMAKE_CURRENT_BINARY_DIR}/config.h" ) include_directories("${CMAKE_CURRENT_BINARY_DIR}") add_executable(hello hello.c) install(TARGETS hello RUNTIME DESTINATION bin )     让我们使用 debmake 命令打包。 $ cd debhello-1.7 $ debmake -e osamu@debian.org -f 'Osamu Aoki' I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="1.7", rev="1" I: *** start packaging in "debhello-1.7". *** I: provide debhello_1.7.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-1.7.tar.gz debhello_1.7.orig.tar.gz I: pwd = "/path/to/debhello-1.7" I: parse binary package settings: I: binary package=debhello Type=bin / Arch=any M-A=foreign I: analyze the source tree I: build_type = Cmake I: scan source for copyright+license text and file extensions I: 38 %, ext = text ...     结果与 Section 8.8, “Makefile.in + configure（单个二进制软件包）” 中的类似，但是并不完全一致。     让我们来检查一下自动产生的模板文件。 debian/rules（模板文件，v=1.7）：.  $ cat debhello-1.7/debian/rules #!/usr/bin/make -f # You must remove unused comment lines for the released package. #export DH_VERBOSE = 1 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all     #export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ #override_dh_auto_configure: # dh_auto_configure -- \ # -DCMAKE_LIBRARY_ARCHITECTURE="$(DEB_TARGET_MULTIARCH)" debian/control（模板文件，v=1.7）：.  $ cat debhello-1.7/debian/control Source: debhello Section: unknown Priority: optional Maintainer: Osamu Aoki Build-Depends: cmake, debhelper-compat (= 13) Standards-Version: 4.5.1     Homepage: Rules-Requires-Root: no Package: debhello Architecture: any Multi-Arch: foreign Depends: ${misc:Depends}, ${shlibs:Depends} Description: auto-generated package by debmake This Debian binary package was auto-generated by the debmake(1) command provided by the debmake package.     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=1.7）：.  $ vim debhello-1.7/debian/rules ... hack, hack, hack, ... $ cat debhello-1.7/debian/rules #!/usr/bin/make -f export DH_VERBOSE = 1     export DEB_BUILD_MAINT_OPTIONS = hardening=+all export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ override_dh_auto_configure: dh_auto_configure -- -DWITH-MATH=1 debian/control（维护者版本，v=1.7）：.  $ vim debhello-1.7/debian/control ... hack, hack, hack, ... $ cat debhello-1.7/debian/control Source: debhello Section: devel Priority: optional Maintainer: Osamu Aoki Build-Depends: cmake, debhelper-compat (= 13)     Standards-Version: 4.5.1 Homepage: https://salsa.debian.org/debian/debmake-doc Rules-Requires-Root: no Package: debhello Architecture: any Multi-Arch: foreign Depends: ${misc:Depends}, ${shlibs:Depends} Description: Simple packaging example for debmake This Debian binary package is an example package. (This is an example only)     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。     其余的打包工作与 Section 8.8, “Makefile.in + configure（单个二进 制软件包）” 中的近乎一致。 8.11. Autotools（多个二进制软件包） 此处是从一个简单的 C 语言源码程序创建一个包含可执行软件包、共享库 包、开发文件包和调试符号包的一系列 Debian 二进制包的示例，我们假     设上游使用 Autotools = Autoconf 和 Automake （使用 Makefile.am 和 configure.ac 作为输入文件）作为构建系统。参见 Section 5.18.1, “Autotools”。     让我们用与 Section 8.9, “Autotools（单个二进制文件）” 中的相同的 方式打包。     让我们假设上游源码包为 debhello-2.0.tar.gz。     此类型的源码旨在作为非系统文件安装，例如： $ tar -xzmf debhello-2.0.tar.gz $ cd debhello-2.0     $ autoreconf -ivf # optional $ ./configure --with-math $ make $ make install     让我们取得源码并制作 Debian 软件包。 下载 debhello-2.0.tar.gz.  $ wget http://www.example.org/download/debhello-2.0.tar.gz ... $ tar -xzmf debhello-2.0.tar.gz $ tree . ├── debhello-2.0 │   ├── LICENSE │   ├── Makefile.am │   ├── configure.ac │   ├── data │   │   ├── hello.desktop     │   │   └── hello.png │   ├── lib │   │   ├── Makefile.am │   │   ├── sharedlib.c │   │   └── sharedlib.h │   ├── man │   │   ├── Makefile.am │   │   └── hello.1 │   └── src │   ├── Makefile.am │   └── hello.c └── debhello-2.0.tar.gz 5 directories, 13 files     此处的源码如下所示。 src/hello.c（v=2.0）：.  $ cat debhello-2.0/src/hello.c #include "config.h" #include #include     int main() { printf("Hello, I am " PACKAGE_AUTHOR "!\n"); sharedlib(); return 0; } lib/sharedlib.h 与 lib/sharedlib.c（v=1.6）：.  $ cat debhello-2.0/lib/sharedlib.h int sharedlib(); $ cat debhello-2.0/lib/sharedlib.c     #include int sharedlib() { printf("This is a shared library!\n"); return 0; } Makefile.am（v=2.0）：.  $ cat debhello-2.0/Makefile.am # recursively process `Makefile.am` in SUBDIRS SUBDIRS = lib src man $ cat debhello-2.0/man/Makefile.am # manpages (distributed in the source package) dist_man_MANS = hello.1 $ cat debhello-2.0/lib/Makefile.am # libtool librares to be produced lib_LTLIBRARIES = libsharedlib.la # source files used for lib_LTLIBRARIES libsharedlib_la_SOURCES = sharedlib.c # C pre-processor flags used for lib_LTLIBRARIES #libsharedlib_la_CPPFLAGS =     # Headers files to be installed in /include include_HEADERS = sharedlib.h # Versioning Libtool Libraries with version triplets libsharedlib_la_LDFLAGS = -version-info 1:0:0 $ cat debhello-2.0/src/Makefile.am # program executables to be produced bin_PROGRAMS = hello # source files used for bin_PROGRAMS hello_SOURCES = hello.c # C pre-processor flags used for bin_PROGRAMS AM_CPPFLAGS = -I$(srcdir) -I$(top_srcdir)/lib # Extra options for the linker for hello # hello_LDFLAGS = # Libraries the `hello` binary to be linked hello_LDADD = $(top_srcdir)/lib/libsharedlib.la configure.ac（v=2.0）：.  $ cat debhello-2.0/configure.ac # -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ([2.69]) AC_INIT([debhello],[2.2],[foo@example.org]) AC_CONFIG_SRCDIR([src/hello.c]) AC_CONFIG_HEADERS([config.h]) echo "Standard customization chores" AC_CONFIG_AUX_DIR([build-aux]) AM_INIT_AUTOMAKE([foreign]) # Set default to --enable-shared --disable-static LT_INIT([shared disable-static])     # find the libltdl sources in the libltdl sub-directory LT_CONFIG_LTDL_DIR([libltdl]) # choose one LTDL_INIT([recursive]) #LTDL_INIT([subproject]) #LTDL_INIT([nonrecursive]) # Add #define PACKAGE_AUTHOR ... in config.h with a comment AC_DEFINE(PACKAGE_AUTHOR, ["Osamu Aoki"], [Define PACKAGE_AUTHOR]) # Checks for programs. AC_PROG_CC # only for the recursive case AC_CONFIG_FILES([Makefile lib/Makefile man/Makefile src/Makefile]) AC_OUTPUT     让我们用 debmake 命令将这些打包到多个包中： * debhello: type = bin     * libsharedlib1: type = lib * libsharedlib-dev: type = dev     此处的 -b',libsharedlib1,libsharedlib-dev' 选项是用以指明生成的二 进制包。 $ cd debhello-2.0 $ debmake -b',libsharedlib1,libsharedlib-dev' -e osamu@debian.org -f 'Osamu ... I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="2.0", rev="1" I: *** start packaging in "debhello-2.0". *** I: provide debhello_2.0.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-2.0.tar.gz debhello_2.0.orig.tar.gz I: pwd = "/path/to/debhello-2.0" I: parse binary package settings: ,libsharedlib1,libsharedlib-dev I: binary package=debhello Type=bin / Arch=any M-A=foreign I: binary package=libsharedlib1 Type=lib / Arch=any M-A=same I: binary package=libsharedlib-dev Type=dev / Arch=any M-A=same I: analyze the source tree I: build_type = Autotools with autoreconf ...     结果与 Section 8.8, “Makefile.in + configure（单个二进制软件包）” 中的相似，但是这个具有更多的模板文件。     让我们来检查一下自动产生的模板文件。 debian/rules（模板文件，v=2.0）：.  $ cat debhello-2.0/debian/rules #!/usr/bin/make -f # You must remove unused comment lines for the released package. #export DH_VERBOSE = 1 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all     #export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ --with autoreconf #override_dh_install: # dh_install --list-missing -X.la -X.pyc -X.pyo     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=2.0）：.  $ vim debhello-2.0/debian/rules ... hack, hack, hack, ... $ cat debhello-2.0/debian/rules #!/usr/bin/make -f export DH_VERBOSE = 1     export DEB_BUILD_MAINT_OPTIONS = hardening=+all export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ --with autoreconf override_dh_missing: dh_missing -X.la debian/control（维护者版本，v=2.0）：.  $ vim debhello-2.0/debian/control ... hack, hack, hack, ... $ cat debhello-2.0/debian/control Source: debhello Section: devel Priority: optional Maintainer: Osamu Aoki Build-Depends: debhelper-compat (= 13), dh-autoreconf Standards-Version: 4.5.1 Homepage: https://salsa.debian.org/debian/debmake-doc Rules-Requires-Root: no Package: debhello Architecture: any Multi-Arch: foreign Depends: libsharedlib1 (= ${binary:Version}), ${misc:Depends}, ${shlibs:Depends}     Description: Simple packaging example for debmake This package contains the compiled binary executable. . This Debian binary package is an example package. (This is an example only) Package: libsharedlib1 Section: libs Architecture: any Multi-Arch: same Pre-Depends: ${misc:Pre-Depends} Depends: ${misc:Depends}, ${shlibs:Depends} Description: Simple packaging example for debmake This package contains the shared library. Package: libsharedlib-dev Section: libdevel Architecture: any Multi-Arch: same Depends: libsharedlib1 (= ${binary:Version}), ${misc:Depends} Description: Simple packaging example for debmake This package contains the development files. debian/*.install（维护者版本，v=2.0）：.  $ vim debhello-2.0/debian/debhello.install ... hack, hack, hack, ... $ cat debhello-2.0/debian/debhello.install usr/bin/* usr/share/* $ vim debhello-2.0/debian/libsharedlib1.install     ... hack, hack, hack, ... $ cat debhello-2.0/debian/libsharedlib1.install usr/lib/*/*.so.* $ vim debhello-2.0/debian/libsharedlib-dev.install ... hack, hack, hack, ... $ cat debhello-2.0/debian/libsharedlib-dev.install ###usr/lib/*/pkgconfig/*.pc usr/include usr/lib/*/*.so     因为上游源码已经具有正确的自动生成的 Makefile 文件，所以没有必要 再去创建 debian/install 和 debian/manpages 文件。     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。 debian/ 目录下的模板文件。（v=2.0）：.  $ tree debhello-2.0/debian debhello-2.0/debian ├── README.Debian ├── changelog ├── control ├── copyright ├── debhello.install ├── libsharedlib-dev.install ├── libsharedlib1.install ├── libsharedlib1.symbols ├── patches     │   └── series ├── rules ├── source │   ├── control │   ├── format │   ├── local-options │   ├── options │   └── patch-header ├── tests │   └── control ├── upstream │   └── metadata └── watch 4 directories, 18 files     其余的打包工作与 Section 8.8, “Makefile.in + configure（单个二进 制软件包）” 中的近乎一致。     此处是生成的二进制包的依赖项列表。 生成的二进制包的依赖项列表（v=2.0）：.  $ dpkg -f debhello-dbgsym_2.0-1_amd64.deb pre-depends depends recommends con... Depends: debhello (= 2.0-1) $ dpkg -f debhello_2.0-1_amd64.deb pre-depends depends recommends conflicts ...     Depends: libsharedlib1 (= 2.0-1), libc6 (>= 2.2.5) $ dpkg -f libsharedlib-dev_2.0-1_amd64.deb pre-depends depends recommends co... Depends: libsharedlib1 (= 2.0-1) $ dpkg -f libsharedlib1-dbgsym_2.0-1_amd64.deb pre-depends depends recommend... Depends: libsharedlib1 (= 2.0-1) $ dpkg -f libsharedlib1_2.0-1_amd64.deb pre-depends depends recommends confl... Depends: libc6 (>= 2.2.5) 8.12. CMake（多个二进制软件包） 此处是从一个简单的 C 语言源码程序创建一系列包含可执行软件包、共享     库包、开发文件包和调试符号包的 Debian 二进制包的示例，我们假设上 游使用 CMake（CMakeLists.txt 和其他形如 config.h.in 的文件）作为 构建系统。参见 Section 5.18.2, “CMake”。     让我们假设上游源码包为 debhello-2.1.tar.gz。     此类型的源码旨在作为非系统文件安装，例如： $ tar -xzmf debhello-2.1.tar.gz $ cd debhello-2.1 $ mkdir obj-x86_64-linux-gnu     $ cd obj-x86_64-linux-gnu $ cmake .. $ make $ make install     让我们取得源码并制作 Debian 软件包。 下载 debhello-2.1.tar.gz.  $ wget http://www.example.org/download/debhello-2.1.tar.gz ... $ tar -xzmf debhello-2.1.tar.gz $ tree . ├── debhello-2.1 │   ├── CMakeLists.txt │   ├── LICENSE │   ├── data │   │   ├── hello.desktop │   │   └── hello.png     │   ├── lib │   │   ├── CMakeLists.txt │   │   ├── sharedlib.c │   │   └── sharedlib.h │   ├── man │   │   ├── CMakeLists.txt │   │   └── hello.1 │   └── src │   ├── CMakeLists.txt │   ├── config.h.in │   └── hello.c └── debhello-2.1.tar.gz 5 directories, 13 files     此处的源码如下所示。 src/hello.c（v=2.1）：.  $ cat debhello-2.1/src/hello.c #include "config.h" #include #include     int main() { printf("Hello, I am " PACKAGE_AUTHOR "!\n"); sharedlib(); return 0; } src/config.h.in（v=2.1）：.      $ cat debhello-2.1/src/config.h.in /* name of the package author */ #define PACKAGE_AUTHOR "@PACKAGE_AUTHOR@" lib/sharedlib.c 与 lib/sharedlib.h（v=2.1）：.  $ cat debhello-2.1/lib/sharedlib.h int sharedlib(); $ cat debhello-2.1/lib/sharedlib.c     #include int sharedlib() { printf("This is a shared library!\n"); return 0; } CMakeLists.txt（v=2.1）：.  $ cat debhello-2.1/CMakeLists.txt cmake_minimum_required(VERSION 2.8) project(debhello) set(PACKAGE_AUTHOR "Osamu Aoki") add_subdirectory(lib) add_subdirectory(src) add_subdirectory(man) $ cat debhello-2.1/man/CMakeLists.txt install( FILES ${CMAKE_CURRENT_SOURCE_DIR}/hello.1 DESTINATION share/man/man1 )     $ cat debhello-2.1/src/CMakeLists.txt # Always define HAVE_CONFIG_H add_definitions(-DHAVE_CONFIG_H) # Generate config.h from config.h.in configure_file( "${CMAKE_CURRENT_SOURCE_DIR}/config.h.in" "${CMAKE_CURRENT_BINARY_DIR}/config.h" ) include_directories("${CMAKE_CURRENT_BINARY_DIR}") include_directories("${CMAKE_SOURCE_DIR}/lib") add_executable(hello hello.c) target_link_libraries(hello sharedlib) install(TARGETS hello RUNTIME DESTINATION bin )     让我们使用 debmake 命令打包。 $ cd debhello-2.1 $ debmake -b',libsharedlib1,libsharedlib-dev' -e osamu@debian.org -f 'Osamu ... I: set parameters ... I: sanity check of parameters I: pkg="debhello", ver="2.1", rev="1" I: *** start packaging in "debhello-2.1". *** I: provide debhello_2.1.orig.tar.gz for non-native Debian package     I: pwd = "/path/to" I: $ ln -sf debhello-2.1.tar.gz debhello_2.1.orig.tar.gz I: pwd = "/path/to/debhello-2.1" I: parse binary package settings: ,libsharedlib1,libsharedlib-dev I: binary package=debhello Type=bin / Arch=any M-A=foreign I: binary package=libsharedlib1 Type=lib / Arch=any M-A=same I: binary package=libsharedlib-dev Type=dev / Arch=any M-A=same I: analyze the source tree I: build_type = Cmake ...     结果与 Section 8.8, “Makefile.in + configure（单个二进制软件包）” 中的类似，但是并不完全一致。     让我们来检查一下自动产生的模板文件。 debian/rules（模板文件，v=2.1）：.  $ cat debhello-2.1/debian/rules #!/usr/bin/make -f # You must remove unused comment lines for the released package. #export DH_VERBOSE = 1 #export DEB_BUILD_MAINT_OPTIONS = hardening=+all     #export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic #export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed %: dh $@ #override_dh_auto_configure: # dh_auto_configure -- \ # -DCMAKE_LIBRARY_ARCHITECTURE="$(DEB_TARGET_MULTIARCH)"     作为维护者，我们要把这个 Debian 软件包做得更好。 debian/rules（维护者版本，v=2.1）：.  $ vim debhello-2.1/debian/rules ... hack, hack, hack, ... $ cat debhello-2.1/debian/rules #!/usr/bin/make -f export DH_VERBOSE = 1 export DEB_BUILD_MAINT_OPTIONS = hardening=+all     export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH) %: dh $@ override_dh_auto_configure: dh_auto_configure -- \ -DCMAKE_LIBRARY_ARCHITECTURE="$(DEB_HOST_MULTIARCH)" debian/control（维护者版本，v=2.1）：.  $ vim debhello-2.1/debian/control ... hack, hack, hack, ... $ cat debhello-2.1/debian/control Source: debhello Section: devel Priority: optional Maintainer: Osamu Aoki Build-Depends: cmake, debhelper-compat (= 13) Standards-Version: 4.5.1 Homepage: https://salsa.debian.org/debian/debmake-doc Rules-Requires-Root: no Package: debhello Architecture: any Multi-Arch: foreign Depends: libsharedlib1 (= ${binary:Version}), ${misc:Depends}, ${shlibs:Depends}     Description: Simple packaging example for debmake This package contains the compiled binary executable. . This Debian binary package is an example package. (This is an example only) Package: libsharedlib1 Section: libs Architecture: any Multi-Arch: same Pre-Depends: ${misc:Pre-Depends} Depends: ${misc:Depends}, ${shlibs:Depends} Description: Simple packaging example for debmake This package contains the shared library. Package: libsharedlib-dev Section: libdevel Architecture: any Multi-Arch: same Depends: libsharedlib1 (= ${binary:Version}), ${misc:Depends} Description: Simple packaging example for debmake This package contains the development files. debian/*.install（维护者版本，v=2.1）：.  $ vim debhello-2.1/debian/debhello.install ... hack, hack, hack, ... $ cat debhello-2.1/debian/debhello.install usr/bin/* usr/share/* $ vim debhello-2.1/debian/libsharedlib1.install     ... hack, hack, hack, ... $ cat debhello-2.1/debian/libsharedlib1.install usr/lib/*/*.so.* $ vim debhello-2.1/debian/libsharedlib-dev.install ... hack, hack, hack, ... $ cat debhello-2.1/debian/libsharedlib-dev.install ###usr/lib/*/pkgconfig/*.pc usr/include usr/lib/*/*.so     需要对上游的 CMakeList.txt 进行修补，以便应对多架构的路径。 debian/patches/*（维护者版本，v=2.1）：.      ... hack, hack, hack, ... $ cat debhello-2.1/debian/libsharedlib1.symbols libsharedlib.so.1 libsharedlib1 #MINVER# sharedlib@Base 2.1     因为上游源码已经具有正确的自动生成的 Makefile 文件，所以没有必要 再去创建 debian/install 和 debian/manpages 文件。     在 debian/ 目录下还有一些其它的模板文件。它们也需要进行更新。 debian/ 目录下的模板文件。（v=2.1）：.  $ tree debhello-2.1/debian debhello-2.1/debian ├── README.Debian ├── changelog ├── control ├── copyright ├── debhello.install ├── libsharedlib-dev.install ├── libsharedlib1.install ├── libsharedlib1.symbols ├── patches │   ├── 000-cmake-multiarch.patch     │   └── series ├── rules ├── source │   ├── control │   ├── format │   ├── local-options │   ├── options │   └── patch-header ├── tests │   └── control ├── upstream │   └── metadata └── watch 4 directories, 19 files     其余的打包工作与 Section 8.8, “Makefile.in + configure（单个二进 制软件包）” 中的近乎一致。     此处是生成的二进制包的依赖项列表。 生成的二进制包的依赖项列表（v=2.1）：.  $ dpkg -f debhello-dbgsym_2.1-1_amd64.deb pre-depends depends recommends con... Depends: debhello (= 2.1-1) $ dpkg -f debhello_2.1-1_amd64.deb pre-depends depends recommends conflicts ...     Depends: libsharedlib1 (= 2.1-1), libc6 (>= 2.2.5) $ dpkg -f libsharedlib-dev_2.1-1_amd64.deb pre-depends depends recommends co... Depends: libsharedlib1 (= 2.1-1) $ dpkg -f libsharedlib1-dbgsym_2.1-1_amd64.deb pre-depends depends recommend... Depends: libsharedlib1 (= 2.1-1) $ dpkg -f libsharedlib1_2.1-1_amd64.deb pre-depends depends recommends confl... Depends: libc6 (>= 2.2.5) 8.13. 国际化 此处是更新 Section 8.11, “Autotools（多个二进制软件包）” 中提供的     简单上游 C 语言源代码 debhello-2.0.tar.gz 以便进行国际化（i18n） 并创建更新后的上游 C 语言源代码 debhello-2.0.tar.gz 的示例。     在实际情况中，此软件包应该已被国际化过。所以此示例用作帮助您了解 国际化的具体实现方法。 Tip     负责维护国际化的维护者的日常活动就是将通过缺陷追踪系统（BTS）反馈 给您的 po 翻译文件添加至 po/ 目录，然后更新 po/LINGUAS 文件的语言 列表。     让我们取得源码并制作 Debian 软件包。 下载 debhello-2.0.tar.gz（国际化版）.  $ wget http://www.example.org/download/debhello-2.0.tar.gz ... $ tar -xzmf debhello-2.0.tar.gz $ tree . ├── debhello-2.0 │   ├── LICENSE │   ├── Makefile.am │   ├── configure.ac │   ├── data │   │   ├── hello.desktop     │   │   └── hello.png │   ├── lib │   │   ├── Makefile.am │   │   ├── sharedlib.c │   │   └── sharedlib.h │   ├── man │   │   ├── Makefile.am │   │   └── hello.1 │   └── src │   ├── Makefile.am │   └── hello.c └── debhello-2.0.tar.gz 5 directories, 13 files     使用 gettextize 命令将此源代码树国际化，并删除由 Autotools 自动生 成的文件。 运行 gettextize（国际化版）：.  $ cd debhello-2.0 $ gettextize Creating po/ subdirectory Creating build-aux/ subdirectory Copying file ABOUT-NLS Copying file build-aux/config.rpath Not copying intl/ directory. Copying file po/Makefile.in.in Copying file po/Makevars.template Copying file po/Rules-quot Copying file po/boldquot.sed Copying file po/en@boldquot.header Copying file po/en@quot.header Copying file po/insert-header.sin Copying file po/quot.sed Copying file po/remove-potcdate.sin Creating initial po/POTFILES.in Creating po/ChangeLog Creating directory m4 Copying file m4/gettext.m4 Copying file m4/iconv.m4 Copying file m4/lib-ld.m4 Copying file m4/lib-link.m4 Copying file m4/lib-prefix.m4 Copying file m4/nls.m4 Copying file m4/po.m4 Copying file m4/progtest.m4     Creating m4/ChangeLog Updating Makefile.am (backup is in Makefile.am~) Updating configure.ac (backup is in configure.ac~) Creating ChangeLog Please use AM_GNU_GETTEXT([external]) in order to cause autoconfiguration to look for an external libintl. Please create po/Makevars from the template in po/Makevars.template. You can then remove po/Makevars.template. Please fill po/POTFILES.in as described in the documentation. Please run 'aclocal' to regenerate the aclocal.m4 file. You need aclocal from GNU automake 1.9 (or newer) to do this. Then run 'autoconf' to regenerate the configure file. You will also need config.guess and config.sub, which you can get from the CV... of the 'config' project at http://savannah.gnu.org/. The commands to fetch th... are $ wget 'http://savannah.gnu.org/cgi-bin/viewcvs/*checkout*/config/config/conf... $ wget 'http://savannah.gnu.org/cgi-bin/viewcvs/*checkout*/config/config/conf... You might also want to copy the convenience header file gettext.h from the /usr/share/gettext directory into your package. It is a wrapper around that implements the configure --disable-nl... option. Press Return to acknowledge the previous 6 paragraphs. $ rm -rf m4 build-aux *~     让我们确认一下 po/ 目录下生成的文件。 po 目录下的文件（国际化版）：.  $ ls -l po total 60 -rw-rw-r-- 1 osamu osamu 494 Jul 2 16:28 ChangeLog -rw-rw-r-- 1 osamu osamu 17577 Jul 2 16:28 Makefile.in.in -rw-rw-r-- 1 osamu osamu 3376 Jul 2 16:28 Makevars.template     -rw-rw-r-- 1 osamu osamu 59 Jul 2 16:28 POTFILES.in -rw-rw-r-- 1 osamu osamu 2203 Jul 2 16:28 Rules-quot -rw-rw-r-- 1 osamu osamu 217 Jul 2 16:28 boldquot.sed -rw-rw-r-- 1 osamu osamu 1337 Jul 2 16:28 en@boldquot.header -rw-rw-r-- 1 osamu osamu 1203 Jul 2 16:28 en@quot.header -rw-rw-r-- 1 osamu osamu 672 Jul 2 16:28 insert-header.sin -rw-rw-r-- 1 osamu osamu 153 Jul 2 16:28 quot.sed -rw-rw-r-- 1 osamu osamu 432 Jul 2 16:28 remove-potcdate.sin     让我们在 configure.ac 文件中添加 “AM_GNU_GETTEXT([external])” 等 条目。 configure.ac（国际化版）：.  $ vim configure.ac ... hack, hack, hack, ... $ cat configure.ac # -*- Autoconf -*- # Process this file with autoconf to produce a configure script. AC_PREREQ([2.69]) AC_INIT([debhello],[2.2],[foo@example.org]) AC_CONFIG_SRCDIR([src/hello.c]) AC_CONFIG_HEADERS([config.h]) echo "Standard customization chores" AC_CONFIG_AUX_DIR([build-aux]) AM_INIT_AUTOMAKE([foreign]) # Set default to --enable-shared --disable-static LT_INIT([shared disable-static]) # find the libltdl sources in the libltdl sub-directory LT_CONFIG_LTDL_DIR([libltdl])     # choose one LTDL_INIT([recursive]) #LTDL_INIT([subproject]) #LTDL_INIT([nonrecursive]) # Add #define PACKAGE_AUTHOR ... in config.h with a comment AC_DEFINE(PACKAGE_AUTHOR, ["Osamu Aoki"], [Define PACKAGE_AUTHOR]) # Checks for programs. AC_PROG_CC # desktop file support required AM_GNU_GETTEXT_VERSION([0.19.3]) AM_GNU_GETTEXT([external]) # only for the recursive case AC_CONFIG_FILES([Makefile po/Makefile.in lib/Makefile man/Makefile src/Makefile]) AC_OUTPUT     让我们从 po/Makevars.template 文件中创建 po/Makevars 文件。 po/Makevars（国际化版）：.  ... hack, hack, hack, ... $ diff -u po/Makevars.template po/Makevars --- po/Makevars.template 2021-07-02 16:28:02.711724581 +0900 +++ po/Makevars 2021-07-02 16:28:02.767725251 +0900 @@ -18,14 +18,14 @@ # or entity, or to disclaim their copyright. The empty string stands for # the public domain; in this case the translators are expected to disclaim # their copyright. -COPYRIGHT_HOLDER = Free Software Foundation, Inc.     +COPYRIGHT_HOLDER = Osamu Aoki # This tells whether or not to prepend "GNU " prefix to the package # name that gets inserted into the header of the $(DOMAIN).pot file. # Possible values are "yes", "no", or empty. If it is empty, try to # detect it automatically by scanning the files in $(top_srcdir) for # "GNU packagename" string. -PACKAGE_GNU = +PACKAGE_GNU = no # This is the email address or URL to which the translators shall report # bugs in the untranslated strings: $ rm po/Makevars.template     让我们通过用 _(…) 包裹字符串的方式来更新国际化版本的 C 语言源代码 。 src/hello.c （国际化版）：.  ... hack, hack, hack, ... $ cat src/hello.c #include "config.h" #include #include     #define _(string) gettext (string) int main() { printf(_("Hello, I am " PACKAGE_AUTHOR "!\n")); sharedlib(); return 0; } lib/sharedlib.c（国际化版）：.  ... hack, hack, hack, ... $ cat lib/sharedlib.c #include     #define _(string) gettext (string) int sharedlib() { printf(_("This is a shared library!\n")); return 0; }     新版本的 gettext（v = 0.19）可以直接处理桌面文件的国际化版本。 data/hello.desktop.in（国际化版）：.  $ fgrep -v '[ja]=' data/hello.desktop > data/hello.desktop.in $ rm data/hello.desktop $ cat data/hello.desktop.in [Desktop Entry]     Name=Hello Comment=Greetings Type=Application Keywords=hello Exec=hello Terminal=true Icon=hello.png Categories=Utility;     让我们列出输入文件，以便在 po/POTFILES.in 中提取可翻译的字符串。 po/POTFILES.in（国际化版）：.  ... hack, hack, hack, ...     $ cat po/POTFILES.in src/hello.c lib/sharedlib.c data/hello.desktop.in     此处是在 SUBDIRS 环境变量中添加 po 目录后更新过的根 Makefile.am 文件。 Makefile.am （国际化版）：.  $ cat Makefile.am # recursively process `Makefile.am` in SUBDIRS     SUBDIRS = po lib src man ACLOCAL_AMFLAGS = -I m4 EXTRA_DIST = build-aux/config.rpath m4/ChangeLog     让我们创建一个翻译模板文件 debhello.pot。 po/debhello.pot（国际化版）：.  $ xgettext -f po/POTFILES.in -d debhello -o po/debhello.pot -k_ $ cat po/debhello.pot # SOME DESCRIPTIVE TITLE. # Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2021-07-02 16:28+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n"     "Content-Transfer-Encoding: 8bit\n" #: src/hello.c:8 #, c-format msgid "Hello, I am " msgstr "" #: lib/sharedlib.c:6 #, c-format msgid "This is a shared library!\n" msgstr "" #: data/hello.desktop.in:3 msgid "Hello" msgstr "" #: data/hello.desktop.in:4 msgid "Greetings" msgstr "" #: data/hello.desktop.in:6 msgid "hello" msgstr ""     让我们添加法语的翻译。 po/LINGUAS 与 po/fr.po（国际化版）：.  $ echo 'fr' > po/LINGUAS $ cp po/debhello.pot po/fr.po $ vim po/fr.po ... hack, hack, hack, ... $ cat po/fr.po # SOME DESCRIPTIVE TITLE. # This file is put in the public domain. # FIRST AUTHOR , YEAR. # msgid "" msgstr "" "Project-Id-Version: debhello 2.2\n" "Report-Msgid-Bugs-To: foo@example.org\n" "POT-Creation-Date: 2015-03-01 20:22+0900\n" "PO-Revision-Date: 2015-02-21 23:18+0900\n" "Last-Translator: Osamu Aoki \n" "Language-Team: French \n" "Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n"     #: src/hello.c:34 #, c-format msgid "Hello, my name is %s!\n" msgstr "Bonjour, je m'appelle %s!\n" #: lib/sharedlib.c:29 #, c-format msgid "This is a shared library!\n" msgstr "Ceci est une bibliothèque partagée!\n" #: data/hello.desktop.in:3 msgid "Hello" msgstr "" #: data/hello.desktop.in:4 msgid "Greetings" msgstr "Salutations" #: data/hello.desktop.in:6 msgid "hello" msgstr "" #: data/hello.desktop.in:9 msgid "hello.png" msgstr ""     打包工作与 Section 8.11, “Autotools（多个二进制软件包）” 中的近乎 一致。     You can find more i18n examples by following Section 8.14, “细节” . 8.14. 细节     所示示例的实际细节及其变体可通过以下方式获得。 如何取得细节.      $ apt-get source debmake-doc $ cd debmake-doc* $ cd examples $ view examples/README.md     Follow the exact instruction in examples/README.md. $ cd examples     $ sudo apt-get install devscripts build-essentials ... $ make     Now, each directory named as examples/debhello-?.?_build-? contains the Debian packaging example. * 模拟控制台命令行活动日志：.log 文件 * 模拟控制台命令行活动日志（缩略版）：.slog 文件     * 执行 debmake 命令后的源码树快照：debmake 目录 * 打包后的源码树快照：packge 目录 * 执行 debuild 命令后的源码树快照：test 目录     Notable examples are: * the Python3 script with bare distutils (v=1.8), * the POSIX shell script with Makefile with i18n (v=3.0),     * the Python3 script with setuptools with i18n (v=3.1), * the C source with Makefile.in + configure with i18n (v=3.2), * the C source with Autotools with i18n with i18n (v=3.3), and * the C source with CMake with i18n (v=3.4). --------------------------------------------------------------------- ^[23] If the source package is lacks setup.py but still based on     setuptools, you need to add a boiler plate setup.py. If the source package is based on other build systems such as flit, you need to use respective plugins. Appendix A. debmake(1) 手册页 A.1. 名称     debmake，用来制作 Debian 源码包的程序 A.2. 概述 debmake [-h] [-c | -k] [-n | -a 软件包名-版本号.orig.tar.gz | -d | -t ] [-p package] [-u version] [-r 修订号] [-z 扩展] [-b "     binarypackage, …]" [-e foo@example.org] [-f "名称姓氏"] [-i "构建 工具" | -j] [-l license_file] [-m] [-o file] [-q] [-s] [-v] [-w " addon, …"] [-x [01234]] [-y] [-L] [-P] [-T] A.3. 描述     debmake 协助从上游源代码构建一个 Debian 软件包，通常做法如下： * 下载上游源码压缩包（tarball）并命名为 package-version.tar.gz 文件。 * 对其进行解压缩并将所有文件放置于 package-version/ 目录之下。     * 在 package-version/ 目录中调用 debmake，并按需带上参数。 * 手工调整 package-version/debian/ 目录下的文件。 * dpkg-buildpackage (usually from its wrapper debuild or sbuild ) is invoked in the package-version/ directory to make Debian packages.     请确保将 -b、-f、-l 和 -w 选项的参数使用引号合适地保护起来，以避 免 shell 环境的干扰。 A.3.1. 可选参数： -h, --help 显示本帮助信息并退出。 -c, --copyright 为授权+许可证文本而扫描源码，然后退出。 o -c：简单输出风格 o -cc：正常输出风格（类似 debian/copyright 文件） o -ccc：调试输出风格 -k, --kludge 对 debian/copyright 文件和源代码进行比较并退出。 debian/copyright 必须将通用的文件匹配模式放在前部并将个别文件 的例外放在后部。 o -k：基本输出风格 o -kk：冗长输出风格 -n, --native 制作一个原生 Debian 源码包，即不涉及 .orig.tar.gz。这样将制作 一个“3.0 (native)”格式的包。 如果您正打算打包一个含 debian/* 目录的 Debian 特有的源码树成 为一个 Debian 原生软件包的话，还请三思。您可以使用“debmake -d -i debuild”或者“debmake -t -i debuild”命令来创建一个“3.0 (quilt)”格式的非原生 Debian 软件包。唯一的区别是 debian/ changelog 文件必须使用非原生软件包对应的命名规范：版本号-修订 号。非原生的软件包对下游发行版更友好。 -a package-version.tar.gz, --archive package-version.tar.gz 直接使用上游源码压缩包。（-p, -u, -z：被覆盖） 上游源码压缩包可以命名为 package_version.orig.tar.gz 或者 tar.gz。在某些情况下，也可使用 tar.bz2 或 tar.xz。 如果所指定的源码压缩包文件名中包含大写字母，Debian 打包时生成 的名称会将其转化为小写字母。 如果所指定的参数是一个指向上游源码压缩包的 URL（http://、 https:// 或 ftp://），程序将会使用 wget 或 curl 下载这个压缩 包。 -d, --dist 先运行“make dist”命令或其等效命令以生成上游源码压缩包并在打包 过程中使用。 “debmake -d”命令设计用于在软件包名/ 目录下使用了上游版本控制 系统的场景，且其构建系统支持“make dist”或其等效命令。（如 automake/autoconf、Python distutils 等等） -t, --tar 运行“tar”命令以生成上游源码压缩包并在打包过程中使用。 “debmake -t”命令设计用于在软件包名/ 目录下使用了上游版本控制 系统的场景。除非您使用了 -u 选项或者使用 debian/changelog 文 件提供了上游版本号，默认情况下程序将运用协调世界时日期和时间 按照 0~%y%m%d%H%M 的格式作为快照的上游版本号，例如 0~1403012359。所生成的压缩包将排除上游版本控制系统中的 debian / 目录。（它也会排除常见的版本控制系统目录：.git/ .hg/ .svn/ .CVS/。） -p 软件包名, --package 软件包名 设置 Debian 软件包名称。 -u 上游版本号, --upstreamversion 版本号 设置上游软件包版本。 -r 修订号, --revision 修订号 设置 Debian 软件包修订号。 -z 扩展名, --targz 扩展名 设置源码压缩包类型，扩展名=(tar.gz|tar.bz2|tar.xz)。（别名：z , b, x） -b "二进制软件包名[:type],…", --binaryspec "二进制软件包名 [:type],…" 设置二进制软件包的指定类型内容，使用一个用逗号分隔的二进制软 件包名:类型成对列表；例如，使用完整形式“ foo:bin,foo-doc:doc,libfoo1:lib,libfoo-dev:dev”或者使用短形式 ，“-doc,libfoo1,libfoo-dev”。     这里，二进制软件包是二进制软件包名称，可选的类型应当从下面的 类型值中进行选取： o bin：C/C++ 预编译 ELF 二进制代码软件包（any，foreign）（ 默认，别名：""，即，空字符串） o data：数据（字体、图像、……）软件包（all，foreign）（别名 ：da） o dev：库开发软件包（any，same）（别名：de） o doc：文档软件包（all，foreign）（别名：do） o lib：库软件包（any，same）（别名：l） o perl：Perl 脚本软件包（all，foreign）（别名：pl） o python3：Python（版本 3）脚本软件包（all，foreign）（别名 ：py3） o ruby：Ruby 脚本软件包（all，foreign）（别名：rb） o nodejs：基于 Node.js 的 JavaScript 软件包（all，foreign） （别名：js） o script：Shell 脚本软件包（all，foreign）（别名：sh） 括号内成对的值，例如（any，foreign），是软件包的架构和多架构 （Multi-Arch）特性的值，它们将设置在 debian/control 文件中。 大多数情况下，debmake 命令可以有效地从二进制软件包的名称猜测 出正确的类型。如果类型的值并不明显，程序将回退到将类型设置为 bin。例如，libfoo 设置类型为 lib，而 font-bar 会令程序设置类 型为 data，…… 如果源码树的内容和类型的设置不一致，debmake 命令会发出警告。 -e foo@example.org, --email foo@example.org 设置电子邮件地址。 默认值为环境变量 $DEBEMAIL 的值。 -f "名称姓氏", --fullname "名称姓氏" 设置全名。 默认值为环境变量 $DEBFULLNAME 的值。 -i "构建工具", --invoke "构建工具" invoke "buildtool" at the end of execution. buildtool may be “dpkg-buildpackage”, “debuild”, “sbuild”, etc. 默认情况是不执行任何程序。 设置该选项也会自动设置 --local 选项。 -j, --judge 运行 dpkg-depcheck 以检查构建依赖和文件路径。检查日志将存储在 父目录下。 o 软件包名.build-dep.log：dpkg-depcheck 的日志文件。 o 软件包名.install.log：记录 debian/tmp 目录下所安装文件的 日志。 -l "许可证文件,…", --license "许可证文件,…" 在存放许可证扫描结果的 debian/copyright 文件末尾添加格式化后 的许可证文本。 默认值是添加 COPYING 和 LICENSE 文件，您只需要在许可证文件部 分添加额外的文件名即可，并使用“,”分隔各个文件名。 -m, --monoarch 强制软件包不使用多架构特性。 -o 文件, --option 文件 从指定file读取可选参数。（这个选项不适合日常使用。） 文件 file 的内容，将在 para.py 的末尾作为 Python 代码的源代码 。例如，软件包描述信息可以使用下述文件来定义。 para['desc'] = 'program short description' para['desc_long'] = '''\ program long description which you wish to include. . Empty line is space + . You keep going on ... ''' -q, --quitearly 在创建 debian/ 目录下的文件之前即提前退出程序。 -s, --spec 使用上游配置文件（例如 Python 里的 setup.py 等）信息来初始化 软件包描述内容。 -v, --version 显示版本信息。 -w "addon,…", --with "addon,…" 在 debian/rules 文件中向 dh(1) 命令的参数中添加额外的 dh(1) 参数以指定所使用的附加组件（addon）。 这里 addon 的值中各项使用“,”进行分隔，例如“-w "python3,autoreconf"”。 对于基于 Autotools 的软件包，autoreconf 作为 addon 运行“ autoreconf -i -v -f”，是dh(1) 命令在每次构建软件包的默认行为 。 对基于 Autotools 的软件包，如果它们要安装 Python(版本 3) 程序 ，您需要指定 python3 作为 addon 到 debmake 命令参数，因为这不 是显而易见的。但对基于 setup.py 的软件包来说，并不需要指定 python3 作为 addon 到 debmake 命令参数，因为这是显而易见的， debmake 会自动为 dh(1) 命令设置这样的参数。 -x n, --extra n     以模板文件的形式创建配置文件（请注意 debian/changelog、debian /control、debian/copyright 和 debian/rules 文件是构建 Debian 二进制软件包所需的最小文件集合。） n 的数字大小决定了生成哪些配置模板文件。 o -x0：最少的配置文件（这是存在任何已有配置文件时的默认选项 ） o -x1：所有 -x0 提供的文件以及用于生成单个二进制软件包可能 需要的配置文件。（这是只生成单个二进制软件包，且不存在其 它已有配置文件时的默认选项） o -x2：所有 -x2 提供的文件以及用于生成多个二进制软件包可能 需要的配置文件。（这是生成多个二进制软件包，且不存在其它 已有配置文件时的默认选项） o -x3：所有 -x2 提供的文件以及不常使用的配置模板文件。不常 使用的配置模板文件在生成时会带上 .ex 后缀名以方便对其删除 。如需使用这些配置文件，请重命名这些文件并去除 .ex 的后缀 。 o -x4 选项：全部配置 -x3 文件加版权声明文件示例。 -y, --yes 对所有提示“强制选择是”（不提示选项“询问 [是/否]”；重复选项两 次则为“强制选择否”） -L, --local 为本地软件包生成配置文件以绕过 lintian(1) 的检查。 -P, --pedantic 对自动生成的文件进行严格（甚至古板到迂腐程度）的检查。 -T, --tutorial 在模板文件中输出教程注释行。 A.4. 示例 对比较正常的源码来说，您可以使用一行命令简单地构建一个自用的 Debian 二进制软件包。测试安装这样生成的软件包通常比传统的“make     install”命令安装至 /usr/local 目录更好，因为 Debian 软件包可以使 用“dpkg -P …””命令更干净地卸载掉。这里提供构建这类测试软件包的一 些例子（这些例子应该在大多数情况下足够使用。如果 -d 选项无法工作 ，请尝试使用 -t 选项。）     对典型的使用 autoconf/automake 的 C 程序源码树：     * debmake -d -i debuild     对于典型的 Python（版本 3）模块源码树：     * debmake -s -d -b":python3" -i debuild     对于 package-version.tar.gz 存档里的一个典型 Python*（版本 3）模 块：     * debmake -s -a package-version.tar.gz -b":python3" -i debuild     对于典型的以 package-version.tar.gz 归档提供的 Perl 模块：     * debmake -a package-version.tar.gz -b":perl" -i debuild A.5. 帮助软件包     打包工作也许需要额外安装一些专用的帮助软件包。 * Python（版本 3）程序可能需要 dh-python 软件包。 * Autotools (Autoconf + Automake) 构建系统可能需要 autotools-dev 或 dh-autoreconf 软件包。     * Ruby 程序可能需要 gem2deb 软件包。 * 基于JavaScript 的 Node.js 程序可能需要 pkg-js-tools 软件包。 * Java 程序可能需要 javahelper 软件包。 * Gnome 程序可能需要 gobject-introspection 软件包。 * 等等。 A.6. 注意事项 debmake 的目的是为软件包维护者提供开始工作的模板文件。注释行以 #     开始，其中包含一些教程性文字。您在将软件包上传至 Debian 仓库之前 必须删除或者修改这样的注释行。 许可证信息的提取和赋值过程应用了大量启发式操作，因此在某些情况下     可能不会正常工作。强烈建议您搭配使用其它工具，例如来自 devscripts 软件包的 licensecheck 工具，以配合 debmake 的使用。 组成 Debian 软件包名称的字符选取存在一定的限制。最明显的限制应当     是软件包名称中禁止出现大写字母。这里给出正则表达式形式的规则总结 ： * 上游软件包名称（-p）：[-+.a-z0-9]{2,}     * 二进制软件包名称（-b）：[-+.a-z0-9]{2,} * 上游版本号（-u）：[0-9][-+.:~a-z0-9A-Z]* * Debian 修订版本（-r）： [0-9][+.~a-z0-9A-Z]*     请在《Debian 政策手册》的第 5 章 - Control 文件及其字段一节中查看 其精确定义。 debmake 所假设的打包情景是相对简单的。因此，所有与解释器相关的程     序都会默认为“Architecture: all”的情况。当然，这个假设并非总是成立 。 A.7. 除错     请使用 reportbug 命令报告 debmake 软件包的问题与错误。     环境变量 $DEBUG 中设置的字符用来确定日志输出等级。 * i：打印信息 * p：列出全部全局参数 * d：列出所有二进制软件包解析得到的参数 * f：用于扫描授权信息的输入文件名 * y：授权信息栏的年份/名称切分信息 * s：format_state 的行扫描器     * b：content_state 扫描循环：循环开始 * m: content_state 扫描循环：正则匹配之后 * e: content_state 扫描循环：循环结束 * c：打印授权区段文本 * l：打印许可证区段文本 * a：打印作者/翻译者区段文本 * k：debian/copyright 各节的排序关键字 * n：debian/copyright 的扫描结果（“debmake -k”）     用法如下：     $ DEBUG=pdfbmeclak debmake ...     查看源码中的 README.developer 文件以了解更多信息。 A.8. 作者     Copyright © 2014-2021 Osamu Aoki A.9. 许可证     Expat 许可证 A.10. 参见     debmake-doc 软件包提供了“Debian 维护者指南”手册，以纯文本、HTML 和 PDF 三种格式存放在 /usr/share/doc/debmake-doc/ 目录下。 See also dpkg-source(1), deb-control(5), debhelper(7), dh(1),     dpkg-buildpackage(1), debuild(1), quilt(1), dpkg-depcheck(1), sbuild(1), gbp-buildpackage(1), and gbp-pq(1) manpages.