文件增量更新器

本次以CoronaLauncher_Setup_3.11.9123.42797.exe和CoronaLauncher_Setup_3.12.9269.19502.exe的解包文件作为示例参考

• 一些名词和参数说明:
• [存放服务器不同版本的文件](\server\ori)
• [老版本](\server\ori\CoronaLauncher_Setup_3.11.9123.42797)
• [新版本](\server\ori\CoronaLauncher_Setup_3.12.9269.19502)
• [patch包存放](\server\patch)
• 客户端patch更新工具
• 服务器patch生成工具
• xml页面文件生成
• patch页面文件生成

先给需要包含增量的版本生成对应xml文件标志,并将最新xml文件挂载在静态页面。

注意任何非第一次的xml都需要使用上一个版本的xml作为依赖,否则会出现不认旧文件,进而无法自动生成patch的问题,具体示例如下

Ra3.BattleNet.Updater.XmlGenerator.exe --target-dir .\server\ori\CoronaLauncher_Setup_3.11.9123.42797\ --new-xmloutputpath .\server\ori\CoronaLauncher_Setup_3.11.9123.42797.xml
Ra3.BattleNet.Updater.XmlGenerator.exe --old-xmlpath .\server\ori\CoronaLauncher_Setup_3.12.9269.19502.xml --target-dir .\server\ori\CoronaLauncher_Setup_3.11.9123.42797\ --new-xmloutputpath .\server\ori\CoronaLauncher_Setup_3.11.9123.42797.xml
cp .\server\ori\CoronaLauncher_Setup_3.12.9269.19502.xml /var/www/html/manifest.xml

此时的目录结构

然后需要手动在代码上初次创立sql文件

随后需要给需要的版本直接打增量更新,注意命令执行顺序,软件会将相关文件与hash保存在sql数据库中,并维护成单文件版本链。始终是旧版本先执行,新版本最后执行。最后再将patch的特征信息文件patches.json部署在静态页面上

Ra3.BattleNet.Updater.Server.PatchIndexGenerator.exe --manifest .\server\ori\CoronaLauncher_Setup_3.11.9123.42797.xml --manifest-root .\server\ori\CoronaLauncher_Setup_3.11.9123.42797 --output .\server\patch\
Ra3.BattleNet.Updater.Server.PatchIndexGenerator.exe --manifest .\server\ori\CoronaLauncher_Setup_3.12.9269.19502.xml --manifest-root .\server\ori\CoronaLauncher_Setup_3.12.9269.19502 --output .\server\patch\
mv .\server\patch\patches.json /var/www/html/patches.json

• https://github.com/RA3BattleNet/Metadata
• https://github.com/RA3BattleNet/Metadata/blob/csharp-linq/Metadata/apps/ra3battlenet/manifests/1.5.2.0.xml
• https://github.com/sisong/HDiffPatch

结论:

小文件:bsdiff

大文件:hdiffpatch

设计框架图

输入:旧版本manifest.xml 功能:解析旧版本manifest和新版本对比(更新版本需要其他程序),对相关文件进行处理、标记、汇总,输出新的manifest.xml,并将整体打包 输出:打包的patch(包含新manifest.xml,解析规则,和所有对应的文件)

先前准备:上传本地manifest.xml至服务端(manifest.xml) 输入:服务器打包的patch文件 功能:根据patch内的文件与更新规则更新本地 输出:None

此文件应该作为类数据库作用,如果客户端消失或出现问题,会无视并重置此文件(此情况无法使用Patch,只能使用新文件,需要下载完整包)

注意:文件自身需要保证是UTF-8 LF,否则会由于MD5校验问题会被视为问题文件。

• TAG标记
  • UUID(暂无作用,后续可做随机种)
  • xml生成时间
  • commit信息(不会影响程序,仅用于标记)
• 文件列表
  • 文件夹(*可重复)
  • 文件(*可重复)

Attribute["Version"]="1.2.3"

任意信息即可,不会影响程序

暂无作用

• 说明:
  • 相对路径以此xml文件为根,类似.git,无法包括父目录内容
  • 文件类型改为(Text)暂时无实际作用,后续考虑Text的文件通过git的模式更新,现在均以二进制文件(bin)处理。
  • 程序处理模式解释:
    • Force:强制使用patch,不比对文件大小
    • Skip:不使用patch,直接使用原文件

此目录作为测试例,用于测试文件更新,包含状况:文件更新,文件删除,新增文件