📚 课程目录第4章实战

4、实战：使用 bsdiff 生成差分包：命令行操作、参数详解、生成第一个差分包

好，前面我们把 bsdiff 的原理和安装都捋了一遍。现在，咱们直接上手。

这一节，我会带你亲手生成第一个差分包。别怕，命令行操作其实就那么几个参数。我当年第一次跑 bsdiff 的时候，也以为会踩很多坑，结果发现——只要路径和参数对了，几秒钟就出结果。

首先，你得有两个 APK 文件。一个旧版，一个新版。我习惯在桌面上建一个 diff_demo 文件夹，把两个包扔进去。

举个例子：

嗯，这里要注意：两个包必须是同一个应用的签名版本。签名不同，bsdiff 也能跑，但生成的差分包在客户端可能合并失败。我在项目中遇到过这种问题，排查了半天才发现是签名不一致。

⚠️ 避坑指南： 我曾经因为测试包用了 debug 签名，正式包用了 release 签名，生成的差分包在用户手机上全部合并失败。所以，请确保新旧包的签名一致。

打开终端，进入 diff_demo 目录。然后执行：

bsdiff old.apk new.apk patch.diff

就这么简单。三个参数，按顺序来：

跑完之后，你会看到目录里多了一个 patch.diff 文件。我试了一下，这个差分包大概只有 2.3 MB。你想想看，从 25 MB 到 27 MB 的变化，差分包只占了不到 10% 的大小。这就是差分算法的威力。

  💡 核心结论： 差分包大小 ≈ 新旧包之间的实际差异，而不是新包的大小。差异越小，差分包越小。

bsdiff 的命令行参数其实不多。我整理了一个表格，方便你对照：

说实话，我平时只用三个必填参数。-s 参数我试过一次，生成的差分包确实小了一点，但耗时翻了一倍。对于 APK 这种几百 MB 以内的文件，默认参数完全够用。

🔧 小技巧： 如果你在 CI/CD 流水线里跑 bsdiff，建议加上 -q 参数，避免日志里刷一堆没用的进度信息。

咱们走一遍完整的流程。假设你已经在 diff_demo 目录下：

确认文件存在：

ls -lh
-rw-r--r--  1 user  staff    25M old.apk
-rw-r--r--  1 user  staff    27M new.apk

查看结果：

ls -lh
-rw-r--r--  1 user  staff    25M old.apk
-rw-r--r--  1 user  staff    27M new.apk
-rw-r--r--  1 user  staff    2.3M patch.diff

看到了吗？2.3 MB 的差分包，搞定了。你想想看，如果用户直接下载 27 MB 的新包，流量消耗大不说，下载时间也长。但用差分包，用户只需要下载 2.3 MB，然后本地合并，体验直接拉满。

  📊 数据对比：
  全量包下载：27 MB
差分包下载：2.3 MB
节省流量：约 91.5%

为了让你更直观地理解 bsdiff 的工作流程，我画了一张图：

说白了，bsdiff 就是拿旧包和新包做一次“找不同”。它不会把新包整个复制一遍，而是只记录那些变化了的字节。然后把这些差异压缩成一个文件，就是咱们的差分包。

生成差分包只是第一步。你还得验证它能不能正确合并回去。bsdiff 配套的 bspatch 就是干这个的：

bspatch old.apk new_from_patch.apk patch.diff

执行完之后，对比 new_from_patch.apk 和原始的 new.apk：

md5 new.apk new_from_patch.apk
MD5 (new.apk) = a1b2c3d4e5f6...
MD5 (new_from_patch.apk) = a1b2c3d4e5f6...

MD5 一致，说明合并成功。嗯，这一步千万别省。我见过有人生成差分包后直接上线，结果客户端合并失败，用户反馈安装包损坏。所以，每次生成差分包后，务必用 bspatch 验证一遍。

⚠️ 强制要求： 每次生成差分包后，必须用 bspatch 合并验证，并比对 MD5。这是上线前的最后一道防线。

这一节，咱们亲手跑通了 bsdiff 的完整流程。从准备两个包，到执行命令，再到验证结果，每一步我都踩过坑，也把经验分享给了你。

记住几个关键点：