修补软件包
本文介绍了如何在 Arch 构建系统 (ABS) 中创建软件包和应用软件包补丁。
补丁 描述了一个或多个文件的行更改集合。补丁通常用于自动化源代码的更改。
创建补丁
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构建和安装修改后的软件包来验证补丁是否正常工作。
有关更多信息,请参阅 diff(1) 和 git-diff(1)。
.patch 附加到其 URL 来为特定提交或特定合并/拉取请求生成补丁。对于 GitHub,还考虑在 URL 末尾添加 ?full_index=1 参数,以避免由于未来对象哈希长度更改而导致的校验和不匹配。应用补丁
本节概述了如何从 PKGBUILD 的 prepare() 函数中应用您创建或从互联网下载的补丁。请按照以下步骤操作
- 在
PKGBUILD的source数组中为补丁文件添加一个条目,与原始源 URL 用空格分隔。如果该文件在线可用,您可以提供完整的 URL,它将自动下载并放置在src目录中。如果是您自己创建的补丁,或者以其他方式不可用,您应该将补丁文件放在与PKGBUILD文件相同的目录中,只需将文件名添加到 source 数组,以便将其复制到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 用法的基本信息,请参阅 Using Quilt。
参见
- http://www.kegel.com/academy/opensource.html — 关于修补文件的有用信息