版本更新推一个 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 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
实战应用:用在哪里 猪洞七层的白野猪是中级玩家的过渡首领,巡回触发让它在三层地图间按路线巡逻,而非固定在一个点位被反复蹲守。…
实战应用:用在哪里 行会活动零散且缺乏组织性,成员不知道这周行会要做什么。行会目标系统让帮主每周设定行会集体目标(击杀指定首…
实战应用:用在哪里 GM 操作的审计曾散落在各系统日志里,追查一次误操作需要跨三个日志文件。GM 审计台将所有 GM 操作集…
实战应用:用在哪里 背包一百格塞满后找一件药要翻三页。背包筛选器在背包面板顶部加一排筛选标签:按品质(白绿紫橙)与类型(药品…
实战应用:用在哪里 行会广播、地图公告、活动提醒需要发给特定地图的所有玩家,逐个发送时包量随人数线性增长。区域组播按地图分组…
实战应用:用在哪里 凌晨三点的数据库主从延迟和下午三点的聊天频道延迟,影响的范围和紧急度截然不同,但响应流程曾一模一样。故障…