以下介绍的是在 Windows7 + VS2013 + Cocos Code IDE。

并使用Cocos Code IDE创建的Lua项目,绑定方法。

1、将自定义的C++代码放在frameworks\runtime-src\Classes下

当然放哪里是随意的,我喜欢放在Classes下。

2、添加自定义类的.ini文件

在 frameworks\cocos2d-x\tools\tolua 中,复制一份该文件夹下cocos2dx.ini的配置信息,然后修改一些参数,改成我们自定义类的参数。

以下列出需要修改的参数配置:

[custom_api]

# prefix会被添加到生成的函数.你也可以选择不添加这个到你的模板

prefix = custom_api

# 所有的类都会嵌入到这个命名空间

target_namespace = my

# 类所在的路径,如果有多个,用空格隔开

headers = %(cocosdir)s/../runtime-src/Classes/PanZoomLayer.h

# 需要注册的类,如果有多个,用空格隔开

classes = PanZoomLayer

# 不提供给Lua的public成员函数

skip = PanZoomLayer::[onTouchesBegan onTouchesMoved onTouchesEnded init onEnter onExit update]

# 这些全空就好了

rename_functions =

rename_classes =

remove_prefix =

classes_have_no_parents =

base_classes_to_skip =

abstract_classes =

script_control_cpp = no

3、genbindings.py 添加自定义的配置.ini

在 frameworks\cocos2d-x\tools\tolua 的 genbindings.py 中的129行找到cmd_args。

将我们自定义的 custom_api.ini 添加进去,并注释掉其他.ini(这些已经不需要重新生成)

4、运行 genbindings.py 脚本

在终端运行 genbindings.py 脚本。

在这里,我是直接写了一个批处理文件 .bat 。

注意:只要需要用到的工具都下载,安装,配置好了,一般就能生成成功。

生成失败的,基本都是因为工具没有配置好。

生成成功后,在 frameworks\cocos2d-x\cocos\scripting\lua-bindings\auto 中会找到我们生成的C++的桥接文件, lua_custom_api_auto.cpp 和 lua_custom_api_auto.hpp 。

       其中,lua_custom_api_auto.hpp 中的 register_all_custom_api 就是我们用来将PanZoomLayer类注册到Lua环境中的关键函数。


       以及在 frameworks\cocos2d-x\cocos\scripting\lua-bindings\auto\api 中也能够找到我们提供给Lua调用的接口文件。


5、编译注册到Lua

注册自定义类的函数在我们的 lua_custom_api_auto.hpp 中可以看到。

register_all_custom_api(lua_State* tolua_S)

使用 VS2013 打开 frameworks\runtime-src\proj.win32 下的工程。

(1)将自定义的类 PanZoomLayer 添加到项目工程的Classes下。


2)将 lua_custom_api_auto.cpp、lua_custom_api_auto.hpp 添加到工程liblua的auto下。

(3)添加lualib工程的文件搜索路径。

将 $(EngineRoot)../runtime-src/Classes 路径加进去。

(4)编辑 frameworks\runtime-src\Classes 下的入口类 AppDelegate.cpp

添加:lua_custom_api_auto.hpp 头文件

注册:register_all_custom_api(state)

注意:register_all_custom_api 的上下两句话,必须加上!

(5)编译运行整个项目,完成C++类的注册到Lua。

然后就可以再Lua中愉快的使用自定义的类了!