Quick-Cocos2dx-Community_3.6.3_Release 中 tolua++ 使用方法
参考文章1 http://www.aichengxu.com/view/45851
参考文章2 http://blog.csdn.net/pawleft/article/details/52127443
实际上上面两篇文章已经讲的很清楚,我写此文章的目的,是特别记录自己解决问题的一个历程,而不只是简单的tolua++的使用方法。
曾经在C++中写了很多类,供Lua调用。现在cocos底层换了以后,编译不通过,于是想通过tolua++重新导出一遍类接口,但是以前导出接口的配置文件不存在了,于是我才要花时间研究tolua++怎么用。
上面的两篇文章讲的很清楚。主要以下7步骤:
1 配置好python环境,安装好pyyaml,pyCheetah,这些在Quick-Cocos2dx-Community的根目录下tools\tolua\目录下的README.mdown文件中有详细说明。
2 自己的CCGameClient.cpp和CCGameClient.h写好,可以放在cocos/my/目录下,自定义其它的也可以,在后面的ini文件中指明路径即可。
#ifndef __CCGAME_CLIENT_H #define __CCGAME_CLIENT_H #include "cocos2d.h" USING_NS_CC; class CCGameClient : public Object { public: static CCGameClient* shareHandle(); virtual ~CCGameClient(); private: static CCGameClient* instance_; CCGameClient(); }; #endif
#include "CCGameClient.h" CCGameClient* CCGameClient::instance_ = NULL; CCGameClient::CCGameClient() {} CCGameClient* CCGameClient::shareHandle() { if (!instance_) instance_ = new CCGameClient(); return instance_; } CCGameClient::~CCGameClient() {}
3 配置.ini文件,这个很重要。tools\tolua\目录下有很多.ini文件,都是cocos自带的一些类的导出配置,可参考。自己可以复制cocos2dx.ini重命名为自己的.ini,比如叫cocos2dx_my_gameclient.ini。主要修改的参数:
[gameclient] # the prefix to be added to the generated functions. You might or might not use this in your own # templates prefix = gameclient # create a target namespace (in javascript, this would create some code like the equiv. to `ns = ns || {}`) # all classes will be embedded in that namespace target_namespace = # what headers to parse headers = %(cocosdir)s/cocos/my/CCGameClient.h classes = CCGameClient skip =
[]里面的名字其实是python在解析这个ini文件的时候读取的元素,这个要记住,一会儿要用的.
target_namespace 说一下,就像你在lua里面要使用某个控件,都以cc.开头一样。
prefix 看说明即可。
headers 就是你自定义的类的头文件的路径,你放在哪里,这个路径就是哪里,不一定放在cocos目录下。这个headers可以是多个。
classes 在headers中可能会遇到很多class,那么包含在classes中的名字将会被最终导出。
skip 是要跳过的函数。因为没有必要自定义的类里面的所有方法都暴露给lua,只暴露需要的即可。具体的设置方法可参考其它的init文件,很简单。
4 在genbindings.py中添加刚才配置的cocos2dx_my_gameclient.ini。打开tools\tolua\genbindings.py文件,找到cmd_args的设置,默认是长这样的
tolua_root = '%s/tools/tolua' % project_root output_dir = '%s/cocos/scripting/lua-bindings/auto' % project_root cmd_args = {'cocos2dx.ini' : ('cocos2d-x', 'lua_cocos2dx_auto'), \ 'cocos2dx_assetsmanager.ini' : ('cocos2dx_assetsmanager', 'lua_cocos2dx_assetsmanager_auto'), \ 'cocos2dx_extension.ini' : ('cocos2dx_extension', 'lua_cocos2dx_extension_auto'), \ 'cocos2dx_ui.ini' : ('cocos2dx_ui', 'lua_cocos2dx_ui_auto'), \ 'cocos2dx_studio.ini' : ('cocos2dx_studio', 'lua_cocos2dx_studio_auto'), \ 'cocos2dx_spine.ini' : ('cocos2dx_spine', 'lua_cocos2dx_spine_auto'), \ 'cocos2dx_physics.ini' : ('cocos2dx_physics', 'lua_cocos2dx_physics_auto'), \ 'cocos2dx_experimental_video.ini' : ('cocos2dx_experimental_video', 'lua_cocos2dx_experimental_video_auto'), \ 'cocos2dx_experimental.ini' : ('cocos2dx_experimental', 'lua_cocos2dx_experimental_auto'), \ 'cocos2dx_controller.ini' : ('cocos2dx_controller', 'lua_cocos2dx_controller_auto'), \ 'cocos2dx_cocosbuilder.ini': ('cocos2dx_cocosbuilder', 'lua_cocos2dx_cocosbuilder_auto'), \ 'cocos2dx_cocosdenshion.ini': ('cocos2dx_cocosdenshion', 'lua_cocos2dx_cocosdenshion_auto'), \ 'cocos2dx_3d.ini': ('cocos2dx_3d', 'lua_cocos2dx_3d_auto'), \ 'cocos2dx_audioengine.ini': ('cocos2dx_audioengine', 'lua_cocos2dx_audioengine_auto'), \ 'cocos2dx_csloader.ini' : ('cocos2dx_csloader', 'lua_cocos2dx_csloader_auto'), \ } target = 'lua' generator_py = '%s/generator.py' % cxx_generator_root
我们删掉其它的,增加自己的,变成下面。
标红色部分,就是刚才.ini文件里面[]里面的内容。
cocos2dx_my_gameclient.ini是配置文件的名字
lua_gameclient_auto是最终生成的文件的名字。
tolua_root = '%s/tools/tolua' % project_root
output_dir = '%s/cocos/scripting/lua-bindings/auto' % project_root
cmd_args = {'cocos2dx_my_gameclient.ini' : ('gameclient', 'lua_gameclient_auto'), \
}
target = 'lua'
generator_py = '%s/generator.py' % cxx_generator_root
5 开始生成,在控制台进入Quick/tools/tolua/ 目录 ,运行genbindings.py。如果步骤1没有装好可能会报错,找不到yaml和Cheetah.Template,去下载相应的库即可。如果成功运行,会在根目录cocos/scripting/lua-bindings/auto 目录下生成lua_gameclient_auto.cpp和lua_gameclient_auto.hpp两个文件,在cocos/scripting/lua-bindings/auto/api 下生成lua_gameclient_auto_api.lua和lua_gameclient_auto_api.lua两个文件。api文件没啥用,是个说明而已。
6 加入到自己的项目。在自己项目中,项目名/frameworks/runtime-src/Classes/下,创建两个文件夹Base和lua-bindings,将CCGameClient.cpp和CCGameClient.h放在Base中,将lua_gameclient_auto.cpp和lua_gameclient_auto.hpp放在lua-bindings中。
7 注册函数。在/frameworks/runtime-src/Classes/lua_module_register.h中增加注册代码register_all_gameclient(),这个方法是在lua_gameclient_auto.hpp中声明的,所以要导入.hpp文件。lua_module_register.h里面的lua_module_register是在applicationDidFinishLaunching()中调用的。
在lua中测试。这是最简单的调用。
local test = CCGameClient:shareHandle()
-------------------------我是重点---------------------------
上面哪些步骤其实很简单,都能搜到,真正浪费我时间的是,发现导出的接口中,变量也能导出来,会有类似于下面导出变量的语句。但是,我们刚才写的自定义类,假如加入一个变量,是不会导出的。这让我百度了N久。tolua++能不能导出自定义类的变量?
tolua_variable(tolua_S, "cardSeries", tolua_get_CardRecognization_CardSeries, tolua_set_CardRecognization_CardSeries); tolua_variable(tolua_S, "cardCount", tolua_get_CardRecognization_CardCount, tolua_set_CardRecognization_CardCount); tolua_variable(tolua_S, "maxCardPoint", tolua_get_CardRecognization_MaxCardPoint, tolua_set_CardRecognization_MaxCardPoint); tolua_variable(tolua_S, "attachedCardCount", tolua_get_CardRecognization_AttachedCardCount, tolua_set_CardRecognization_AttachedCardCount);
后来发现,cocos引擎里面,但凡tolua_variable调用的地方,都不是在auto目录下,而是在manual目录下。
QQ问了一个老同事,说他们也没有导出过变量,这种导出变量的逻辑本身也不合理。
quick的QQ群里问大神“tulua工具有没有大神用过 是不是只能导出自己写的类里面的 function 不能导出变量啊 求指导”,后来有个人回复说“本来就不能导出变量啊”
好吧,这我才最终确定,tolu++不能导出变量,以前写的应该都是后来手动加的。如果我这个说法有误,还请大家指导啊。
真机运行前,在android项目的jni目录下的mk文件中加入你的base下面的cpp文件。