Cocos2d-JS 热更新
2015-09-19 14:40
316 查看
2015-04-23 11:07:09
前言工作需要,在空闲时间看了下Cocos2d-JS的热更新。对其进行了一个简单的实现,这里总结分享一下。
Cocos2d-JS 热更新
Cocos2d-JS 热更新是啥?Cocos2d-JS终归还是一个游戏引擎,就以游戏的过程来理解吧。传统游戏需要更新人物动画、地图场景、游戏逻辑、背景音乐怎么办?新出一个APP放到应用商店等用户下载,或者好一点游戏内提示又升级并自行下载完整的新版本APP。
使用Cocos2d-JS的热更新,那就大不一样了。它可以做到进入游戏后下载需要更新的资源甚至是脚本本身,而且更新过程不需要退出游戏。只要用户联网,就能够保证使用到最新的资源。
这些场景就非常适合使用Hot Fix
想在游戏中对春节开放新活动,不能保证应用商店能准时过审核上线
发现一个严重的Bug,需要立即修复
需要经常换游戏资源,提升新鲜感
先放一个中规中矩的版本过市场审核,然后绕过审核自己直接推新内容,哈哈
对于游戏来说,这个特性是比较重量级的。不过因为JavaScript的语言特性能支持这一功能,所以Cocos2d-JS能用此特性,而Cocos2d-x无法使用。
特性
以下是官方提供的特性
多线程并行下载支持
两层进度统计信息:文件级以及字节级
Zip压缩文件支持
断点续传
详细的错误报告
文件下载失败重试支持
Simple
1. manifest配置文件
热更新需要用到的配置文件有2种,都是以.manifest结尾。
一种是精简版,一种是完整版。精简版称为version.manifest,完整版称为project.manifest。
version.manifest:
project.manifest:
packageUrl : 远程资源的下载根路径。
remoteVersionUrl : 远程版本文件的路径,用来判断服务器端是否有新版本的资源。
remoteManifestUrl : 远程配置文件的路径,包含版本信息以及所有资源信息。
version : 配置文件对应的版本。
groupVersions : 是新增的功能字段,用于做增量更新很方便。
engineVersion : 配置文件对应的引擎版本。
assets : 所有资源信息。
key : 升级名称
path : 键代表资源的相对路径(相对于packageUrl)。
md5 : md5值代表资源文件的版本信息。
compressed : [可选项] 如果值为true,文件被下载后会自动被解压,目前仅支持zip压缩格式。
searchPaths : 需要添加到Cocos2d引擎中的搜索路径列表。
以我的配置为例,一个完整的更新流程是这样的:
先通过本地的version.manifest和服务端的version.manifest比较,如果本地version低于服务端,那么就会再去获取project.manifest。
如果version相同,那么会比较groupVersions。
如果本地没有下载过groupVersions中的任何更新,那么会依次下载升级包。
如果本地下载过1.0.1版本的升级包,那么就会跳过1.0.1下载属于1.0.2版本的升级内容。
如果下载失败,或者没有网络导致更新失败的,会继续使用未更新前的版本。并且下次启动会继续尝试更新。
2. 创建后台
用一种你喜欢的方式起一个后台服务。我朴实无华的用IDE(Eclipse for JavaEE)建立了一个空的Web工程,用Tomcat起了一个后台。
从刚才的配置文件可以看出,Web工程名为JsUpdateServer。
在WebContent的根目录下新建一个index.html文件,随便在里边写些东西,用来验证我的后台已经起来。
Run起来之后,在浏览器里输入http://localhost:8080/JsUpdateServer/index.html看看是不是能够看到你刚才写的内容?
到这里你的后台已经OK了~
3. 创建Cocos2d-JS工程
新建一个Cocos2d-JS工程,可以用专用的IDE(Cocos Code IDE),官网有下载,也有如何配置的教程,这里就不多说了。
在res目录下,新建一个project.manifest文件。这个是初始版本信息,之后的更新会用到这个文件。内容如下:
在src目录下,新建一个assetsManagerScene.js文件,这里就是热更新的主要逻辑了。代码如下:
在AssetsManagerLoaderScene里,用到了res/project.manifest,是用来对版本对比的。
下载完成后的资源会被解压,然后放在jsb.fileUtils.getWritablePath()的路径下,加到引擎的搜索范围中,并且他们的优先级是高于APP原本的资源路径的。所以相同的资源名称,引擎会优先使用更新路径下的文件,就达到更新的目的。
下载成功后会执行loadGame方法,里边会加载src/jsList.js的所有资源。也就是说通过AssetsManagerLoaderScene来确保热更新完成后,再加载所有资源。
由于资源和脚本的加载顺序发生了改变,所以还要修改根目录下的main.js和“project.json”。
main.js:
project.json:
到这里你可以跑起来看下,虽然获取不到升级文件,但是可以以最原始的版本跑起来。
4. 在后台配置升级文件
现在到后台工程的WebContent目录下添加升级文件。
从我的manifest配置文件你可以看到,我又建立了一个res文件夹,在其中分别建立src和res分别对应Cocos2d-JS工程中的资源、脚本文件夹。
随意修改一下app.js,将其作为更新内容使用。总结了几个要注意的地方。
升级文件的路径,一定要和配置文件中的path内容一致。
升级文件是.zip,记得compressed改为true。
添加新的资源文件要记得同步更新resource.js。
新增js文件也记得同步更新jsList.js。
5. 回到Cocos2d-JS工程
核对一下project.manifest文件中的地址是不是和后台一致,内容是否正确。
没问题的话就可以跑起来了,会发现你的升级内容被下载下来并且更新了。
参考
本文工程后台&Cocos2d-JS的简陋源码戳这里,Cocos2d-JS工程中的文件替换你的文件,通用的引擎工程太大没有上传。
其他可以使用到的教程
资源管理器ASSETS MANAGER
Cocos2d-JS热更新
相关文章推荐
- Cocos2d-js3.3虚拟摇杆的实现
- Cocos2d-JS自动JSB绑定规则修改
- Cocos2d-JS极速调试技巧
- cocos3.X 惯性滑动
- Quick-cocos2d-x3.3 Study (九)--------- 为物体添加物理特性
- Cocos2d-x 3.0final 终结者系列教程01-无论是从cocos2d-x2.x升级到版本cocos2d-x3.x
- cocos2d-x-3.8.1 Mac环境配置
- Quick-cocos2d-x3.3 Study (八)--------- 物理世界
- cocos2dx-lua 笔记 >方向控制 v2
- Cocos2d-x 获取系统当前时间
- 关于collect2: error: ld returned 1 exit status 问题的解决方法
- cocos2dx-lua 笔记 >方向控制 v1
- Cocos2d-x 屏幕适配
- Cocos2d-swift V3.x 中的update方法
- Cocos2d-swift V3.x 中的update方法
- Cocos2d-swift V3.x 中的update方法
- cocos2d-js添加道有道插屏(通过jsb反射机制)
- Cocos2dx打安卓包遍历所有的.cpp文件
- Cocos2dx 温馨提示(十)三种缓存类演示
- cocos2dx中的缓冲动作ActionEase类