首页/ 推广杂谈/ 脚本改了一行还要整包重发吗?覆盖安装、增量更新、重新打包怎么选

脚本改了一行还要整包重发吗?覆盖安装、增量更新、重新打包怎么选

发布于 更新于 浏览 12 作者:帧码科技 脚本迭代分发exe覆盖安装增量更新版本号管理智包大师 A+ A-

一句话结论 只改配置就换配置文件;改了代码才重新打包,人少走覆盖安装,几百人以上再上增量更新。

把接口地址从测试环境换成正式环境,脚本里其实只动了一行。有人按老办法重新跑了一遍打包,把 200 多 MB 的 exe 发到 20 个人的群里,接下来两天都在收反馈:一位同事双击安装包,界面上还显示着上周的旧版本号;另一位装完发现自己填了半天的账号和导出路径全被清回默认;还有人问是不是得先把旧版卸载掉再装,怕两个版本打架。一行代码的改动,变成一轮全员客服。这类返工不发生在写代码那一步,都发生在把新版本送到已装用户手上这一步。

打包和分发是两件事。打包决定 exe 里装了什么,分发决定用户端要做什么动作、旧数据留不留、装坏了能不能退回去。把重新打包、覆盖安装、增量更新混成一个词,就会在改配置时也去重打整包,或在只有 20 个用户时去搭一套自动更新服务。先按改了什么分档,再选分发方式,比事后一条条回消息省事得多。下面这张表把常见改动归成四档。

一、判断标准:先分清改了什么,再定要不要重出包

分档的依据只有一个:可执行文件里的内容有没有变。配置、参数、开关这类改动,只要程序是启动时读外部文件,exe 本身一个字节都不用动;动了代码、改了依赖、换了图标,产物就得重新出。用户规模决定的是用什么方式送到,不是要不要重打。这两件事弄清楚,能省掉一半无效打包。

改动类型exe 是否变分发方式用户端动作适合规模
配置、参数(接口地址、超时、开关)不变只发一个配置文件覆盖 ini 或 json 后重启任意
代码小改(修 bug、改文案、调逻辑)变重新打包加覆盖安装双击安装包一路下一步几十人以内
依赖或引擎变化、大版本变整包重出并附环境说明覆盖安装,必要时先卸载几十人以内
高频迭代且包体大、用户多变差分增量补丁客户端自动下载替换几百人以上

表里这套分法是软件分发的通行做法,跟用哪款打包工具没关系,PyInstaller、Nuitka 打出来的产物都适用。真正容易漏的是三件与工具无关的事:版本号有没有递增,用户改过的配置会不会被新包覆盖,新包装坏了能不能退回上一版。这三件没定,包打得再快也要返工。见过最费劲的一次,是版本号一直停在 1.0.0,连发三版用户都分不清自己装的是哪一版,报障时只能靠截图里的界面文案猜。

定方式之前,先记三个数

第一个数是用户数量。20 人以内的内部工具,整包覆盖安装完全够用;几百人以上再考虑增量。第二个数是包体大小,单文件 exe 每次启动都要把内容解压到临时目录,包越大用户等得越久,具体量法可以看《打包 exe 几百 MB 还启动慢?先量解压耗时,再砍依赖体积》那篇。第三个数是发版频率,一两个月一次和每周一次,是两套完全不同的流程。三个数记下来,第四档该不该做基本就有答案了。

  • 20 人以内、包 100 MB 以下、一两个月发一次:整包覆盖安装,别搭更新服务

  • 只改配置:发一个 ini 或 json,连包都不用重打

  • 几百人以上、包过 100 MB、每周发版:才值得做差分补丁和版本检测

  • 版本号没递增、配置写在安装目录里:先修这两处,再谈分发方式

二、工具落点:智包大师接住重新出包这一段

一旦确认动的是代码或依赖,就得重新出包,这一段最怕两件事:漏了新加的依赖,以及版本号忘了同步。智包大师把这段体力活收进了一个界面里,它是 Windows 桌面软件,只跑 Win10/11 64 位,下载在 zhibao.hl22.com。

与迭代分发直接相关的几项能力都是能点到的:AST 扫源码找依赖,动态导入也能揪出来,改了几行代码不用手工补隐藏导入;打包前出一份体检报告,依赖和路径先看一遍;Nuitka 和 PyInstaller 双引擎在同一个工程里切换,常规改逻辑沿用上次的引擎即可;版本号、管理员权限在表单里填,图标拖进界面;内置 Inno Setup 能直接生成带快捷方式的安装包,覆盖安装正好用得上;打包失败时有本地 AI 看日志,代码不出本机。官网没有公布价格,别按别处的数字算,去官网查。

边界也要说清楚。智包大师负责把新版本重新打成 exe 或安装包,版本号靠打包的人在表单里手动加一;远程版本检测、差分补丁生成、客户端自动升级这三件事,产品不自带,要自己搭或另选更新框架。把这条界线画明白,才不会以为点一下打包就能让已装用户自动升到新版。首次把脚本交付给别人时遇到的打不开、依赖漏是另一类问题,《Python 脚本发给同事打不开?一键打包 exe 与安装包实操》和《智包大师,一个简单易用的python打包工具》里写过完整流程,本篇只谈交付之后怎么迭代。

三、一次版本升级的完整流程

  1. 改动归类:确认这次动的是代码还是只有配置。只改配置直接跳到第 7 步发文件,不重打包,这是最常被多做的一步。

  2. 版本号加一:在智包大师的表单里把 1.2.0 改成 1.2.1,同时写一行变更说明。用户报障时能问出版本号,排查时间能省一半。

  3. 配置外置自查:确认用户填过的账号、导出路径、接口地址存在安装目录之外。写进安装目录的配置,会在覆盖安装时被新包里的同名默认文件替换成初始值,这是装完配置丢了最常见的原因。

  4. 打包前体检:跑一次体检报告,看新增依赖和动态导入有没有被扫到。在这一步发现问题,比让用户装完再远程排障便宜得多,《Python 脚本打包成 exe 后双击闪退?缺依赖、路径、运行库三步定位》里那三步就是漏依赖之后的补救。

  5. 选引擎重新打包:常规改逻辑沿用上次的引擎;依赖变了或包体明显涨了,再回看《Nuitka和PyInstaller怎么选?Python打包工具对比与组合用法》里的取舍。排障期先在表单里保留控制台窗口,跑通了再改回无窗口。

  6. 出安装包并灰度:用内置 Inno Setup 生成安装包,先给两三个人装,重点看两件事:界面显示的版本号是不是新的、上次填的配置还在不在。确认没问题再全量发。

  7. 留旧包和回滚说明:上一版安装包别删,把新包不正常就装回 1.2.0 写进发布说明,发布当天顺手把旧包和变更说明放进同一个文件夹。

这套流程有硬边界。目标机得是 Win10/11 64 位;含 PyTorch、OpenCV 这类大库时更建议走 PyInstaller,个别第三方库在 Nuitka 下要单独处理;单文件 exe 每次冷启动都要解压,包越大等待越久。这些是产品和打包工具的公开限制,流程绕不过去,只能靠分档分发把影响面缩小。

覆盖安装为什么还会把配置弄丢

Inno Setup 靠 AppId 判断新包和旧版是不是同一个程序,AppId 一致就装回原目录并替换同名文件。用户自己后来新增的文件不会被删,但程序若把配置写在安装目录里,而新包里恰好也带了一份同名的默认配置,覆盖安装就会把它还原成初始值。稳妥做法是把配置放到 %APPDATA% 或用户目录下,安装包里根本不带这个文件。改完这一处,前两天的第二类反馈基本就消失了。至于要不要先卸载旧版,同一个 AppId 的覆盖安装不需要卸载,除非新旧版换过安装目录结构。

四、什么规模才值得做增量更新

差分更新只传两个 exe 之间的差,200 MB 的包改一行代码,补丁可能只有 1 到 2 MB。它要自己搭三样东西:一个放当前版本号和补丁地址的服务器、一段校验补丁完整性的逻辑、一个在主程序退出之后才替换文件的独立更新器。Windows 上正在运行的 exe 被占用,没法直接覆盖,主程序得先退出,交给更新器替换完再重启。这三样对小团队是实打实的维护量,人少的时候远超重发一次整包。

  • 值得做:用户几百人以上、包体过 100 MB、每周都发版、用户网络条件差

  • 不必做:20 人以内的内部工具、配置改动为主、一两个月才发一次

  • 折中做法:启动时查一次远程版本号,发现新版本只弹提示、让用户手动下载安装包,比上差分简单得多

  • 发布侧常规配置:给安装包做代码签名,能减少杀软误报和安装时的身份提示

还有一层取舍是包体与频率的互换。包做到几十 MB,整包重发对用户几乎无感,没必要上差分;包卡在几百 MB 又每周发,才轮到增量更新划算。判断别只看技术上行不行,把维护更新器、处理补丁失败回滚的人力算进去,很多团队选的是折中那一档。这些版本检测、差分包、灰度发布的做法属于发布工程的通用实践,不是任何一款打包工具的内置功能,选用哪款工具都得自己补齐。

五、下一步

先拿自己一个脚本把链跑通:改一行配置,只发配置文件;再改一行代码,版本号加一后重新打包、生成安装包、覆盖安装一次,确认旧配置还在。两遍走完,再决定要不要给用户搭自动更新。智包大师在 zhibao.hl22.com 下载,官网有打包流程说明;想补首次交付、闪退排查、体积与版本选型的具体做法,可以看《Python 脚本发给同事打不开?一键打包 exe 与安装包实操》、《Python 脚本打包成 exe 后双击闪退?缺依赖、路径、运行库三步定位》、《打包 exe 几百 MB 还启动慢?先量解压耗时,再砍依赖体积》、《Python 打包用 3.8 还是 3.12?按目标电脑和依赖定版本,别默认装最新》、《Python 打包工具怎么选?智包大师把脚本一键打包成 exe》、《Nuitka和PyInstaller怎么选?Python打包工具对比与组合用法》和《智包大师,一个简单易用的python打包工具》。

支 支付宝支付
支付宝收款码

如果这篇文章对你有帮助,欢迎打赏支持一下~

分享给朋友:
配套工具

智包大师,一个简单易用的python打包工具

智包大师想把 Python 打包的体力活全包了。写好的脚本发给同事,对方根本打不开。手动敲命令打包又太折腾:参数难记、依赖总…

评论留言(0)

微信
💬 扫码添加微信客服
微信二维码
微信号:dsyldsb
9:00 - 22:00
QQ
↑ 顶部