Debian维护者指南：debmake命令与软件包构建

需积分: 10 174 浏览量更新于2024-07-17 收藏 1.01MB PDF 举报

"debmake-doc.zh-cn.pdf 是一份 Debian 维护者指南，由 Osamu Aoki、杨博远和 Fonzie Huang 编写，旨在教导 Debian 用户和潜在的开发者如何使用 debmake 命令来构建 Debian 软件包。这份教程涵盖了现代打包风格，并提供了多种编程语言和工具的示例，包括 POSIX shell 脚本打包、Python3 脚本打包、C 语言与 Makefile、Autotools 和 CMake 的结合使用，以及如何处理包含共享库的多个二进制软件包的打包。文档遵循 Creative Commons 许可，允许自由复制、修改和分发，但需保留原始作者的版权信息。" 在 Debian 系统中，`debmake` 是一个用于创建 Debian 包的工具，它简化了软件包的构建过程。本指南详细介绍了如何利用 `debmake` 来管理软件源代码，使其符合 Debian 的打包规范。对于初级和中级的 Debian 开发者来说，这是一个非常有价值的资源。 1. **POSIX shell 脚本打包**：在 Debian 包中，shell 脚本常用于安装、配置和清理等阶段，`debmake` 可以帮助将这些脚本集成到 Debian 控制文件中，确保它们在安装和卸载软件包时正确执行。 2. **Python3 脚本打包**：Python 应用程序打包涉及到创建 `.deb` 文件，包括处理依赖关系、元数据和执行权限设置。`debmake` 提供了方法来管理 Python 包的源代码、元数据和依赖项，使得 Python 项目可以轻松地转化为 Debian 包。 3. **C 和 Makefile/Autotools/CMake**：当涉及到 C 语言项目时，通常会使用 Makefile、Autotools 或 CMake 来构建源代码。`debmake` 支持这些构建系统，能够自动创建 Debian 规范的规则，如 `rules` 文件，以确保编译、链接和安装步骤符合 Debian 标准。 4. **含有共享库的多个二进制软件包的打包**：在某些情况下，一个项目可能包含多个二进制包，其中一些是库，另一些是应用程序。`debmake` 提供指导，说明如何正确地分离库和应用程序，以及如何处理它们之间的依赖关系，以确保软件包的正确性和兼容性。 5. **版权和许可**：指南强调了软件的自由许可性质，使用者有权自由使用、修改和分发该软件，但需保留作者的版权信息。这一许可方式鼓励了知识的共享和改进。 `debmake-doc.zh-cn.pdf` 是一本深入浅出的 Debian 包构建教程，涵盖了多种编程环境和打包场景，对于希望贡献 Debian 社区或提升软件打包技能的人来说，是一份不可多得的学习资料。

CHAPTER 2. 预备知识 2.8. 贡献流程

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 态度友好。

• 对 is_it_DFSG()，及 is_its_dependency_DFSG()，请检查：

– Debian 自由软件指导方针（DFSG）。

• 对 is_it_distributable()，请检查：

– 该软件必须有一个许可证，其中应当允许软件被发行。

您或是需要填写并提交一份 ITP，或是需要“收养”一个软件包并开始为其工作。请见“Debian 开发

者参考（Debian Developer’s Reference）”文档：

• 5.1. 新软件包。

• 5.9. 移动、删除、重命名、丢弃、接手和重新引入软件包。

这一条不是绝对的要求，但请注意：遇上不友好的上游可能需要大家为此投入大量精力，而一个友好的上游则能协助解决程

序的各类问题。

CHAPTER 3. 工具的配置 3.3. GIT

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

提示

有必要使用某些图形界面 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"

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:diff_ctx=35:diff_cctx=33"

if ! [ -d $d/debian/patches ]; then mkdir $d/debian/patches; fi

请参考 quilt(1) 和处理大量补丁的方法暨对 Quilt 的介绍以了解如何使用 quilt 命令。

要获取使用示例，请查看第 4.8 节。

CHAPTER 3. 工具的配置 3.5. DEVSCRIPTS

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 选项以

帮助构建源码中具有外来无关内容的软件包（参见第 5.15 节）。

当前情况下，使用 4096 位的 RSA 密钥是较好的做法。另见创建一个新 GPG 密钥。

3.6 pbuilder

pbuilder 软件包提供了净室（干净的）（chroot）构建环境。

我们可以搭配使用另外几个辅助软件包对其自定义。

• cowbuilder 软件包能加速 chroot 创建过程。

• lintian 软件包能找到所构建软件包中的缺陷。

• bash、mc 和 vim 软件包在构建失败时用来查找问题。

• ccache 软件包可以加速 gcc。（可选）

• libeatmydata1 软件包可以加速 dpkg。（可选）

• 并行运行 make 以提高构建速度。（可选）

警告

可选的自定义项可能造成负面影响。如果有疑问，请禁用它们。

我们使用如下给出的内容来创建 ~/.pbuilderrc 文件（所有可选功能均已禁用）。

AUTO_DEBSIGN="${AUTO_DEBSIGN:-no}"

PDEBUILD_PBUILDER=cowbuilder

HOOKDIR="/var/cache/pbuilder/hooks"

MIRRORSITE="http://deb.debian.org/debian/"

#APTCACHE=/var/cache/pbuilder/aptcache

APTCACHE=/var/cache/apt/archives

#BUILDRESULT=/var/cache/pbuilder/result/

BUILDRESULT=../

EXTRAPACKAGES="ccache lintian libeatmydata1"

# enable to use libeatmydata1 for pbuilder

#export LD_PRELOAD=${LD_PRELOAD+$LD_PRELOAD:}libeatmydata.so

# enable ccache for pbuilder

#export PATH="/usr/lib/ccache${PATH+:$PATH}"

#export CCACHE_DIR="/var/cache/pbuilder/ccache"

#BINDMOUNTS="${CCACHE_DIR}"

sbuild 软件包提供了另一套 chroot 平台。

剩余137页未读，继续阅读

ros小生

粉丝: 99
资源: 30

Debian维护者指南：debmake命令与软件包构建

ubuntu16.04 amd64 make deb安装包

makedeb:使PKGBUILD在基于Debian的发行版上工作

makedeb:MakeDEB-是一个向导，用于从预安装的文件（脚本等）构建简单的DEB软件包。

Python库 | scrapy-doc-zh-2020.9.21.0.tar.gz

Python库 | elasticsearch-doc-zh-2020.9.21.0.tar.gz

C#-Spire.Doc-Spire.Pdf.zip

ruby-doc-2.0.0.648-36.el7.noarch.rpm

python-rtslib-doc-2.1.72-1.el7.noarch.rpm

evolution-data-server-doc-3.28.5-5.el7.noarch.rpm

glm-doc-0.9.6.3-1.el7.noarch.rpm

最新资源