记录之——cocos2d-x v3.0 发布说明

目录generated withDocToc

• 概况
• 需求
  • 环境需求
  • 编译需求
  • 如何运行 TestCpp
    • Mac OSX & iOS
    • Android
    • Windows
    • Linux
  • 如何开始一个新游戏
• v3.0 亮点
• 细节
  • C++11 特性
    • std::function
    • 强类型枚举
    • 覆盖
  • 去OC化
    • 移除C++类的“cc”前缀以及free functions
    • 使用 clone 替代 copy
    • 单例类采用了 getInstance 和 destroyInstance
    • 使用了 Ref 代替了 Object
    • getters
    • POD 类型
  • 新的渲染器
    • 渲染器特性
      • 自动批处理
      • 自动剔除
      • 全局 Z 值
    • Sprite 和 SpriteBatchNode
  • 优化 LabelTTF / LabelBMFont / LabelAtlas
  • 新的事件分发机制
  • 物理引擎集成
• 其他 API 变更
  • ccTypes.h
  • 弃用的函数和全局变量
• Lua 绑定的修改
  • 使用 Lua 绑定生成工具
    • 绑定带命名空间的类到 Lua
    • 使用 ScriptHandlerMgr 来管理注册和注销 Lua 函数
  • 其它 API 变更
    • 使用cc、ccs、ccuigl和sp作为模块名
    • 函数名修改
    • 添加一些模块
    • 增加更多的 Lua 绑定
    • 将一些 Lua 绑定的类或结构体替换成表
    • 支持 Lua 脚本代码调用 Object-C 代码和 java 代码
    • 添加一些 Lua 文件来储存不同的模块常量

概况

• 下载:http://www.cocos2d-x.org/filedown/cocos2d-x-3.0-cn
• 完整更新日记:https://github.com/cocos2d/cocos2d-x/blob/cocos2d-x-3.0beta/CHANGELOG
• API参考手册:http://www.cocos2d-x.org/reference/native-cpp/V3.0beta/index.html

需求

环境需求

• Android 2.3 及以上
• iOS 5.0 及以上
• OS X 10.7 及以上
• Windows 7 及以上
• Windows Phone 8 及以上（初级阶段）
• Linux Ubuntu 12.04 及以上
• Browsers via Emscripten暂不支持

编译需求

• Xcode 4.6 (for iOS or Mac)
• gcc 4.7 for Linux or Android. Android 要求 ndk-r9 及以上.
• Visual Studio 2012 (for Windows)

如何运行 TestCpp

Mac OSX & iOS

• 进入cocos2d-x/build文件夹,打开cocos2d_test.xcodeproj
• 在 Xcode 的 scheme toolbar 选择iOS或者OS X平台
• 点击run按钮

Android

你可以运行一下示例...

使用命令行：

$ cd cocos2d-x
$ ./setup.py
$ cd build
$ ./android-build.py cpp-empty-test -p 10
$ adb install cocos2d-x/tests/cpp-empty-test/proj.android/bin/CppEmptyTest-debug.apk

然后点击安卓设备上的程序运行测试例，-p指定了 Android API 等级，cocos2d-x 支持 level10 以上。

使用 Eclipse

$ cd cocos2d-x
$ ./setup.py
$ cd build
$ ./android-build.py cpp-empty-test -p 10

然后

• 把 cocos2d-x Android 项目导入 Eclipse 中，导入的路径是cocos/2d/platform/android
• 把cpp-empty-testAndroid 项目导入 Eclipse 中，导入的路径是tests/cpp-empty-test/proj.android
• 编译cpp-empty-testAndroid 项目，然后运行即可

Windows

cocos2d-x/build目录,然后打开cocos2d-win32.vs2012.sln文件
• 选择cpp-empty-test作为启动项
• 点击运行按钮

Linux

$ cd cocos2d-x/build
$ ./install-deps-linux.sh
$ cd ../..

然后

$ mkdir build
$ cd build
$ cmake ../cocos2d-x
$ make -j4

运行

$ cd bin/cpp-empty-test
$ ./cpp-empty-test

如何开始一个新游戏

请参考说明和文档。

v3.0 亮点

• 使用 C++(C++11) 的特性取代了 Objective-C 的特性
• 优化了 Labels
• 优化了渲染器（比 v2.2 更快）
• 新的事件分发机制
• 物理引擎集成
• 新的 UI 对象
• JavaScript 远程调试器
• 支持远程控制台
• 使用cocos console创建和运行项目
• 重构 Image - 及时释放内存，统一了支持文件格式的 API
• 自动生成 Lua 绑定，添加了 LuaJavaBridge 和 LuaObjcBridge
• 模板容器
  • 使用cocos2d::Map<>替代了CCDictionary,用法
  • 使用cocos2d::Vector<>替代了CCArray,cocos2d::Value替代了CCBool,CCFLoat,monospace; font-size:13.6000003814697px; padding:0.2em 0px; margin:0px">CCDouble,用法

细节

C++11 特性

从 v3.0-pre-alpha0 开始，这些特性被添加

C++11 的一部分特性已经被使用到 cocos2d-x 中了：

• std::function,包含了回调中使用的 lambda 对象
• 对于大多数的 cocos2d-x 枚举和常量采用了强类型枚举
• 在线程中使用了std::thread
• 对于 Override 和 final 方法，增加了override和final上下文关键字

std::function

CallFunc可以由std::function<void()>来创建
• CallFuncN可以由std::function<void(Node*)>来创建
• CallFuncND和CallFuncO已经被移除了因为它们可以类似地由CallFuncN和CallFunc来创建. 可以查看示例中的 ActionsTest.cpp 文件
• MenuItem支持std::function<void(Node*)>作为回调

CallFunc示例:

// v2.1 版本
CCCallFunc *action1 = CCCallFunc::create( this,callfunc_selector( MyClass::callback_0 ) );

// v3.0 版本 (短版本)
auto action1 = CallFunc::create( CC_CALLBACK_0(MyClass::callback_0,this));
auto action2 = CallFunc::create( CC_CALLBACK_0(MyClass::callback_1,additional_parameters));

// v3.0 版本 (长版本)
auto action1 = CallFunc::create( std::bind( &MyClass::callback_0,93)">auto action2 = CallFunc::create( std::bind( &MyClass::callback_1,150)">// v3.0 中你也可以使用lambda表达式或者其他函数对象
auto action1 = CallFunc::create(
                 [&](){
                     auto s = Director::sharedDirector()->getWinSize();
                     auto label = LabelTTF::create("called:lambda callback","Marker Felt",16);
                     label->setPosition(ccp( s.width/4*1,s.height/2-40));
                     this->addChild(label);
                 }  );

MenuItem示例:

// v2.1 版本 CCMenuItemLabel *item = CCMenuItemLabel::create(label,menu_selector(MyClass::callback)); auto item = MenuItemLabel::create(label,CC_CALLBACK_1(MyClass::callback,67)">this)); // do something. Item "sender" clicked });

强类型枚举

以k开头的常量和枚举量，通常被定义为int或者简单的enum类型，现在已经被强类型枚举（enum class）所替代，这样有利于避免冲突和类型错误。

新的格式是:

| v2.1       | v3.0        |
| kTypeValue | Type::VALUE |

示例:

| v2.1                             | v3.0                             |
| kCCTexture2DPixelFormat_RGBA8888 | Texture2D::PixelFormat::RGBA8888 |
| kCCDirectorProjectionCustom      | Director::Projection::CUSTOM     |
| ccGREEN                          | Color3B::GREEN                   |
| CCPointZero                      | Point::ZERO                      |
| CCSizeZero                       | Size::ZERO                       |

旧的值仍然是可以使用的，但是已经被标记为 deprecated.

覆盖

为了捕获覆盖方法中可能出现的错误，子类的覆盖方法添加了override的关键字。

示例:

class Sprite : public Node { bool isFlipY(void) const; void setFlipY(bool bFlipY); // Overrides virtual setTexture(Texture2D *texture) override; virtual Texture2D* getTexture() const inline setBlendFunc(const BlendFunc &blendFunc) const BlendFunc& getBlendFunc() override; }

去OC化

从 v3.0-pre-alpha0 开始，这些特性被添加

移除C++类的“cc”前缀以及free functions

类的变更

因为 cocos2d-x 已经使用了cocos2d的命名空间，因此也就不需要在所有的类中添加CC的前缀。 示例:

| v2.1       | v3.0     |
| CCSprite   | Sprite   |
| CCNode     | Node     |
| CCDirector | Director |
| etc...                |

v2.1 类名仍然有效，但是已经被标记为 deprecated。

free functions 的变更

对于drawing primitives:

• 已经被添加到DrawPrimitives命名空间
• 移除cc前缀

对于gl proxy functions:

GL命名空间
• 移除ccGL前缀

| v2.1 | v3.0 | | ccDrawPoint() | DrawPrimitives::drawPoint() | | ccDrawCircle() | DrawPrimitives::drawCircle() | | ccGLBlendFunc() | GL::blendFunc() | | ccGLBindTexture2D() | GL::bindTexture2D() | | etc... |

v2.1 free functions 仍然有效，但已经被标记为 deprecated。

使用 clone 替代 copy

clone()返回了一份 autoreleased 版本的拷贝。

copy()不再被支持，如果你使用它，仍然是可以编译的，但是代码会崩掉。

// v2.1 CCMoveBy *action = (CCMoveBy*) move->copy(); action->autorelease(); // v3.0 // 不需要使用autorelease，也不需要做转换 auto action = move->clone();