quick-cocos2d-x 从2.2.5升级到3.3的体会

  最近公司的项目需要把项目从quick 2.2.5升级到quick 3.3 final版本，我发现改动还是很大的，但是github上的文档只涵盖了很少的一部分，因此我在这里把自己升级中的一些注意事项罗列出来，希望能有所帮助。

       首先，我们可以看看github上的文档，主要有如下部分：

下列函数或常量需要替换：

    

CCLuaLog()	print()
CCFileUtils:sharedFileUtils()	cc.FileUtils:getInstance()
kCCTexture2DPixelFormat_*	cc.TEXTURE2D_PIXEL_FORMAT_*
display.addSpriteFramesWithFile	display.addSpriteFrames
ccc3()	cc.c3b()
ccc4()	cc.c4b()
ccc4f()	cc.c4f()
ccc4FFromccc4B()	cc.c4fFromc4b()
getZOrder()	getLocalZOrder()
setZOrder()	setLocalZOrder()
setFlipX()	setFlippedX()
setFlipY()	setFlippedY()

        结合自己的项目，我们发现还有一些我们在升级时需要注意的东西并没有标注出来。

1.ccp改为cc.p

2.CCDirector等大量CC的写法改为cc.Director，即CCDirector:sharedDirector()改为cc.Director:getInstance()，SimpleAudioEngine:sharedEngine()改为cc.SimpleAudioEngine:getInstance()。

3.骨骼动画写法的修改，如CCArmature:create 改为 ccs.Armature:create等

4.骨骼动画的释放，ccs.ArmatureDataManager:purge()改为ccs.ArmatureDataManager:destroyInstance()

5.音乐播放类的带background的方法写法的修改，如isBackgroundMusicPlaying改为isMusicPlaying

6.sprite的点击判断的修改，如下面例子：self.sprite是我们的精灵，pnt是我们的点，那么self.sprite:getBoundingBox():containsPoint(pnt)改为cc.rectContainsPoint(self.sprite:getBoundingBox(), pnt)

7.ui.newBMFontLabel改为cc.ui.UILabel.newBMFontLabel

8.现在的layer层默认是吞噬点击，所以我们在添加新的层的时候，应当设置为不可吞噬，也就是setTouchSwallowEnabled(false)

9.tableview里的写法改变：如kCCScrollViewDirectionVertical改为cc.SCROLLVIEW_DIRECTION_VERTICAL等

10.http请求回调的返回值“inprogress”改为“progress”

11.同时多个assetsmanager同时在下载的过程中，回调的progress值会产生跳动的情况，解决的方法是找到asstsmanager.cpp文件，修改其中的一个函数的percent前的前缀static，把static去掉并重新编译即可。

12.assetsmanager写法修改，如：

local assetsManager = cc.AssetsManager:new(zipurl, versionurl, path)
assetsManager:deleteVersion()
assetsManager:retain()
assetsManager:setConnectionTimeout(3)

其中retain这句话必不可少，否则会报错。

13.ui.newImageMenuItem改为cc.ui.UIPushButton.new。

14.在quick 3.3中，精灵不可以直接执行cc.PageTurn3D方法，会直接报错，我的解决方法是用cc.NodeGrid:create()创建一个nodegrid，把我们的精灵加在这个nodegrid上，然后在用nodegrid去调用类似PageTurn3D的方法即可。

15.物理引擎相关代码的修改，在一开始创建的时候，

local Scene = class("Scene", function()
return display.newPhysicsScene("Scene")
end)

创建长方形的刚体，

local b = cc.PhysicsBody:createBox(cc.size(x, y))

b:getShape(0):setMass()   设置重量
b:getShape(0):setRestitution()  设置弹力
b:setVelocity() 设置速度

如果我们想绑定精灵a到b上，即

a:setPhysicsBody(b)

16.在android上，device.cachePath改为device.writablePath

17.骨骼动画的play()方法去掉，改为playWithIndex

18.在android真机上编译的时候，我们要注意：

这里直接贴上github上的表格，

要启用这个功能，开发者需要打开项目中的 proj.android/jni/Application.mk 文件，然后将不需要的模块值改为 0。

MACRO 体积 功能 

CC_USE_CURL	1.3M	使用 CURL 库提供 HTTP 网络功能。关闭后，assetsmanager等相关功能也会被去掉。quick 在 Android 下使用 Android 系统的 Java 接口提供 HTTP 网络功能，所以 CURL 关闭后仍然可以使用HttpRequest。
CC_USE_TIFF	514KB	使用 TIFF 图像格式。
CC_USE_WEBP	208KB	使用 WebP 图像格式。
CC_USE_JPEG	368KB	使用 JPEG 图像格式。
CC_USE_PHYSICS	416KB	使用物理引擎。
CC_USE_3D	212KB	使用 3D 模块。
CC_USE_SQLITE	367KB	使用 Lua 的 Sqlite 数据库扩展 lsqlite3。
CC_USE_CCSTUDIO	1.2M	使用 Cocos Studio 支持模块。
CC_USE_CCBUILDER	208KB	使用 Cocos Builder 支持模块。
CC_USE_SPINE	92KB	使用 Spine 支持模块。
CC_CODE_IDE_DEBUG_SUPPORT		使用 cocos IDE 调试支持模块。在 release 版本里自动关闭，因此没有统计它在release版本下的体积。

只需要在 Applicaiton.mk 中将相应的宏设置为 0，然后重新编译就可以得到更小的可执行文件。

在proj.android_no_anysdk工程中，以上可选模块均已经关闭。因此如果直接使用no_anysdk工程来编译，生成的apk包将不支持上述模块功能，如需要请自己修改相应的开关。

还有一些常用的基础模块可以去除，由于可能影响常用的功能，请根据自己的情况移除。打开文件 frameworks/runtime-src/Classes/lua_module_register.h ，分别注释掉以下语句：

register_cocosdenshion_module(L);   // 简单音效模块
    register_network_module(L);         // 网络模块，如 socket 和 websocket
    register_ui_moudle(L);              // 基础UI库，如编辑框等
    register_extension_module(L);       // 基本扩展，如 TableView 等
    register_audioengine_module(L);     // audio engine 模块

这里，如果我们发现编译后的包还是出现找不到sqlite3之类的错误，那么我们可以运行android项目下的clean.bat，然后再重新编译即可。 

上面是自己在从quick2.2.5到3.3升级的过程中的一些理解，希望能有所帮助。

转载于:https://my.oschina.net/ffs/blog/390275