软件包打补丁

本文介绍了如何在 Arch 构建系统 (ABS) 中创建和应用软件包补丁。

补丁描述了一个或多个文件的行更改集合。补丁通常用于自动化源代码的更改。

创建补丁

注意： 如果你只需要更改一两行，你可能想要使用 sed 代替。

diff 工具逐行比较文件。如果你保存它的输出，你就得到了一个补丁，例如 diff --unified --recursive --text foo bar > foobar.patch (可以缩写为 diff -ura)。如果你传递目录，diff 将比较它们包含的文件。

如果你已经构建了软件包，请删除 src 目录。
运行 makepkg --nobuild/makepkg -o，它将下载并提取 PKGBUILD 中指定的源文件，但不会构建它们。如果你在其上制作补丁的系统没有所需的依赖项，你可能必须运行 makepkg --nobuild --nodeps/makepkg -od 代替。
在 src 目录中创建提取目录的两个副本，一个作为原始副本，另一个用于你的修改版本。我们将它们称为 package.orig 和 package.new。
在 package.new 目录中进行更改。
运行 diff -ura package.orig package.new --color 并检查补丁是否看起来良好。
运行 diff -ura package.orig package.new > package.patch 以创建补丁。
更改到你从中复制的初始 package.orig 目录，并使用 patch --strip=1 --input=../package.patch （可以缩写为 patch -p1 -i ../package.patch）应用补丁。通过构建和安装修改后的软件包来验证补丁是否有效，使用 makepkg --noextract --install/makepkg -ei。

注意： 你也可以使用 Git 通过 git diff 或 git format-patch [1] 创建补丁。

有关更多信息，请参见 diff(1) 和 git-diff(1)。

提示： 大多数 git 托管平台（例如 GitHub 或 GitLab）允许通过将 .patch 附加到其 URL 来为特定提交或特定合并/拉取请求生成补丁。对于 GitHub，还可以考虑在 URL 末尾添加 ?full_index=1 参数，以避免由于将来对象哈希长度更改而导致的校验和不匹配。

应用补丁

本节概述了如何从 PKGBUILD 的 prepare() 函数中应用你创建或从 Internet 下载的补丁。按照以下步骤操作

在 PKGBUILD 的 source 数组中为补丁文件添加一个条目，与原始源 URL 用空格分隔。如果该文件在线可用，你可以提供完整的 URL，它将自动下载并放置在 src 目录中。如果是你自己创建的补丁，或者以其他方式不可用，你应该将补丁文件放在与 PKGBUILD 文件相同的目录中，并且只需将文件名添加到源数组，以便将其复制到 src 目录中。如果你重新分发 PKGBUILD，你当然应该将补丁与 PKGBUILD 一起包含。
然后使用 makepkg -g >> PKGBUILD 或 updpkgsums （来自 pacman-contrib）来更新 sha512sums 数组。或者手动将条目添加到 sha512sums 数组；你可以使用 sha512sum 工具生成补丁的总和。
如果 PKGBUILD 中尚不存在，则创建 prepare() 函数。
第一步是更改到需要打补丁的目录（在 prepare() 函数中，而不是在你的终端上！你想要自动化应用补丁的过程）。你可以使用类似 cd $pkgname-$pkgver 的命令来执行此操作。 $pkgname-$pkgver 通常是解压下载的源文件创建的目录名称，但并非在所有情况下都是如此。
现在你只需要从该目录中应用补丁。这非常简单，只需将 patch -p1 -i pkgname.patch 添加到你的 prepare() 函数中，将 pkgname.patch 更改为包含 diff 的文件的名称（该文件已自动复制到你的 src 目录中，因为它位于 PKGBUILD 文件的 source 数组中）。

prepare 函数示例

prepare() {
    cd $pkgname-$pkgver
    patch -Np1 -i ../eject.patch
}

或者，你可以使用 patch 的 --directory/-d 标志，而无需先 cd。上面的示例将变为

prepare() {
    patch -d $pkgname-$pkgver -Np1 -i ../eject.patch
}

现在从终端运行 makepkg。如果一切顺利，补丁将自动应用，你的新软件包将包含补丁中包含的任何更改。如果不是，你可能必须尝试 patch 的 --strip/-p 选项。在实验时，你可能会发现 --dry-run、--reverse 或 --verbose 选项可用。阅读 patch(1) 以获取更多信息。

基本上，它的工作原理如下。如果 diff 文件是为应用于 myversion/ 中的文件的补丁而创建的，则 diff 文件将应用于 myversion/file。你正在从 yourversion/ 目录中运行它（因为你会在 PKGBUILD 中 cd 到该目录），因此当 patch 应用文件时，你希望它将其应用于文件 file，去除 myversion/ 部分。 -p1 通过从路径中删除一个目录来做到这一点。但是，如果开发人员在 myfiles/myversion 中打补丁，你需要删除两个目录，因此你使用 -p2。

如果你不应用 -p 选项，它将去除所有目录结构。如果所有文件都在基本目录中，这没问题，但如果补丁是在 myversion/ 上创建的，并且其中一个编辑的文件是 myversion/src/file，并且你从 yourversion 中运行没有 -p 选项的补丁，它将尝试修补名为 yourversion/file 的文件。

大多数开发人员从正在修补的目录的父目录创建补丁，因此 -p1 通常是正确的。

使用 quilt

创建补丁的更简单方法是使用 quilt，它为管理许多补丁提供了更好的支持，例如应用补丁、刷新补丁以及将已修补的文件恢复到原始状态。quilt 在 Debian 上用于管理他们的补丁。有关生成、应用补丁和恢复已修补文件的基本 quilt 用法的基本信息，请参见使用 Quilt。

参见

http://www.kegel.com/academy/opensource.html — 关于修补文件的有用信息