版本更新推一个 2 GB 的整包,玩家在更新条前劝退一半——增量更新只下发变化的部分,常规版本的差分包控制在 50 MB 内,更新的门槛降到拇指一次的点击。差分包的生成与应用是更新体验的分水岭。
---逐文件差分:变更清单驱动
function DiffPack.build(oldDir, newDir, outDir)
local manifest = {}
for _, f in ipairs(Scan.files(newDir)) do
local oldHash = Manifest.hashOf(oldDir, f)
local newHash = Manifest.hashOf(newDir, f)
if oldHash ~= newHash then
local rel = f
if oldHash then
-- 老文件存在:做二进制差分
Bsdiff.make(oldDir .. "/" .. rel,
newDir .. "/" .. rel,
outDir .. "/" .. rel .. ".patch")
else
-- 新增文件:整份进包
Copy.file(newDir .. "/" .. rel,
outDir .. "/" .. rel)
end
manifest[#manifest + 1] = {
path = rel, kind = oldHash and "patch" or "new",
hash = newHash,
}
end
end
Manifest.write(outDir .. "/manifest.json", manifest)
return manifest
end
差分的粒度到单文件:新旧目录逐文件比对哈希,变更的文件做二进制差分(改动的字节块才进包),新增的文件整份入包,删除的文件记进清单由客户端本地清理。裁决之杖的新贴图改了 8 KB,差分补丁就只有 8 KB——资源按文件组织的世界里,一个版本动千分之一的文件,包体就是千分之一。清单带每个文件的哈希,应用后的完整性可逐文件验证。
---客户端应用差分包
function DiffPack.apply(packDir)
local manifest = Manifest.read(packDir .. "/manifest.json")
-- 前置校验:本地基线必须匹配
for _, m in ipairs(manifest) do
if m.kind == "patch" then
local localHash = Manifest.hashOf(Res.root, m.path)
if localHash ~= m.expectOld then
return false, "基线不符,请走整包"
end
end
end
for _, m in ipairs(manifest) do
if m.kind == "patch" then
Bspatch.apply(Res.root .. "/" .. m.path,
packDir .. "/" .. m.path .. ".patch")
else
Copy.file(packDir .. "/" .. m.path,
Res.root .. "/" .. m.path)
end
end
return Res.verify(manifest)
end
应用前的基线校验是命门:补丁按特定的旧版本生成,玩家的本地文件若不是预期旧版(跳版本更新的玩家),打上补丁就是损坏,基线不符的降级走整包下载。应用按清单逐文件执行,全部完成后整包哈希校验,任何一步失败回滚到更新前——回滚的保障是更新前对本地位图的快照。断点续传与差分包的组合:50 MB 的差分包中途断网,重连从断点继续,更新的鲁棒性在弱网玩家身上兑现。
差分包的体积与整包的比值监控,比值异常升高提示资源管理失控;应用失败率的分版本统计,某版本的失败率突增即基线错配。
基线校验曾经漏做,跳版本玩家的资源损坏成灾难,前置校验加降级整包的双保险修复。差分曾经按整文件复制,差分包与整包一样大,二进制差分算法的引入让包体缩到一成以内。清单的哈希曾经用了弱算法,碰撞让两个不同文件过了校验,哈希升级到强算法。
差分包的体积预算写进发布标准:常规版本不超过整包的 5%。基线的版本链管理清晰:v1 到 v3 的跨版本差分自动串接或降级整包。更新的进度条按文件粒度呈现,玩家的等待有刻度。
本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。
全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
实战应用:用在哪里 沙巴克占领行会坐收税收却只进不出,非占领行会的玩家心里不平衡。税务官玩法把税收做成明账:占领行会对摆摊与…
实战应用:用在哪里 高端玩家婚姻系统只有仪式没有过程,社交绑定缺一个高光事件。比武招亲做成擂台玩法:擂主设擂摆彩头,攻擂者报…
实战应用:用在哪里 开服七日限时礼包发到第六天断了粮,9 月 1 日当天领奖按钮灰的,投诉当天破千。事故根因是一条数字日期循…
实战应用:用在哪里 玩家拔线不退游戏,连接半开着,人不在指令也没有,在线数虚高,容量预案被假数据带着跑。心跳探测给每个在线玩…
实战应用:用在哪里 周三发了合成系统补丁,周四又改强化概率,两条变更叠加后玩家分不清是哪个改出来的。发布日历把全月变更集中排…
实战应用:用在哪里 容量预案需要知道滚动一小时的副本进入峰值,而不是全天累计。滑动窗口用 60 个槽位每槽记一分钟的进入数,…