CocosCreator以subpackages分包实现大厅+子游戏

前言

随着游戏的玩法越来越多,也就意味着包体越来越大,对于玩家来说,首次下载的包体就会越来越大,从而也会增加首次启动的时间,在未推出分包功能之前,所有的代码都会生成到一个project.js的文件中,此时对于我们开发者迫切希望把游戏一些比较独立的模块的代码及资源分开来进行加载,由于公司做的是棋牌游戏,一个从零开始的新项目,当时CocosCreator2.1.2的最新版本,所以就直接用了最新版本做项目,做之前框架也是朝着大厅+子游戏的方向,看了不少论谈,多数的做法就是大厅与子游戏分开项目进行开发,但个人觉得对项目代码及资源上的管理特别的不方便,在这项目立项之前对当前Creator版本的功能做了大致的了解,发现自从v2.0.7版本就已经开始支持分包处理,但v2.1.2版本,由于引擎对自己引擎资源的管理有问题,所以写这个文档就以最新版本v2.3.3来做的,但2.1.2之后的版本本人确定是没有问题的,只是需要对引擎进行一些修改

项目环境

CocosCreator 2.3.3
Microsoft Visual Studio Enterprise 2015(SDK安装 : Windows Phone SDK 8.0)
Microsoft Visual Code
Android Studio 3.6.3(API Level : android-28 NDK : android-ndk-r16b

项目示例

示例Git地址
注意事项:
配置为子包后,只有原生资源,例如图片和音频会被最终放到子包中。Prefab、AnimationClip 等 JSON 类型的资源仍然会放在主包里,目前管方的分包还未实现非原生资源的分包,非原生资源还在主包里。此功能期待引擎组后续能有更好的解决方案

项目关键点

1.该方案基于CocosCreator分包功能
2.大厅与子游戏代码作为同一项目开发,方便对资源及代码的管理,可有效的解决多项目开发可能产生uuid重复问题
3.子游戏之间代码及资源不能相互引用
4.大厅与子游戏之间的通信全部以事件方式进行交互

项目结构

把项目大致分为资源区+代码区
资源区及代码区的结构一致
大厅(大厅+公共+框架)+子游戏的形式,如下图,红包为大厅部分,黄色为子游戏部分


项目结构

红包大厅部分,无需配置为子包,黄色子游戏部分,需要配置成子包。
需要注意的事,子游戏代码及资源子包名配置一致,如下图


游戏1资源

游戏1代码

项目扩展插件使用

项目工具

1.引擎修正

为了后面使用方便,安装好你的Creator2.3.3,直接使用引擎修正后,再构建项目,对引擎修改的部分会自动生成到你的构造项目中,如果你的项目目前已经构建,对引擎改动的代码放置在package/engine目录下,到该目录下用对比工具同步到你的项目中,目前还未支持对已经生成构建的项目进行引擎代码的修正

2.资源引用检测

在游戏开发过程中,由于某些子游戏相当类似,所有直接复制进行修改,此时复制得到的子游戏的资源引用仍然指向以前的地方,并未指向复制后得到的资源,又或者不小心在A游戏使用了B游戏的资源,此时在打包完成后,且子游戏都不放置到包内,当通过热更新子游戏进入时,由于只下载了B游戏的资源,但B游戏的资源大多都还指向A游戏,此时会造成找不到资源可能产生崩溃的现象。但当我们游戏的预置体在足够多的情况,如果手动的排查,是一个非常大的工程,所以这边提供了一个检测工具,去检测你的子游戏预置体是否使用到了其它子游戏的资源,如下图

image.png

当你的子游戏做完后,可使用插件来检测完成的子游戏是否引用了其它子游戏的资源,控制台的警告就是你引用了不属于自己子游戏的资源,需要自己手动去处理掉这些问题
对于代码中使用资源问题,全部通过路径代理去获取子游戏的资源
如进入子游戏,打开子游戏1的界面,界面对视图预置体路径的引用如下:
image.png

统一使用这种方式,如果路径的代理没有正确设置,能在第一时间确定问题。是不是资源路径获取错误,还是进入子游戏的相关参数有误,不至于找不到子游戏的资源。

3.热更新工具

热更新工具

工具说明

大厅生成Manifest配置
版本号:当前大厅的版本号
资源服务器地址:cdn资源服务器地址

build项目资源文件目录:指定你的build目录,如
image.png

点击生成会生成版本控制文件如下图
image.png

image.png

子游戏生成Manifest配置
目录只能配置子游戏的游戏版本号
测试环境一栏
主要关注本地server物理路径,可以指定你的服务器路径,热更新相关文件直接部署到你的服务器
如我本地服务器:


D:/nginx-1.17.10/html/hotupdate

点击部署,最终服务器部署的资源如下


image.png

执行子游戏包剔除:
当你部署完成后,如果不希望把某个子游戏放入到原始包内,可执行这个命令剔除不包含在包内的子游戏

4.扩展插件配置说明

热更新子游戏及大厅版本的配置及资源检测插件中显示的游戏在packages/config/games.json配置,当开发完成子游戏时,如果需要对其实资源引用合法性检测及版本做更新时,直接对games.json进行修改

示例测试

1.构建

image.png

2.生成热更新版本控制文件

使用热更新插件生成热更新版本控制文件,并部署到自己的测试服务器,如下


image.png

3,剔除子游戏

如果希望子游戏在包内,可在【是否包含在原始包内】打勾,否则相反
这里测试一个在包内一个不再包内的情况,配置如下


image.png

4.win32平台

打开build\jsb-default\frameworks\runtime-src\proj.win32的工程编译打开游戏如下


image.png

左边为该游戏的工作目录,目前主包并没有包含有子游戏的代码及资源
分别进入两个子游戏之后,本地缓存如下,gameTwo不在包含,下载子游戏 后运行,gameOne在包内,由于跟服务器版本一致,不会下载,直接使用本地资源及代码


image.png

5.android平台

与win32平台一致,打包运行就ok

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,242评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,769评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,484评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,133评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,007评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,080评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,496评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,190评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,464评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,205评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,567评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2 335