cocos2dx之热更新

前端之家收集整理的这篇文章主要介绍了cocos2dx之热更新前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

第一次动手弄热更新将这过程记录一下。

1.热更新基本原理
这里先说一下热更新的基本原理
1)不能更新主程序,只能更新资源、lua等文件
c++生成的主程序如果变化只能通过下载升级包安装,而其它文件可以通过http动态下载到用户手机上,然后程序内部重新执行入口函数达到更新代码逻辑和资源图片效果。所以c++那部分代码在程序上线前最好最完善。

2)下载的文件会放到手机的可写入目录下,而且该目录中文件的优先级会高于程序原始安装目录
http方式下载后的文件并不能直接覆盖安装程序所在文件夹中的同名文件,因为权限不足。但是lua属于动态加载,只要在搜索路径中把可写入目录的优先级设置为最高,那么如果两个目录中都有同名文件,程序也会用最新下载的
AssetsManagerEx类的create函数中会把用户定义的可写入目录设置为最高优先级

3)lua文件和资源文件被载入后,即便在程序运行中,文件也可以直接删除
这种机制才确保文件可以被动态替换掉

4)手机本地和服务器中保存一个程序中所有文件的md5码列表,通过比较二者文件md5码列表的不同过滤出需要更新的文件进行下载
传统PC更新方式一般是把差异文件打包成一个压缩包,然后客户端根据大版本差异把对应的压缩包下载到本地,再解压覆盖,这样做的好处是下载一个文件会比较快,缺点第一是当客户端版本比较多的时候,升级压缩包会变得很多,很难维护。第二是如果压缩包比较大,解压时间会比较长,而且不太容易做进度条,导致程序感觉被卡住了
AssetsManagerEx采用的是比较所有文件是否一致的方法(需要先写个工具把程序下所有文件的md5码计算出来,并且生成对应格式的manifest文件才行),这点更象是网页加载的方式,也就是web显示时如果本地有缓存就比较缓存和服务器是否一样,如果一样就用缓存的,不一样就下载。这样服务器只需要保存一个完整的最新客户端,如果更新了某个文件,只需要在服务器上替换对应文件,然后修改配置文件中的版本号和那个文件的md5码即可。优点是没有解压缩的过程,缺点是更新文件比较多时略慢,而且有一定几率下载失败,好在现在手机网速都比较高,失败了重新下载即可,即使偶尔升级失败进不去也关系不大。

cocos2dx有AssetsManagerEx来帮助我们实现热更新,可以参考官网自带例子AssetsManagerExTest。

需要准备的文件
客户端
对于客户端而言,就是一份project.manifest文件,它记录了所有资源一级代码的md5,方便在第一次更新的时候做比对,一旦有过一次更新之后,以后就不会用这个文件了,而是用下载目录下的project.manifest,不然的话更新了还是白更新
服务器
服务器上,需要三样东西project.manifest,version.manifest,以及更新包。

关于这几个文件生成,可参考我这里
创建一个更新文件UpdateAssetScene.lua

  1. local UpdateAssetScene = class("UpdateAssetScene",function()
  2. return display.newScene("UpdateAssetScene")
  3. end)
  4.  
  5. function UpdateAssetScene:ctor()
  6. self:_initPath()
  7. self:_initAssetMgr()
  8. self:_startUpdate()
  9. end
  10.  
  11. function UpdateAssetScene:_initPath()
  12. --可写路径
  13. self.writablePath = cc.FileUtils:getInstance():getWritablePath()
  14. --下载存储路径
  15. self.storagePath = self.writablePath .. "update"
  16. --本地配置文件路径
  17. self.manifestFile = "res/version/project.manifest"
  18. --下载存储路径
  19. local storagePath = self.writablePath .. "update"
  20. --创建可写目录与设置搜索路径
  21. if not (cc.FileUtils:getInstance():isDirectoryExist(storagePath)) then
  22. cc.FileUtils:getInstance():createDirectory(storagePath)
  23. cc.FileUtils:getInstance():createDirectory(storagePath .. '/src/')
  24. cc.FileUtils:getInstance():createDirectory(storagePath .. '/res/')
  25. end
  26.  
  27. --设置app文件的优先级,将下载存储路径设为最高
  28. cc.FileUtils:getInstance():addSearchPath(storagePath .. "/src/",true)
  29. cc.FileUtils:getInstance():addSearchPath(storagePath .. "/res/",true)
  30. end
  1. function UpdateAssetScene:_initAssetMgr()
  2. local layer = cc.Layer:create()
  3. self:addChild(layer)
  4. self.layer = layer
  5.  
  6. self.ttInfoText = ccui.Text:create()
  7. self.ttInfoText:setPosition(Const["CENTER_X"],Const["CENTER_Y"] + 50)
  8. self.ttInfoText:setFontSize(26)
  9. -- self.ttInfoText:setString("初始化...")
  10. layer:addChild(self.ttInfoText)
  11.  
  12. local ivProgressBg = ccui.ImageView:create("poker/res/sliderbg.png")
  13. ivProgressBg:setAnchorPoint(0.5,0)
  14. ivProgressBg:setPosition(Const["CENTER_X"],Const["CENTER_Y"] - 80)
  15. self:addChild(ivProgressBg)
  16.  
  17. --进度条
  18. self.m_slider = cc.ProgressTimer:create(cc.Sprite:create("poker/res/slider.png"))
  19. self.m_slider:setType(cc.PROGRESS_TIMER_TYPE_BAR)
  20. self.m_slider:setMidpoint(cc.p(0,0))
  21. self.m_slider:setBarChangeRate(cc.p(1,0))
  22. self.m_slider:setPercentage(0)
  23. self.m_slider:setAnchorPoint(0.5,0.5)
  24. self.m_slider:setPosition(ivProgressBg:getContentSize().width / 2,ivProgressBg:getContentSize().height / 2)
  25. ivProgressBg:addChild(self.m_slider)
  26.  
  27. local function onNodeEvent(event)
  28. if "enter" == event then
  29. self:_updateListen()
  30. elseif "exit" == event then
  31. if self.assetsManagerEx then
  32. self.assetsManagerEx:release()
  33. self.assetsManagerEx = nil
  34. end
  35. end
  36. end
  37. layer:registerScriptHandler(onNodeEvent)
  38. end
  1. function UpdateAssetScene:_updateListen()
  2. print("self.manifestFile: ",self.manifestFile)
  3. print("self.storagePath: ",self.storagePath)
  4.  
  5. --创建AssetsManagerEx对象
  6. self.assetsManagerEx = cc.AssetsManagerEx:create(self.manifestFile,self.storagePath)
  7. self.assetsManagerEx:retain()
  8.  
  9. --下载失败数量
  10. local failCount = 0
  11. -- Check whether the manifest have been fully loaded
  12. if not self.assetsManagerEx:getLocalManifest():isLoaded() then
  13. print("Fail to update assets,step skipped.")
  14. self:_nextScene()
  15. else
  16. local function onUpdateEvent(event)
  17. local strInfo = ""
  18.  
  19. local eventCode = event:getEventCode()
  20. if eventCode == cc.EventAssetsManagerEx.EventCode.ERROR_NO_LOCAL_MANIFEST then
  21. strInfo = "发生错误:本地找不到manifest文件"
  22. elseif eventCode == cc.EventAssetsManagerEx.EventCode.UPDATE_PROGRESSION then
  23. local assetId = event:getAssetId()
  24. local percent = event:getPercent()
  25.  
  26. if assetId == cc.AssetsManagerExStatic.VERSION_ID then
  27. strInfo = string.format("Version file: %d%%",percent)
  28. elseif assetId == cc.AssetsManagerExStatic.MANIFEST_ID then
  29. strInfo = string.format("Manifest file: %d%%",percent)
  30. else
  31. strInfo = string.format("%d%%",percent)
  32. end
  33.  
  34. self.m_slider:setPercentage(percent)
  35. elseif eventCode == cc.EventAssetsManagerEx.EventCode.ERROR_DOWNLOAD_MANIFEST then
  36. self:downloadManifestError()
  37. elseif eventCode == cc.EventAssetsManagerEx.EventCode.ERROR_PARSE_MANIFEST then
  38. strInfo = "发生错误:解析manifest文件失败"
  39. elseif eventCode == cc.EventAssetsManagerEx.EventCode.ALREADY_UP_TO_DATE then
  40. strInfo = "已经是最新版本了,进入游戏主界面"
  41. self:updateFinished()
  42. elseif eventCode == cc.EventAssetsManagerEx.EventCode.NEW_VERSION_FOUND then
  43. strInfo = "发现新版本,开始升级"
  44. elseif eventCode == cc.EventAssetsManagerEx.EventCode.UPDATE_FINISHED then
  45. strInfo = "Update finished."
  46. self:updateFinished()
  47. elseif eventCode == cc.EventAssetsManagerEx.EventCode.ERROR_UPDATING then
  48. print("Asset 发生错误:更新失败 ",event:getAssetId(),",",event:getMessage())
  49. failCount = failCount + 1
  50. if (failCount < 5) then
  51. self.assetsManagerEx:downloadFailedAssets()
  52. else
  53. print("Reach maximum fail count,exit update process")
  54. failCount = 0
  55. end
  56. end
  57.  
  58. self.ttInfoText:setString(strInfo)
  59. end
  60. local listener = cc.EventListenerAssetsManagerEx:create(self.assetsManagerEx,onUpdateEvent)
  61. cc.Director:getInstance():getEventDispatcher():addEventListenerWithSceneGraPHPriority(listener,self.layer)
  62.  
  63. self:_startUpdate()
  64. end
  65. end
  1. -- 检查版本并升级
  2. function UpdateAssetScene:_startUpdate()
  3. if not self.assetsManagerEx then return end
  4. self.assetsManagerEx:update()
  5. end
  6.  
  7. -- 更新完毕,重新启动
  8. function UpdateAssetScene:updateFinished()
  9. self.ttInfoText:setString("更新完毕,重新启动")
  10. self:_nextScene()
  11. end
  12.  
  13. -- 发生错误:下载manifest文件失败,资源服务器没有打开...
  14. function UpdateAssetScene:downloadManifestError()
  15. self.ttInfoText:setString("发生错误:下载manifest文件失败,资源服务器没有打开...")
  16. end
  17.  
  18. function UpdateAssetScene:_nextScene()
  19. local handle = scheduler.performWithDelayGlobal(function ( ... )
  20. delayEnableConnectHandle_ = nil
  21. app:enterScene("LoginMainScene")
  22. end,2)
  23. local delayEnableConnectHandle_ = handle
  24. end
  25.  
  26. function UpdateAssetScene:onEnter()
  27. end
  28.  
  29. function UpdateAssetScene:onExit()
  30. end
  31.  
  32. return UpdateAssetScene

参考:
http://www.jb51.cc/article/p-ajcccpbs-ha.html
http://www.cnblogs.com/daxiaxiaohao/p/4162400.html
http://www.jb51.cc/article/p-gsutrzfy-yh.html
http://www.jb51.cc/article/p-cjsbjpkt-he.html
http://blog.csdn.net/u011488256/article/details/52274826
https://my.oschina.net/u/1785418/blog/283043

猜你在找的Cocos2d-x相关文章