在Debian系统上修改开源软件源代码制作patch - 教程

在Debian系统上修改开源软件源代码制作patch

整个过程可以分为以下几个主要步骤：

1. 准备环境: 安装编译工具和blueman的编译依赖。
2. 获取源码: 下载blueman的Debian源码包。
3. 修改代码并创建Patch: 使用Debian推荐的quilt工具进行修改和补丁管理。
4. 编译打包: 将你的修改和源码一起编译成一个新的.deb安装包。
5. 安装和验证: 安装你新编译的包，并验证修改是否生效。

---

详细步骤

第1步：准备环境

首先，你需要确保你的系统已经准备好进行软件编译。

1. 启用源码仓库
   你需要编辑 /etc/apt/sources.list 文件，确保每一行 deb 地址后面都有一行对应的 deb-src 地址。这是为了让 apt 能够下载源代码。

   打开文件：

   sudo nano /etc/apt/sources.list

   例如，如果你的文件中有这样一行：

   deb http://deb.debian.org/debian/ bookworm main

   请确保它下面有对应的 deb-src 行：

   deb-src http://deb.debian.org/debian/ bookworm main

   保存文件后，更新你的包列表：

   sudo apt update

2. 安装必要的编译工具
   这些是Debian打包必备的工具。

   sudo apt install build-essential devscripts quilt

   • build-essential: 包含编译器（gcc/g++）、make等基础工具。
   • devscripts: 包含一系列用于Debian打包的脚本，如debuild。
   • quilt: Debian官方推荐的补丁管理工具，非常强大。

3. 安装 blueman 的编译依赖
   apt 有一个非常方便的命令，可以自动安装某个软件包编译时所需的所有依赖。

   sudo apt-get build-dep blueman

   这个命令会读取blueman源码包的控制文件，并安装所有列出的编译依赖项。

第2步：获取源码

现在，你的环境准备好了，可以下载blueman的源码了。

1. 创建一个工作目录，并进入该目录：

   mkdir ~/blueman-dev
   cd ~/blueman-dev

2. 下载blueman的源码包：

   apt source blueman

   这个命令会下载三个文件（一个 .orig.tar.gz 原始源码包，一个 .debian.tar.xz Debian特定修改包，一个 .dsc 描述文件），并自动解压到一个以版本号命名的目录中，例如 blueman-2.3.5。

3. 进入解压后的源码目录：

   cd blueman-2.3.5/ # 注意：版本号可能不同，请使用你实际解压出的目录名

第3步：修改代码并创建Patch

这是最核心的一步。我们将使用 quilt 来管理我们的修改，这样可以保持源码树的干净，并轻松生成补丁文件。debian/patches/ 目录存放了所有应用于源码的补丁。

1. 创建一个新的补丁 (Patch)
   给你的补丁起一个有意义的名字，比如 my-connection-fix.patch。

   quilt new my-connection-fix.patch

2. 告诉 quilt 你要修改哪个文件
   假设你要修改的文件是 plugins/mechanism/Mechanism.py。

   quilt add plugins/mechanism/Mechanism.py

   重要提示: 你可以添加多个文件到同一个patch中。在你修改任何文件之前，都要先用 quilt add 命令把它加进来。

3. 修改代码
   现在，用你喜欢的编辑器打开这个文件并进行修改。

   nano plugins/mechanism/Mechanism.py

   进行你想要的修改，比如修复连接失败的逻辑，然后保存并关闭文件。

4. 生成/刷新补丁
   在你完成所有修改后，使用以下命令，quilt会自动比较你修改过的文件和原始文件的差异，并把这些差异保存到你之前创建的 my-connection-fix.patch 文件中。

   quilt refresh

   现在，你可以去 debian/patches/ 目录下查看，会发现多了一个 my-connection-fix.patch 文件，里面就是你的代码改动。同时，debian/patches/series 文件里也会自动添加这一行的名字，确保编译时这个补丁会被应用。

5. （可选）为你的补丁添加描述头
   这是一个好习惯，可以说明这个补丁是做什么的。

   quilt header -e

   这会打开一个编辑器，让你填写 Description 和 Author 等信息。

第4步：编译打包

现在你的补丁已经准备好了，可以开始编译生成 .deb 文件了。

1. （可选，推荐）更新changelog
   为了区分你编译的版本和官方版本，最好在 debian/changelog 文件中增加一个条目。这可以防止你的包被官方更新覆盖。

   dch -i

   或者使用 dch -l local 来添加一个本地版本后缀：

   dch -l local "My local build with connection fix."

   这会自动用编辑器打开 debian/changelog 文件，在顶部生成一个新的版本条目，比如 2.3.5-2+local1。你只需要确认信息无误并保存即可。

2. 开始编译
   在源码的根目录（blueman-2.3.5/）下，运行编译命令：

   dpkg-buildpackage -us -uc -b

   • -us: 不对源码包进行签名 (Don’t sign source package)。
   • -uc: 不对 .changes 文件进行签名 (Don’t sign changes file)。
   • -b: 只编译二进制包（即我们需要的 .deb 文件）。

   编译过程需要一些时间。如果一切顺利，你不会看到任何错误。

3. 查找编译好的 .deb 文件
   编译完成后，新的 .deb 文件会生成在上一级目录，也就是 ~/blueman-dev/ 目录中。

   ls ../*.deb

   你应该能看到类似 blueman_2.3.5-2+local1_amd64.deb 这样的文件。

第5步：安装和验证

1. 卸载旧版本
   为了避免冲突，最好先卸载掉系统里通过apt安装的blueman。

   sudo apt remove blueman

2. 安装你的新包
   使用 dpkg 来安装你刚刚编译好的包。

   sudo dpkg -i ../blueman_*.deb

   注意: dpkg 不会自动处理依赖关系。如果在上一步 build-dep 都已安装，这里通常不会有问题。万一提示缺少依赖，可以运行以下命令来修复：

   sudo apt-get -f install

3. 防止你的包被自动更新覆盖
   这是非常重要的一步！否则下次你运行 sudo apt upgrade 时，你的自定义版本会被官方仓库里的新版本覆盖掉。

   sudo apt-mark hold blueman

   当你不再需要这个自定义版本时，可以用 unhold 命令解除锁定：

   sudo apt-mark unhold blueman

4. 验证
   重启blueman服务或直接重启电脑，然后测试你的蓝牙连接功能，看你的修改是否解决了问题。

   killall blueman-applet
   blueman-applet &

清理

使用 quilt push 命令。这个命令会应用当前正在工作的补丁（my-connection-fix.patch），并让你准备好处理下一个补丁。

清理编译文件
dpkg-buildpackage -T clean
这个命令会执行 debian/rules 文件中定义的 clean 目标，它会做以下事情：

1. 撤销所有 quilt 补丁，让源码树恢复到原始状态。
2. 删除所有由 configure 或 meson setup 等命令生成的 Makefile 和配置文件。
3. 删除所有编译生成的中间文件（.o, .pyc 等）。
4. 删除上一次编译留下的所有临时目录和文件。

执行完后，你的源码目录就回到了一个干净的、可以重新开始编译的状态。

管理补丁

1. 如果要修改现有的补丁，比如 my-connection-fix.patch，先用 quilt pop 回退到它，然后编辑，最后 quilt refresh。
2. 如果要添加新补丁，用 quilt push -a 应用所有现有补丁，然后 quilt new ... 开始新的修改。

---

总结

整个流程可以简化为：
apt source -> quilt new -> quilt add -> 编辑代码 -> quilt refresh -> dpkg-buildpackage -> dpkg -i -> apt-mark hold。

这个过程不仅适用于blueman，也适用于Debian/Ubuntu仓库中的绝大多数软件包。祝你成功解决问题！如果你的补丁是通用的修复，也欢迎你向 blueman 的上游项目（GitHub）提交一个Pull Request，为开源社区做出贡献。
在Debian系统上修改开源软件源代码、制作patch并重新编译打包

补充

1. 常用 quilt 命令：
   quilt series: 查看所有补丁的列表以及它们的应用状态。
   quilt push: 应用下一个补丁。
   quilt pop: “弹出”并撤销上一个应用的补丁，使其变为当前活动补丁，方便你重新编辑它。
   quilt push -a: 应用所有补丁。
   quilt pop -a: 撤销所有补丁，让源码树恢复到最原始的状态。
   quilt top: 查看栈顶（最新应用）的补丁。
   quilt previous: 切换到上一个补丁。
   quilt next: 切换到下一个补丁。
2. 当更新相关软件时会设计依赖，可能会报错且update/upgrade后也无效，请检查相关包是否被锁定
   apt-mark showhold xxx //根据报错提示