agx/git-buildpackage 项目：从 Git 仓库构建 Debian 软件包指南

前言

在 Debian 软件包开发过程中，git-buildpackage 工具（简称 gbp）是一个强大的工具集，它能够帮助开发者直接从 Git 仓库构建 Debian 软件包。本文将详细介绍如何使用 gbp 工具进行软件包构建的各种场景和技巧。

基础构建流程

常规构建命令

要从 Git 仓库构建 Debian 软件包，最基本的命令是：

gbp buildpackage

这个命令会自动完成以下操作：

1. 构建上游源代码压缩包（tarball）
2. 调用 debuild 工具构建软件包

在开发阶段（当你不处于 debian-branch 分支或有未提交的更改时），通常需要添加 --git-ignore-new 选项：

gbp buildpackage --git-ignore-new

上游源代码处理

当 gbp 找不到有效的上游源代码压缩包时，它会根据上游版本号匹配的标签自动创建一个。如果需要精确重建原始压缩包（使用 pristine-tar 分支中的信息），应该使用：

gbp buildpackage --git-pristine-tar

这是推荐的创建上游源代码压缩包的方式，可以确保与原始导入的压缩包完全一致。

发布构建

当你完成开发并准备发布时，应该先提交所有更改，然后使用：

gbp buildpackage --git-tag

这个命令会：

1. 构建 Debian 软件包
2. 根据 changelog 中的当前版本号创建标签

如果需要 GPG 签名标签，可以添加 --git-sign 和 --git-keyid 选项。默认的标签格式是 debian/<version>，可以通过 debian-tag 选项修改。

使用独立构建目录

许多开发者习惯使用独立的构建目录，这可以通过 --git-export-dir 选项实现：

gbp buildpackage --git-export-dir=../build-area/

这会导出当前分支的 HEAD 到 ../build-area/package-version 目录并构建软件包。如果需要导出特定版本而非当前 HEAD，可以使用 --git-export 选项指定：

gbp buildpackage --git-export-dir=../build-area --git-export=debian/0.4.3

特殊参数说明：

• INDEX：导出当前索引状态（包含已暂存但未提交的更改）
• WC：原样导出当前工作副本

可以在配置文件中设置默认构建目录：

[buildpackage]
export-dir=../build-area

构建成功后，gbp 会自动清理构建目录。如需保留，使用 --git-no-purge 选项。

构建钩子

gbp 提供了多种钩子（hooks），可以在构建过程的不同阶段执行自定义操作：

常用钩子类型

1. prebuild：构建前执行
2. postbuild：构建成功后执行
3. posttag：创建标签后执行

自动运行 Lintian

构建后自动运行 Lintian 检查：

gbp buildpackage --git-postbuild='lintian $GBP_CHANGES_FILE'

或在配置文件中设置：

postbuild=lintian $GBP_CHANGES_FILE

自动推送更改

构建并创建标签后自动推送到远程仓库：

gbp buildpackage --git-tag --git-posttag="git push && git push --tags"

更安全的推送脚本示例：

#!/bin/sh -e

if ! REMOTE=$(git config --get branch."${GBP_BRANCH}".remote); then
    REMOTE=origin
fi

if [ "$GBP_TAG" ]; then
     echo "Pushing $GBP_TAG to $REMOTE"
     git push "$REMOTE" "$GBP_TAG"
else
     echo "GBP_TAG not set."
     exit 1
fi

if [ "$GBP_SHA1" ] && [ "$GBP_BRANCH" ]; then
    git push "$REMOTE" "$GBP_SHA1":"$GBP_BRANCH"
else
    echo "GBP_SHA1 or GBP_BRANCH not set."
    exit 1
fi
echo "done."

导出后处理（postexport）

postexport 钩子允许在构建前对导出的源代码进行最后调整。典型应用场景是从一个 Debian 分支创建多个不同的源代码和二进制包。

示例配置：

[buildpackage]
export-dir = ../build-area
cleaner =
postexport = crosstoolchain-expand.sh

示例脚本会处理 changelog 模板、lintian 覆盖文件以及 rules 和 control 文件，根据环境变量 PKG_FLAVOR 生成不同的包变体。

导出前处理（preexport）

preexport 钩子允许在准备和导出原始压缩包前执行自定义操作。例如，从单独的仓库检出大型二进制资源。

总结

git-buildpackage 提供了灵活而强大的工具链，支持从简单的开发构建到复杂的发布流程。通过合理使用构建目录和各种钩子，开发者可以构建出符合 Debian 标准的高质量软件包，同时保持高效的工作流程。