基于Quick-cocos2d-x的资源更新方案 一

时间:2023-12-17 17:53:32

基于Quick-cocos2d-x的资源更新方案 一

图片来自网络

思绪何来


昨天写了一篇关于更新方案的理论 游戏开发:通过路径搜索优先级来进行补丁升级(从端游到手游) 今天继续细化一下

由于新项目采用的是Quick-cocos2d-x,那我就直接给出我基于Quick-cocos2d-x-master( > 2.2.3 rc) 的更新方案吧

此更新方案要解决以下几个问题


一、资源、代码在线更新

二、framework、update模块自更新

三、玩家安装新版本后,减少不必要的更新

四、更新中断的处理

五、Quick-cocos2d-x中,遇上的问题

做到上面几点后,我觉得整个更新方案应该没有大问题了。

服务器与安装包内容


在说更新流程前,我先说说安装包的内容

首先,我们这里会涉及一个大版本号,大版本号的意思,就是C++部分的版本号,如果有变动,这个版本号才会动。 以提示用户去APPSTORE下载新的版本

其余的版本号,只是一个显示版本号,可以根据游戏内容来区分。

每一个安装包本身,包含了所有游戏资源。即一个新版本发布后,玩家是不需要更新的。点开即玩。

安装包内部带了一个文件列表,内容如下

local flist = {
core = 1
version = "1.0.1"
  update_md5 = "xxxxxx"
 framework_md5 = "xxxxxx"
files = {
{path="ui/shop/shop_close_btn.png",md5="xxxxxx",size="30"},
{path="ui/army/army_tip.png",md5="xxxxxx",size="20"}
}
}
return flist

这是一个LUA文件,之所以使用LUA文件,是为了在LUA中使用dofile方便读取。而files里面,列出了所有包内的文件。 core就是我们刚刚提到的大版本号。

上面的 path,是相对于res的路径,且带完整目录和文件后缀

资源服务器上也有一份同样的资源列表,服务器和安装包中的结构如下

res/flist 资源列表

res/update.bin 这个是update模块自己的打包

res/framework.bin这个是quick-framework的打包

res/game.bin这个是游戏逻辑的打包

res/.....  其它游戏资源

更新流程


更新流程大致如下

1、从服务器取得版本列表(flist)

2、检查update的md5值,看是否有更新,如果有更新,则下载update.bin,重新载入,并退到main(退出之前,注意清除对某些的引用),再次重新进入

3、检查framework的md5值,看是否有更新,如果有更新,则下载framework.bin,并提示用户重新启动

4、读取本地安装目录的版本列表文件(flist)

5、比对服务器版本列表和本地安装目录列表中的大版本号,如果大版本号不一样,则提示用户去APPSTORE上下载。

6、读取upd目录的版本列表文件(flist),如果flist文件不存在,或者flist中存放的core与安装目录列表中的不一致(表示用户安装了新版本),则清除整个upd目录,并将本地安装目录的flist内容,写入upd目录

7、对比服务器列表与本地列表中的version(由上一步可以得到),如果version相同,则认为数据是不需要更新的

8、如果version不同,则与服务器的flist对行md5差异对比,得到需要更新的文件

9、遍历需要更新的文件列表,若upd存在,则效验其MD5值,如果MD5值与服务器的相同,则从待更新列表中移除(这一步,是为了应对上一次更新过程中,玩家中途退出的情况)

10、逐个更新文件,每个文件更新完毕后,再次效验其MD5码,如果MD5码效验失败,则重新下载此文件

11、待所有文件更新完毕,重写upd文件中的flist

12、进入游戏

通过路径搜索实现资源更新


资源的下载是OK了,我们如何来做更新呢,如何能够使程序加载到正确的资源。为了正确更新资源,我们可以通过路径搜索来实现

--add update path

CCFileUtils:sharedFileUtils():addSearchPath(device.writablePath.."upd/")

--add res path for install

CCFileUtils:sharedFileUtils():addSearchPath("res/")

假设device.writablePath的目录是 /data/data/com.ooxx.game1/  那,第一个目录就是/data/data/com.ooxx.game1/upd/ 第二个目录是 res/

在ANDROID和IOS上,如果它检查是以 / 开头的,则认为是绝对路径,直接与文件名合并,生成对应的完整路径

如果不是以 / 开头的,那在IOS上的工作原理和WINDOWS一个样,在ANDROID上,他会先检查是否以assets开头,如果不是,则强加上 "assets/" 并去APK里面搜索

总之,上面的两个路径,是在任何地方都适合的。

以上就是我综合了阳光七月,yezehui200,GcvqrNq等人的更新方案而得出的自己的更新流程,上面的流程,几乎解决了本文开头就提出的问题。

实现过程中遇到的问题


下面我来说说我在实现这一方案中,遇上的问题

问题一

执行安装目录中的flist. 因为dofile会认一个绝对路径,我在WINDOWS上是很OK的,但是在ANDROID上死活都不行,即使我硬编码 dofile("assets/res/flist") 其原因是因为,在ANDROID上,读取资源是从APK压缩包中读取的。

后来我只有通过一个比较矬的方法来优美地解决 就是使用CCFileUtils:sharedFileUtils:getFileData(“res/flist”) ,将得到的数据写入存储卡上,再dofile

由于upd目录下是没有res文件夹的,因此,我们可以保证,这货取得的肯定是安装包下的文件路径。 这样就解决了dofile在ANDROID上的问题。

而要想取安装上下的资源,就只能像这样 dofile(device.writablePath.."upd/flist")

总之,在添加了多路径搜索后,对路径的使用就要格外小心。

问题二

我在测试crypto.md5file的时候,发现,在ANDROID上,如果我们要取一个APK中的文件时,是会失败的,原因就是在C++实现里,它使用了fopen来打开文件,这在ANDROID上是做不到读取APK中文件的。 好在这个需求不需要了。

问题三

由于没有使用AssetManager,因此,目前还没有实现单个文件的进度条,到时候可能会参考一下AssetManager的实现

问题四

目录创建问题, 比如 ui/shop/ 我们直接使用 lfs.mkdir(device.writablePath.."upd/ui/shop/) 是不会成功的,需要一级级向下创建,目前没有找到一次性搞定的方案,说不定使用os.execute的mkdir带参数,可以搞定

咦,递归创建目录的方法找到了
windows下直接 os.execute("mkdir ooxx\\ooxx\\ooxx\\ooxx")
ios,android,mac,linux下,直接 os.execute("mkdir -p ooxx/ooxx/ooxx/ooxx")

测试资源服务器搭建


测试资源服务器最简单的方法,就是网上下载一个nginx,解压,解压后,找到html目录,把资源扔进去,点nginx.exe启动,浏览器输入127.0.0.1,你会发现welcome nginx 输入127.0.0.1/1.png (假设你html目录下有这个图片),你会在浏览器里看到图片。

剩下的,就爱怎么整怎么整了。

PS:如果是手机测试,最好是把内网的防火墙关了,否则连接不上。

结语


热更新对于手机网络游戏研发来说,已经是一项不可或缺的特性。Quick-Cocos2d-x为我们提供了一个可以在纯LUA环境中开发项目的能力。但是,热更新的解决方案需要针对不同的项目需求进行调整,不可一概而论。 我想这也是为什么Quick-Cocos2dx只提供了一个update的DEMO,而并未将其作为框架特性的原因吧。

本文中实现的方案,也仅仅是初试。并未经过大量的项目验证,因此肯定会有许多不妥之处。大家使用过程中,如果有发现问题,请及时反馈。