{"id":19747417,"url":"https://github.com/sisong/sfpatcher","last_synced_at":"2025-11-23T01:03:01.864Z","repository":{"id":64181686,"uuid":"353909526","full_name":"sisong/sfpatcher","owner":"sisong","description":"stable \u0026 fast to patch apk archives, used by Android app store. 为安卓应用商店使用而优化的apk增量更新算法。","archived":false,"fork":false,"pushed_at":"2025-03-23T03:39:31.000Z","size":445,"stargazers_count":80,"open_issues_count":0,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-23T04:26:05.478Z","etag":null,"topics":["apk","apkdiffpatch","archive-patcher","bsdiff","diff","hdiffpatch","patch","sfpatcher","xdelta3","zip"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sisong.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-04-02T04:57:56.000Z","updated_at":"2025-03-23T03:39:35.000Z","dependencies_parsed_at":"2023-12-25T00:25:10.876Z","dependency_job_id":"4ae85f98-1a04-445e-91a4-7b596c0ff3dd","html_url":"https://github.com/sisong/sfpatcher","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/sisong/sfpatcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sisong%2Fsfpatcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sisong%2Fsfpatcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sisong%2Fsfpatcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sisong%2Fsfpatcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sisong","download_url":"https://codeload.github.com/sisong/sfpatcher/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sisong%2Fsfpatcher/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285884980,"owners_count":27248045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-22T02:00:05.934Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apk","apkdiffpatch","archive-patcher","bsdiff","diff","hdiffpatch","patch","sfpatcher","xdelta3","zip"],"created_at":"2024-11-12T02:17:47.386Z","updated_at":"2025-11-23T01:03:01.857Z","avatar_url":"https://github.com/sisong.png","language":null,"funding_links":[],"categories":["Patch"],"sub_categories":[],"readme":"# sfpatcher：针对应用商店的apk增量算法\n**v1.0.15 已正式上线**，为多家大厂和数亿手机终端用户提供更新服务，当前最新版本 v1.4.0   \n[**sfpatcher** 命令行工具下载](https://github.com/sisong/sfpatcher/releases)（支持Windows、Linux、MacOS），\n[命令行使用说明](https://github.com/sisong/sfpatcher/blob/master/cmdline_doc.md)   \n需要商业授权(含源代码\u0026培训)，请联系作者： \u003chousisong@hotmail.com\u003e   \n\n## 定义\n**app**：本文档一般指智能手机和Pad设备上的软件，包括应用和游戏等。   \n**应用商店**：这里指当前安卓智能设备上负责管理app的软件，支持app的下载、更新、推荐等功能；软件也可能分成**应用市场**和**游戏中心**两个独立应用。   \n**apk**：安卓设备上的约定的软件包格式，它属于特殊约定格式的zip压缩档案格式的一种。为了防止篡改，发布的apk都带有签名。   \n**diff**：这里指一种创建补丁的算法，它能计算出两个数据之间的差异，比如生成从旧版本数据到新版本之间的补丁数据。   \n**patch**：打补丁，diff算法的逆算法，它能在旧版本数据基础上应用补丁来得到新版本的数据。   \n## 背景\n随着智能手机的普及和应用数量的爆发式增长，手机上大量app的下载和更新将产生巨大的数据流量。手机上的应用商店一般都会部署增量更新系统来节省大量的服务带宽成本和提升用户体验（节省用户流量和减少下载时间），而不用每次都下载完整版本。   \n\n应用商店使用的增量更新算法一般选择使用的是基于字节的 diff 和 patch 算法，包括：[BsDiff ](http://www.daemonology.net/bsdiff)、[xdelta3](https://github.com/jmacd/xdelta)、[HDiffPatch](https://github.com/sisong/HDiffPatch) 等。   \n - **BsDiff** 是当前选择使用较多的算法，创建的补丁小，代码量小，容易移植。但diff和patch场景下执行速度都很慢、内存占用巨大，应用于应用商店等场景时需要进行一些修改定制。\n - **xdelta3** 在diff和patch场景下执行速度都很快，输出标准化的补丁格式(vcdiff格式,也有改成gdiff的)，apk补丁大小和BsDiff接近或略大，内存占用中等。该算法在diff处理较大文件的时候（比如几百MB以上），常会输出不正常的巨大补丁，除非使用和文件大小相当的参考内存来diff和patch，而这时patch时内存占用可控的优点就没有了。\n - **HDiffPatch** 是作者开源的算法，创建的补丁一般比BsDiff略小一些，diff(-s模式)和patch场景下执行速度都很快，内存占用可控并很小。\n diff时也支持-m模式，用更大的内存和时间代价(这时也比BsDiff快很多倍)来得到更小一些的补丁包。\n HDiffPatch 也可以部分兼容 BsDiff4、xdelta3 和 [open-vcdiff](https://github.com/google/open-vcdiff) 的补丁。\n HDiffPatch 现在已经被**vivo**、**小米**、**荣耀**、**OPPO**、**华为**、**腾讯**、**字节跳动**、**传音**、**米哈游**等所使用。 \n  从为4KB RAM内存、8位CPU的MCU设备创建OTA增量补丁(4KB内存里一边解压一边patch!)，到为上百GB的游戏创建更新补丁，HDiffPatch 算法得到了越来越广泛的应用。\n## 针对apk的diff\u0026patch算法\n前面提到的增量更新实现方案都只是把apk单纯的看作文件数据直接用算法进行diff\u0026patch，而没有考虑apk包本身是一个zip压缩包的事实。这种简单使用方式可以概括为公式：\n```c\n  diffFile:= diff(oldApk,newApk)\n  newApk  := patch(oldApk,diffFile)\n```\n大家可以试试：一个大文件在1/4处简单进行修改，如果把修改前后的2个文件分别压缩成zip文件，用二进制工具打开2个zip文件对比会发现：前面一部分的编码相同（那这部分约占1/4），但后面部分的编码数据很可能会完全不同。   \n压缩算法破坏了修改“现场”，diff算法的优势无法真正发挥出来(生成了巨大的补丁)。那么我们是否可以开发针对apk文件格式的diff\u0026patch算法呢？ 它能够识别出上面的情况：其实只是修改了一个字符！(即生成极小的补丁)   \n很容易想到的一个优化思路，先解压再diff不就好了！原理可以概括为公式：\n```c\n  diffFile:=diff(decompress(oldApk),decompress(newApk))\n  newApk  :=recompress(patch(decompress(oldApk),diffFile))\n```\n公式里面的diff和patch函数很好办，选择上面提到的一种基于字节的diff\u0026patch算法就行；decompress函数的实现也较简单，就是zip包的解压缩算法；recompress函数的实现比较麻烦一些，需要保证精确的原样还原出newApk（避免破坏签名和运行等）。   \n而 [archive-patcher](https://github.com/google/archive-patcher) 和  [ApkDiffPatch](https://github.com/sisong/ApkDiffPatch) 正是这种思路的实现方案，也包括本文章要介绍的 [sfpatcher](https://github.com/sisong/sfpatcher) 方案都基于这个思路。   \n - **archive-patcher** 谷歌开源的一个针对apk文件的diff\u0026patch实现，在谷歌play商店中使用。内部使用了BsDiff算法作为基础，主要用java语言开发，针对解压状态总数据量小于512MB的并且使用了zlib的deflate压缩算法创建的apk文件，执行优化的补丁算法。 该方案在patch时比较慢，特别是部分略大的apk文件使用了较高的压缩级别时，这时重新压缩出新版本apk会慢的让用户无法接受，所以该优化方案一般用在可以后台更新的场景下。\n - **ApkDiffPatch** 是作者开源的算法，为给自己团队开发的apk更新来开发的方案，创建的补丁平均比 archive-patcher 小很多，patch速度中等；方案一般用在可以自己对需要升级的apk进行重新签名的场景，而不能部署于应用商店。内部使用了 HDiffPatch 算法作为基础，用C\\C++语言开发。为了patch时精确还原，和加快压缩还原时的速度，需要对发布的apk文件执行 ApkNormalized 预处理流程（使用了较快的压缩参数，处理过的apk需要重新签名）。 patch时可以支持并行压缩来加快apk还原速度，但这时内存资源占用比较严重，和多个线程正在分别压缩的多个文件源大小和其压缩后大小的总和相当。\n## sfpatcher 是什么？\n针对压缩档案文件的高性能增量更新方案。类似于 archive-patcher 方案可部署于应用商店的diff\u0026patch算法，该领域的重要技术进展。   \n内部使用了 HDiffPatch 算法作为基础，用C\\C++语言开发，当前支持为deflate格式压缩的数据创建优化的补丁(用zlib压缩的支持最好)，支持在多种档案格式文件之间创建优化的补丁。     \n### sfpatcher 之道\n- 针对应用商店的场景专门设计，优化补丁大小，支持大型游戏，patch时精确快速还原任意apk文件，能够用于用户交互场景。\n- 多级可选的补丁包大小，极致的patch速度：提供比谷歌**archive-patcher**方案的补丁(+lzma2压缩后)小2%的情况下，patch速度是其30倍！补丁比其小24%的情况下，速度是其8倍(这时补丁比BsDiff方案小约55%并且速度快得多)！ （注1）\n- patch时的内存等资源占用可控；diff时支持多种方案限制patch时的最大内存占用到合适的约定水平。即支持patch时O(1)平均内存占用的优化补丁包，并且patch过程中不使用临时文件！\n- 优化的用户体验：因为补丁变小，下载时间也会变短，从而可能缩短整体更新时间，也更省电省流量。还可以支持下载数据的同时就开始patch，不用将补丁文件保存到内存或硬盘上，结合快速的patch，很多时候下载完成时，就可以得到了完整的新版本apk文件。 \n- 利用精确还原算法，对于初次下载的apk文件也能进行解压后的重压缩；从而节省用户初次下载apk时的流量。最多情况下平均比直接下载apk文件减少25%的数据，部分文件能减少35%以上的数据！\n- 支持从中断的位置继续patch的特性，节省程序被终止后再次执行程序时的打补丁时间。\n- 高扩展性，框架支持多种压缩档案格式(apk、zip、zip64、jar、hap、gz、tar等)和其嵌套(如apk中多个子apk); 档案格式本身和档案中数据的压缩算法都只是以插件的形式获得支持。patch端的执行，设计上不依赖于具体的档案格式。\n- patch端支持对客户端的oldApk文件进行虚拟化；比如可以用一些简单的描述数据来移除oldApk(v1--v4签名)中添加的各种类型渠道号的影响，提高了补丁适应能力。\n- diff端参数可选择性丰富，对各种使用场景可以定制性的设置合适的控制参数。\n- patch结果提供丰富的错误号，并进行高性能和高强度的数据完整性校验，以利于追踪patch失败的原因，提高升级成功率。\n- 支持专用的标准化流程sf_normalize，在保持还不错的patch合成速度的情况下，进一步降低30%补丁包大小。（注意：该特性需要第三方apk厂商配合,对apk执行标准化处理,并重新签名）\n\n注1：所有测试数据来源于收集的一些常用apk应用，共32个用例；并在ARM CPU Kirin980上测试了部分patch。（见性能测试对比数据）\n\n## 方案主要特性对比\n### **sfpatcher 和 archive-patcher**：\n- sfpatcher 的patch端比 archive-patcher 快很多倍(相近补丁大小的情况下速度是其30倍)，资源占用小(O(1))，能够满足各种使用场景的要求；而 archive-patcher 还原慢，资源占用大，一般用于后台更新场景。\n- sfpatcher 生成的补丁大小在很多情况下也可以比 archive-patcher 的补丁(压缩后)更小。\n- sfpatcher 创建压缩后的补丁，执行patch前不需要额外步骤解压缩补丁，边patch边随时解压缩补丁数据；而 archive-patcher 创建的补丁需要额外压缩和patch前解压。\n- sfpatcher 在patch时不需要对oldApk提前进行解压，边patch边随时解压用到的oldApk中的数据，可以始终保持O(1)内存占用；而 archive-patcher 需要提前将oldApk中用到的数据全部解压缩到一个临时文件里。\n- sfpatcher 支持大型apk文件，包括游戏等的更新升级，patch速度快；而 archive-patcher 有解压+未压缩总数据最大512M的限制，而且patch也很慢，某些情况下甚至patch需要几分钟。\n- sfpatcher 基于C\\C++，部署兼容性不受系统限制；结合JNI在安卓上使用，兼容安卓4.1到安卓15；而 archive-patcher 基于 java 并和运行时系统环境耦合重，diff和patch时都很可能会遇到环境兼容性问题。\n### **sfpatcher 和 ApkDiffPatch**：\n- sfpatcher 可用于广泛的场景，而ApkDiffPatch用于能够对apk文件进行重新签名的场景。\n- sfpatcher 的patch端比 ApkDiffPatch 更快一些，多线程时内存占用也比较可控；而 ApkDiffPatch 在并行patch的时候内存占用较大。\n- sfpatcher 生成的补丁平均比 ApkDiffPatch 稍大一些；当然对于同样ApkNormalized化过的apk，两个方案生成的补丁大小相近，即 sfpatcher 可以平滑的替代 ApkDiffPatch方案。并且，新版本sfpatcher提供了专用的sf_normalize标准化程序，补丁包大小一致，但patch合成速度可以进一步加倍！\n- sfpatcher 插件框架可支持多种档案格式，并且档案格式和patch端无关，兼容性和扩展性更好；而 ApkDiffPatch 的patch端和zip、apk格式、签名方式耦合过重，随着apk格式、签名方案和apk工具的变动，容易有兼容性问题(可能造成无法准确还原newApk或者无法优化补丁包大小)。\n\n# 参与测试的diff\u0026patch方案\n- [BsDiff](http://www.daemonology.net/bsdiff)\n- [xdelta3](https://github.com/jmacd/xdelta)\n- [HDiffPatch](https://github.com/sisong/HDiffPatch)\n- [archive-patcher](https://github.com/google/archive-patcher) \n- [ApkDiffPatch](https://github.com/sisong/ApkDiffPatch)\n- [sfpatcher](https://github.com/sisong/sfpatcher)\n\n# 测试目的\n对比多种diff\u0026patch方案在apk文件增量更新方面的运行数据；   \n测试项主要包括：diff速度、diff内存占用、补丁大小(用压缩率代替，压缩后补丁大小/新版本apk大小)、patch速度、patch内存占用（后面这3项指标可能更重要一些）   \n\n# 测试用例\n收集了32组测试用例；这些apk下载于小米应用商店、谷歌Play商店，按照下载量大和最近进行过更新为标准进行收集。   \n限于有限的用例和收集偏差，数据和实际情况可能略有差异。 旧版本apk平均大小103.2MB，新版本apk平均大小103.8MB。   \n\n| 编号|app|新apk \u003c-- 旧apk|新apk大小|旧apk大小|\n|----:|:---:|:----|----:|----:|\n|1|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/cn.wps.moffice_eng.png\" width=\"36\"\u003e|cn.wps.moffice_eng_13.30.0.apk \u003c-- 13.29.0|95904918|94914262|\n|2|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.achievo.vipshop.png\" width=\"36\"\u003e|com.achievo.vipshop_7.80.2.apk \u003c-- 7.79.9|127395632|120237937|\n|3|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.adobe.reader.png\" width=\"36\"\u003e|com.adobe.reader_22.9.0.24118.apk \u003c-- 22.8.1.23587|27351437|27087718|\n|4|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.alibaba.android.rimet.png\" width=\"36\"\u003e|com.alibaba.android.rimet_6.5.50.apk \u003c-- 6.5.45|195314449|193489159|\n|5|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.amazon.mShop.android.shopping.png\" width=\"36\"\u003e|com.amazon.mShop.android.shopping_24.18.2.apk \u003c-- 24.18.0|76328858|76287423|\n|6|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.baidu.BaiduMap.png\" width=\"36\"\u003e|com.baidu.BaiduMap_16.5.0.apk \u003c-- 16.4.5|131382821|132308374|\n|7|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.dragon.read.png\" width=\"36\"\u003e|com.dragon.read_5.5.3.33.apk \u003c-- 5.5.1.32|45112658|43518658|\n|8|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.ebay.mobile.png\" width=\"36\"\u003e|com.ebay.mobile_6.80.0.1.apk \u003c-- 6.79.0.1|61202587|61123285|\n|9|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.eg.android.AlipayGphone.png\" width=\"36\"\u003e|com.eg.android.AlipayGphone_10.3.0.apk \u003c-- 10.2.96|122073135|119046208|\n|10|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.google.android.apps.translate.png\" width=\"36\"\u003e|com.google.android.apps.translate_6.46.0.apk \u003c-- 6.45.0|48892967|48843378|\n|11|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.google.android.googlequicksearchbox.png\" width=\"36\"\u003e|com.google.android.googlequicksearchbox_13.38.11.apk \u003c-- 13.37.10|190539272|189493966|\n|12|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.jingdong.app.mall.png\" width=\"36\"\u003e|com.jingdong.app.mall_11.3.2.apk \u003c-- 11.3.0|101098430|100750191|\n|13|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.netease.cloudmusic.png\" width=\"36\"\u003e|com.netease.cloudmusic_8.8.45.apk \u003c-- 8.8.40|181914846|181909451|\n|14|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.reddit.frontpage.png\" width=\"36\"\u003e|com.reddit.frontpage_2022.36.0.apk \u003c-- 2022.34.0|50205119|47854461|\n|15|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.sankuai.meituan.takeoutnew.png\" width=\"36\"\u003e|com.sankuai.meituan.takeoutnew_7.94.3.apk \u003c-- 7.92.2|74965893|74833926|\n|16|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.sankuai.meituan.png\" width=\"36\"\u003e|com.sankuai.meituan_12.4.207.apk \u003c-- 12.4.205|93613732|93605911|\n|17|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.sina.weibo.png\" width=\"36\"\u003e|com.sina.weibo_12.10.0.apk \u003c-- 12.9.5|156881776|156617913|\n|18|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.smile.gifmaker.png\" width=\"36\"\u003e|com.smile.gifmaker_10.8.40.27845.apk \u003c-- 10.8.30.27728|102403847|101520138|\n|19|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.ss.android.article.news.png\" width=\"36\"\u003e|com.ss.android.article.news_9.0.7.apk \u003c-- 9.0.6|54444003|53947221|\n|20|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.ss.android.ugc.aweme.png\" width=\"36\"\u003e|com.ss.android.ugc.aweme_22.6.0.apk \u003c-- 22.5.0|171683897|171353597|\n|21|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.taobao.taobao.png\" width=\"36\"\u003e|com.taobao.taobao_10.18.10.apk \u003c-- 10.17.0|117218670|117111874|\n|22|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.tencent.mm.png\" width=\"36\"\u003e|com.tencent.mm_8.0.28.apk \u003c-- 8.0.27|266691829|276603782|\n|23|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.tencent.mobileqq.png\" width=\"36\"\u003e|com.tencent.mobileqq_8.9.15.apk \u003c-- 8.9.13|311322716|310529631|\n|24|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.tencent.mtt.png\" width=\"36\"\u003e|com.tencent.mtt_13.2.0.0103.apk \u003c-- 13.2.0.0045|97342747|97296757|\n|25|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.tripadvisor.tripadvisor.png\" width=\"36\"\u003e|com.tripadvisor.tripadvisor_49.5.apk \u003c-- 49.3|28744498|28695346|\n|26|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.twitter.android.png\" width=\"36\"\u003e|com.twitter.android_9.61.0.apk \u003c-- 9.58.2|36141840|35575484|\n|27|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.ubercab.png\" width=\"36\"\u003e|com.ubercab_4.442.10002.apk \u003c-- 4.439.10002|69923232|64284150|\n|28|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.ximalaya.ting.android.png\" width=\"36\"\u003e|com.ximalaya.ting.android_9.0.66.3.apk \u003c-- 9.0.62.3|115804845|113564876|\n|29|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.xunmeng.pinduoduo.png\" width=\"36\"\u003e|com.xunmeng.pinduoduo_6.30.0.apk \u003c-- 6.29.1|30896833|30951567|\n|30|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/com.youdao.dict.png\" width=\"36\"\u003e|com.youdao.dict_9.2.29.apk \u003c-- 9.2.28|110624682|110628778|\n|31|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/org.mozilla.firefox.png\" width=\"36\"\u003e|org.mozilla.firefox_105.2.0.apk \u003c-- 105.1.0|83078464|83086656|\n|32|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/img/tv.danmaku.bili.png\" width=\"36\"\u003e|tv.danmaku.bili_7.1.0.apk \u003c-- 7.0.0|104774723|104727005|\n\n# 测试条件\n在一台笔记本PC上对比测试：Windows11, CPU R9-7945HX, SSD PCIe4.0x4 4T, DDR5 5200MHz 32Gx2   \npatch时标注tmpf表示使用了临时文件来储存中间数据；mem表示在内存中执行不使用临时文件；limit表示使用限制内存占用的模式执行；而标注MT表示开启了多线程(8个)并行。   \n**BsDiff** v4.3 还是保持着使用bzip2算法压缩补丁。   \n**xdelta** v3.1.0 使用`-e -n -f -s`来创建补丁, 而用`-d -f -s`参数来执行的patch。    \n**HDiffPatch** v4.6.3 支持2种diff模式，`-s-16`和`-m-1 -cache -block`模式分别测试，输出补丁时分别测试了用lzma2、zstd压缩的测试。HDiffPatch支持输出兼容bsdiff的补丁(bzip2压缩)，补充了`-BSD -m-1 -cache -block`参数后的测试结果。   \n**archive-patcher** v1.0 一般使用gzip或brotli算法压缩补丁，这里为了diff速度并更好的和其他方案对比补丁大小，diff时输出不压缩的补丁，然后再额外使用lzma2压缩补丁。 需要注意：这时收集到的diff数据不包含额外压缩时的时间和内存消耗，收集到的patch数据也**不包含**解压的时间和内存消耗等。   \n**ApkDiffPatch** v1.6.0 使用了lzma2来压缩输出的补丁。   \n**sfpatcher** v1.1.1 支持多个级别的diff，-1,-2和-3分别测试； sfpatcher支持不需要旧版本apk而直接重新压缩新版本apk的模式(标记为pre)；sfpatcher支持多种可选压缩输出，这里测试了-c-zstd-21和-c-lzma2-9这2种。   \nsfpatcher补充测试了用ApkNormalized(ApkDiffPatch方案)处理过的apk文件，分别进行增量测试和lzma2重压缩测试(标记为Norm)。   \nsfpatcher v1.3.0 新增了专用的标准化处理流程$sf_normalize -cl-A和-cl-4, 对测试apk进行标准化并重新签名后，分别进行增量测试和zstd重压缩测试(标记为clA和cl4，重压缩标记为pre)。   \n   \n另外在一部安卓手机(CPU:Kirin980 2×A76 2.6G + 2×A76 1.92G + 4×A55 1.8G)上对hpatchz\u0026sfpatcher进行了一些patch时间测试，补充到了最后一列。   \n\n# 测试结果   \n其中：平均压缩率=(补丁大小/新apk大小)的平均值； 单次测试的内存占用统计值为峰值私有内存；\n\n|diff方案|平均压缩率|平均内存|平均速度|patch|平均内存|最大内存|平均速度|arm Kirin980|\n|:----|----:|----:|----:|----|----:|----:|----:|----:|\n|zstd --patch-from|53.18%|2199M|3.6MB/s|mem|209M|596M|609MB/s|\n|**xdelta3**|**54.51%**|422M|3.8MB/s|mem|**98M**|**99M**|**170MB/s**|\n|**bsdiff**|**53.84%**|931M|1.2MB/s|mem|**218M**|**605M**|**54MB/s**|\n|hdiffz|54.40%|509M|8.8MB/s|mem|5M|6M|682MB/s|443MB/s|\n|hdiffz lzma2|52.93%|525M|4.1MB/s|mem|21M|22M|260MB/s|131MB/s|\n|**hdiffz zstd**|**53.04%**|537M|5.4MB/s|mem|**21M**|**22M**|**598MB/s**|371MB/s|\n|hdiffz -s zstd|53.44%|221M|10.1MB/s|mem|20M|22M|620MB/s|\n|**archive-patcher**|**31.65%**|1448M|0.9MB/s|temf|**558M**|**587M**|**14MB/s**|\n|ApkDiffPatch|18.44%|1003M|2.2MB/s|mem|164M|453M|20MB/s|\n|ApkDiffPatch|18.44%|1003M|2.2MB/s|memMT|257M|628M|64MB/s|\n|ApkDiffPatch|18.44%|1003M|2.2MB/s|tmpf|21M|25M|17MB/s|\n|ApkDiffPatch|18.44%|1003M|2.2MB/s|tmpfMT|101M|211M|46MB/s|\n|sfpatcher-3 Norm|18.35%|1147M|2.2MB/s|limit|43M|59M|21MB/s|\n|**sfpatcher-3**|**18.35%**|1147M|2.2MB/s|limitMT|**49M**|**65M**|**77MB/s**|\n|sfpatcher-3 Norm|18.35%|1147M|2.2MB/s|memMT|170M|452M|99MB/s|\n|sfpatcher-3pre Norm|64.91%|610M|1.7MB/s|mem|37M|41M|14MB/s|\n|**sfpatcher-3pre**|**64.91%**|610M|1.7MB/s|memMT|**42M**|**46M**|**64MB/s**|\n||\n|sfpatcher-1 zstd|31.08%|818M|2.3MB/s|limit|15M|19M|201MB/s|92MB/s|\n|**sfpatcher-1 zstd**|**31.07%**|1025M|4.6MB/s|limitMT|**18M**|**25M**|**424MB/s**|189MB/s|\n|sfpatcher-1 lzma2|29.75%|819M|2.3MB/s|limit|14M|19M|104MB/s|50MB/s|\n|sfpatcher-1 lzma2|29.75%|809M|5.3MB/s|limitMT|17M|24M|167MB/s|74MB/s|\n|sfpatcher-2 zstd|26.27%|975M|2.1MB/s|limit|15M|20M|43MB/s|\n|sfpatcher-2 zstd|26.29%|1002M|4.7MB/s|limitMT|20M|27M|155MB/s|\n|sfpatcher-2 lzma2|24.11%|976M|2.1MB/s|limit|15M|20M|37MB/s|19MB/s|\n|**sfpatcher-2 lzma2**|**24.15%**|968M|5.0MB/s|limitMT|**20M**|**26M**|**108MB/s**|45MB/s|\n|sfpatcher-3 lzma2|23.53%|997M|2.0MB/s|limit|16M|20M|31MB/s|17MB/s|\n|sfpatcher-3 lzma2|23.56%|987M|4.5MB/s|limitMT|21M|26M|98MB/s|40MB/s|\n|sfpatcher-2pre zstd|81.36%|376M|2.8MB/s|mem|19M|23M|37MB/s|\n|sfpatcher-2pre zstd|81.36%|1646M|7.1MB/s|memMT|24M|30M|193MB/s|\n|sfpatcher-3pre zstd|79.20%|387M|2.4MB/s|mem|20M|23M|29MB/s|\n|sfpatcher-3pre zstd|79.20%|1698M|6.5MB/s|memMT|25M|30M|144MB/s|\n|sfpatcher-2pre lzma2|75.23%|378M|1.9MB/s|mem|20M|23M|24MB/s|12MB/s|\n|**sfpatcher-2pre lzma2**|**75.42%**|1091M|8.3MB/s|memMT|**24M**|**28M**|**63MB/s**|26MB/s|\n|sfpatcher-3pre lzma2|73.34%|386M|1.7MB/s|mem|20M|23M|21MB/s|11MB/s|\n|sfpatcher-3pre lzma2|73.53%|1126M|8.1MB/s|memMT|25M|29M|60MB/s|24MB/s|\n||\n|sfpatcher-2 cl4 zstd|21.72%|1141M|2.3MB/s|memMT|19M|24M|38MB/s|\n|**sfpatcher-2 cl4 zstd**|**21.74%**|1158M|5.2MB/s|mem|**25M**|**30M**|**123MB/s**|\n|sfpatcher-3pre cl4 zstd|74.30%|451M|1.9MB/s|memMT|21M|26M|29MB/s|\n|**sfpatcher-3pre cl4 zstd**|**74.29%**|1990M|5.5MB/s|mem|**28M**|**33M**|**155MB/s**|\n|sfpatcher-1 clA zstd|21.72%|1141M|2.5MB/s|memMT|19M|22M|85MB/s|63MB/s|\n|**sfpatcher-1 clA zstd**|**21.74%**|1156M|5.4MB/s|mem|**26M**|**29M**|**240MB/s**|129MB/s|\n|sfpatcher-3pre clA zstd|74.30%|450M|2.1MB/s|memMT|20M|22M|61MB/s|46MB/s|\n|**sfpatcher-3pre clA zstd**|**74.30%**|1991M|5.8MB/s|mem|**28M**|**32M**|**264MB/s**|129MB/s|\n   \n\n# 游戏测试用例\n最近收集了32组游戏测试用例，这些apk下载于小米应用商店、TapTap商店、谷歌Play商店，按照下载量大和最近进行过更新为标准进行收集。   \n对比测试了 xdelta、bsdiff、HDiffPatch、sfpatcher； 因为有大游戏所以放弃了无法完成测试的archive-patcher。   \n**sfpatcher** v1.1.1 测试时，调整了部分参数，相比前面的测试增大了patch时的内存需求。   \n旧版本apk平均大小1029.5MB，新版本apk平均大小1040.9MB。   \n\n| 编号|app|新apk \u003c-- 旧apk|新apk大小|旧apk大小|\n|----:|:---:|:----|----:|----:|\n|1|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.blizzard.wtcg.hearthstone.png\" width=\"36\"\u003e|com.blizzard.wtcg.hearthstone_24.4.150659.apk \u003c-- 24.2.148211 |119192491|118798993|\n|2|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.hypergryph.arknights.png\" width=\"36\"\u003e|com.hypergryph.arknights_1.9.21.apk \u003c-- 1.9.01|1577358049|1530216284|\n|3|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.igg.android.lordsmobile.png\" width=\"36\"\u003e|com.igg.android.lordsmobile_2.88.apk \u003c-- 2.86|69151111|68970887|\n|4|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.imangi.templerun2.png\" width=\"36\"\u003e|com.imangi.templerun2_6.5.1.apk \u003c-- 6.5.0|142692127|141981473|\n|5|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.joym.legendhero.mi.png\" width=\"36\"\u003e|com.joym.legendhero.mi_6.0.0.apk \u003c-- 5.0.0|857787066|801198664|\n|6|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.kiloo.subwaysurf.png\" width=\"36\"\u003e|com.kiloo.subwaysurf_3.36.1.apk \u003c-- 3.36.0|172657047|172348585|\n|7|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.king.candycrushsaga.png\" width=\"36\"\u003e|com.king.candycrushsaga_1.237.0.3.apk \u003c-- 1.236.0.3 |89619604|89410785|\n|8|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.knight.union.mi.png\" width=\"36\"\u003e|com.knight.union.mi_4.3.1.apk \u003c-- 4.3.0 |281337183|279734645|\n|9|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.mfp.jelly.xiaomi.png\" width=\"36\"\u003e|com.mfp.jelly.xiaomi_8.20.0.6.apk \u003c-- 8.19.5.2 |454515054|444262109|\n|10|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.miHoYo.enterprise.NGHSoD.png\" width=\"36\"\u003e|com.miHoYo.enterprise.NGHSoD_6.1.0.apk \u003c-- 6.0.0 |633463833|617956855|\n|11|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.miHoYo.Yuanshen.png\" width=\"36\"\u003e|com.miHoYo.Yuanshen_3.1.0.apk \u003c-- 3.0.0 |292959792|281028246|\n|12|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.netease.dwrg.mi.png\" width=\"36\"\u003e|com.netease.dwrg.mi_1.5.69.apk \u003c-- 1.5.67 |2087354104|2083304114|\n|13|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.netease.g104.mi.png\" width=\"36\"\u003e|com.netease.g104.mi_3.18.1.apk \u003c-- 3.17.5 |1900704615|1853407883|\n|14|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.netease.g67.mi.png\" width=\"36\"\u003e|com.netease.g67.mi_1.6.0.apk \u003c-- 1.5.4 |2021330101|2016955181|\n|15|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.netease.harrypotter.png\" width=\"36\"\u003e|com.netease.harrypotter_1.20.212190.apk \u003c-- 1.20.211260 |2146351076|1976476298|\n|16|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.netease.l10.mi.png\" width=\"36\"\u003e|com.netease.l10.mi_1.11.5.apk \u003c-- 1.11.4 |1897664156|1835964179|\n|17|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.netease.mc.mi.png\" width=\"36\"\u003e|com.netease.mc.mi_2.3.15.apk \u003c-- 2.3.5 |986369238|982878980|\n|18|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.netease.onmyoji.png\" width=\"36\"\u003e|com.netease.onmyoji_1.7.48.apk \u003c-- 1.7.47 |2037653577|2029429678|\n|19|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.netease.sky.png\" width=\"36\"\u003e|com.netease.sky_0.10.0.apk \u003c-- 0.9.9 |1320667004|1188304200|\n|20|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.nianticlabs.pokemongo.png\" width=\"36\"\u003e|com.nianticlabs.pokemongo_0.251.0.apk \u003c-- 0.249.2 |51919509|51538569|\n|21|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.outfit7.mytalkingtom2.mi.png\" width=\"36\"\u003e|com.outfit7.mytalkingtom2.mi_3.5.0.514.apk \u003c-- 3.4.0.496 |151118938|152738799|\n|22|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.papegames.nn4.cn.png\" width=\"36\"\u003e|com.papegames.nn4.cn_2.1.1147531.apk \u003c-- 2.1.1094661 |1804200058|1911303194|\n|23|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.rovio.baba.dbzq.m.png\" width=\"36\"\u003e|com.rovio.baba.dbzq.m_3.6.0.apk \u003c-- 3.2.1 |285160536|298220983|\n|24|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.tencent.ig.png\" width=\"36\"\u003e|com.tencent.ig_2.2.0.apk \u003c-- 2.1.0 |1123848712|1161724820|\n|25|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.tencent.lolm.png\" width=\"36\"\u003e|com.tencent.lolm_3.5.0.6093.apk \u003c-- 3.4.0.5935 |1743471226|1956378264|\n|26|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.tencent.tmgp.cf.png\" width=\"36\"\u003e|com.tencent.tmgp.cf_1.0.280.apk \u003c-- 1.0.260 |2089132074|1998168460|\n|27|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.tencent.tmgp.cod.png\" width=\"36\"\u003e|com.tencent.tmgp.cod_1.9.35.apk \u003c-- 1.9.34 |2102131414|2109943466|\n|28|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.tencent.tmgp.sgame.png\" width=\"36\"\u003e|com.tencent.tmgp.sgame_3.81.1.8.apk \u003c-- 3.74.1.6 |1960032646|1976668388|\n|29|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.tencent.tmgp.speedmobile.png\" width=\"36\"\u003e|com.tencent.tmgp.speedmobile_1.33.0.apk \u003c-- 1.32.0 |2122819058|2096029603|\n|30|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.ustwo.monumentvalleyzz.png\" width=\"36\"\u003e|com.ustwo.monumentvalleyzz_2.5.2.apk \u003c-- 2.5.1 |159780651|160263061|\n|31|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.wooduan.ssjj.mi.png\" width=\"36\"\u003e|com.wooduan.ssjj.mi_6.9.2.apk \u003c-- 6.8.1 |1588557473|1534719411|\n|32|\u003cimg src=\"https://github.com/sisong/sfpatcher/raw/master/gimg/com.yodo1.tew.mi.png\" width=\"36\"\u003e|com.yodo1.tew.mi_2.10.6.297.apk \u003c-- 2.9.5.286 |655222738|622939950|\n   \n\n# 游戏测试结果   \n\n|diff方案|平均压缩率|平均内存|平均速度|patch|平均内存|最大内存|平均速度|最差速度|\n|:----|----:|----:|----:|----|----:|----:|----:|----:|\n|zstd|36.35%|5297MB|3.2MB/s|mem|2088MB|4033MB|852MB/s|576MB/s|\n|**xdelta3 lzma**|**54.14%**|423MB|3.5MB/s|mem|**99MB**|**104MB**|**94MB/s**|**30MB/s**|\n|xdelta3 lzma +hpatchz -m|54.14%|423MB|3.5MB/s|mem|79MB|83MB|258MB/s|84MB/s|\n|**bsdiff**|**36.15%**|9284MB|1.1MB/s|mem|**2085MB**|**4042MB**|**89MB/s**|**32MB/s**|\n|bsdiff +hpatchz -m|36.15%|9284MB|1.1MB/s|mem|1045MB|2029MB|95MB/s|33MB/s|\n|bsdiff +hpatchz -s|36.15%|9284MB|1.1MB/s|mem|14MB|14MB|87MB/s|32MB/s|\n|hdiffz p1 zstd|35.41%|3812MB|6.3MB/s|mem|23MB|23MB|712MB/s|291MB/s|\n|**hdiffz p8 zstd**|**35.42%**|4249MB|25.3MB/s|mem|**22MB**|**23MB**|**703MB/s**|**284MB/s**|\n|hdiffz p1 lzma2|35.26%|3813MB|5.3MB/s|mem|22MB|23MB|344MB/s|136MB/s|\n|hdiffz p8 lzma2|35.28%|3842MB|29.9MB/s|mem|22MB|23MB|344MB/s|135MB/s|\n|sfpatcher-1 zstd|22.23%|4491MB|5.4MB/s|limit|23MB|35MB|412MB/s|152MB/s|\n|**sfpatcher-1 zstd**|**22.20%**|4684MB|15.5MB/s|limitMT|**26MB**|**38MB**|**634MB/s**|**308MB/s**|\n|sfpatcher-2 lzma2|19.61%|5162MB|4.9MB/s|limit|26MB|47MB|101MB/s|13MB/s|\n|**sfpatcher-2 lzma2**|**19.62%**|5121MB|16.8MB/s|limitMT|**32MB**|**54MB**|**249MB/s**|**44MB/s**|\n|sfpatcher-3 lzma2|17.87%|5682MB|4.6MB/s|limit|32MB|47MB|49MB/s|6MB/s|\n|sfpatcher-3 lzma2|17.91%|5631MB|15.6MB/s|limitMT|39MB|54MB|157MB/s|26MB/s|\n   \n\n# sfpatcher的大规模测试\n收集了Top500中多个app应用(不含游戏)和其多个历史版本，形成了4695个测试用例，进行了diff和patch多种参数测试并分别使用了lzma2压缩和zstd压缩输出补丁。   \n测试条件：v1.0.15 用了-lp-2m加8m压缩字典 -pre时用的16m压缩字典   \n\n| 方案|平均压缩率|\n|:----|----:|\n|hdiffz lzma2|50.8%|\n|sfpatcher -1 lzma2|31.5%|\n|sfpatcher -2 lzma2|29.3%|\n|sfpatcher -3 lzma2|26.7%|\n|sfpatcher -2 pre lzma2|81.9%|\n|sfpatcher -3 pre lzma2|76.6%|\n||\n|hdiffz zstd|50.9%|\n|sfpatcher -1 zstd|32.6%|\n|sfpatcher -2 zstd|30.7%|\n|sfpatcher -3 zstd|28.3%|\n|sfpatcher -2 pre zstd|86.3%|\n|sfpatcher -3 pre zstd|82.3%|\n\n# 节省CDN带宽费用估算(仅供参考)\n单个apk一次升级节省的流量估算：用户的安卓手机现在经常使用的应用apk一般都越来越大(游戏平均更大)，假设按平均100MB算。   \n一般bsdiff或HDiffPatch创建的补丁平均为原apk大小的50%--60%（按51%计算）；sfpatcher按-o-1算，创建的补丁为平均原apk大小的33%。   \n那sfpatcher相比bsdiff或HDiffPatch方案单次继续节省 100x(51%-33%) = 18MB  (游戏apk平均节省会成倍数增加)  \n假设apk商店每天有1亿次apk升级，按峰值带宽计费，假设单价每天0.48元/Mbps; 而按经验，峰值带宽一般是平均带宽的2倍：   \n每月节省费用：100000000x(18x1024x1024x8/1000/1000)/(3600x24)x2x0.48*30 = 503.3万元   \n如果按流量计费，假设单价0.11元/GB：   \n每月节省费用：100000000x(18/1024)x0.11x30 = 580.1万元   \n   \n---\n需要商业授权，请联系作者： \u003chousisong@hotmail.com\u003e   \n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsisong%2Fsfpatcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsisong%2Fsfpatcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsisong%2Fsfpatcher/lists"}