Cocos 3.6版本热更新梳理
cocos热更新实现了项目资源和脚本文件的动态更新。当工程有新的改动时,用户无需重新下载完整的安装包,而是通过对比本地与最新的版本信息,仅下载有改动的文件到本地,完成版本的更新。
工程的资源和脚本文件存放分2个地方,一个是安装目录,一个是数据目录,当app安装完后,安装目录则不再可写,此后所有的更新文件统一存放到数据目录当中,APP调用文件时,也优先搜索数据目录的文件,当数据目录中找不到文件时,再到安装目录中搜索。
配置文件分2种,project.manifest和version.manifest。服务器和客户端都存有备份,服务器存放着最新的版本配置文件,版本号最高,客户端每次启动前都会将服务器版本文件下载下来,并和本地配置文件对行对比,如果不是最新版本,则下载并安装补丁包。配置文件内容都是Json对象,且结构一样,只是version.manifest只存储了版本信息,project.manifest存储了版本信息和补丁信息。
project.manifest文件结构如下:
{
"packageUrl" :"http://test.ztgame.com/",
"remoteManifestUrl" :"http://test.ztgame.com/project.manifest",
"remoteVersionUrl" :"http://test.ztgame.com/version.manifest",
"minVersion":"1.0.0.0",
"version" : "1.0.0.2",
"groupVersions" : { "1": "1.0.0.2" },
"assets" : {
"p1.zip" : {"md5" : "13eda4aa119b71eaf4c3087a5df3954c","compressed" : true }
},
"searchPaths" :["res","src"]
}
json结构是固定的,packageUrl表示服务器下载目录的根目录,remoteManifestUrl字段表示project.manifest文件的下载url,remoteVersionUrl字段表示version.manifest的下载url,minVersion 表示支持更新的最低版本,低于该版本则提示重新下载安装包。version字段表示工程的当前版本(如果配置文件是服务器上的,表示服务器的当前版本,如果是客户端的,则表示客户端的当前版本),groupVersions字段用意不明。Assets字段表示要更新的资源列表,p1.zip为补丁包名(包全路径为http://test.ztgame.com/p1.zip),md5字段为该补丁包的唯一标识,compressed表示下载完后是否需解压。searchPaths表示要添加的搜索路径(程序调用脚本或资源文件时,搜索的起始路径)。
Version.manifest文件结构与上同,但是没有assets字段。
更新流程如下(注:自己对框架源码作了小改动,添加了一个最小更新版本):
1.构造AssetsManagerEx对象
1.1绑定下载成功、失败、进度的回调函数
1.2设置下载文件的存放路径
1.3加载本地project.manifest文件,若失败,则抛出消息ERROR_NO_LOCAL_MANIFEST,结束。
2.启动更新
2.1下载version.manifest文件,若成功goto 2.2,否则下载project.manifest,若成功goto2.2,否则抛出ERROR_DOWNLOAD_MANIFEST,结束。
2.2加载下载的配置文件并与本地project.manifest版本号进行对比,若版本相同,则抛出消息ALREADY_UP_TO_DATE,结束。若版本低于可更新版本号,则抛出NONUPDATABLE_VERSION,提示下载完整安装包,结束。否则goto 3.
3.下载补丁包
3.1清空下载记录,下载失败记录,解压记录
3.2查看是否有未完成的下载记录,有则继续逐个下载(通过查看.temp文件),否则goto 3.3
3.3获取本地assets和服务器asset差异列表,根据补丁包名:
a.如果本地有,服务器没有,则删除,
b.如果本地有,服务器也有,但md5不同,刚更新,
c.如果服务器有,本地没有,则添加
3.4根据差异列表,将要删除的资源删除,要更新和添加的资源包添加到下载列表
3.5批量下载补丁包,全部下载完后,按解压记录列表次序依次解压替换资源
3.6查看下载记录,下载失败记录,如果有失败和未完成记录则抛出UPDATE_FAILED,结束。否则goto 3.7
3.7依次解压列表中的文件。删除补丁包。结束。
流程图如下所示: