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

2023-07-29 22:22:04

图片来自网络

思绪何来

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

由于新项目采用的是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，而并未将其作为框架特性的原因吧。

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

码农公寓

相关文章