Cocos2d-x 3.6版本学习笔记－热更新

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依次解压列表中的文件。删除补丁包。结束。

流程图如下所示：