cocos2d-x 3.0rc0 - bindings-generator 问题与解决

时间:2022-10-26 08:42:29
本想利用 cocos2d-x 自付的工具 bindings-generator 来将专案内的几个自写控件 binding 到 lua 下便于在 script 下控制,结果……真是他喵的坑啊....QAQ

cocos2d-x 3.0rc0 范例的 simple_test 的环境太单纯了,并且没有用到 cocos2d 内的任何物件,故!在撰写自己的 .ini 档时会遇上一狗票问题,于是要回头参考 tools/tolua 底下 cocos2d-x 本身的 lua binding 设定,这个说明能详细点吗? ~___~

把遇到的几个问题列一下,供大夥儿参考一下。

问题1:

于 Win7 或 Win8 环境下,如果自订的类别有参考到 cocos2d-x 类,写完自个儿的 .ini 档后俐落的直接执行,会在执行 .bat 后看到类似的错误:

Errors in parsing headers:
1. <severity = Warning,
location = <SourceLocation file None, line 178, column 9>,
details = "'__WCHAR_MAX__' macro redefined">
2. <severity = Fatal,
location = <SourceLocation file '../../../Evo/include/TalkWidgety.h', line 38, column 10>,
details = "'cocos2d.h' file not found">

好,这个很直觉,请在 .ini 设定档里加上 cocos2d-x headers 的路径。

于是,就近搬移  cocos2dx.ini  里对于 cocos2d-x 内路径的设定。当然,如果还有用到其他的如 ui 或是 cocostudio 的话,要一并移进来。

待会儿会在下头将完成的范例贴一下就会明白这儿在说些啥玩意。

问题2:

搬移完 cocos2d-x 等相关的 header 路径后心想这应该就搞定了吧?

BUT!天底下哪有这么便宜的事!

执行后赫然喵到下面的错误…… TAT

Errors in parsing headers:
1. <severity = Warning,
location = <SourceLocation file None, line 179, column 9>, details = "'__WCHAR_MAX__' macro redefined">
2. <severity = Warning, location = <SourceLocation file '../../../Evo/include/TalkWidgety.h', line 27, column 9>,
details = '#pragma once in main file'>
3. <severity = Fatal,
location = <SourceLocation file 'D:../../../cocos/base\\CCConsole.h', line 30, column 10>,
details = "'BaseTsd.h' file not found">

惨!这下该怎么办……

花了点时间看了下产生 cocos2d-x 的  genbindings.py  才恍然大悟,原来要加上 -U__MINGW32__  的 undef 来避免问题。

原因?自己去看 CCConsole.h 的错误点就知道问题在哪了!这里不想多说,伤心啊!

解决以上两个问题的 .ini 如下,仅供参考:

--------------------------------------------------------------------------------------------
[evo]

prefix = evo_bindings

target_namespace = evo

cpp_namespace = Evo

# 自定义的变数,偷懒用
evo_root = ../../../../Evo
evo_header = %(evo_root)s/include
cocosdir = ../../../

android_headers = -I%(androidndkdir)s/platforms/android-14/arch-arm/usr/include -I%(androidndkdir)s/sources/cxx-stl/gnu-libstdc++/4.7/libs/armeabi-v7a/include -I%(androidndkdir)s/sources/cxx-stl/gnu-libstdc++/4.7/include
android_flags = -D_SIZE_T_DEFINED_

clang_headers = -I%(clangllvmdir)s/lib/clang/3.3/include
clang_flags = -nostdinc -x c++ -std=c++11

# 从 cocos2dx.ini 等搬过来的
cocos_headers = -I%(cocosdir)s/cocos/2d -I%(cocosdir)s/cocos/ui -I%(cocosdir)s/cocos/base -I%(cocosdir)s/cocos/physics -I%(cocosdir)s/cocos/2d/platform -I%(cocosdir)s/cocos/2d/platform/android -I%(cocosdir)s/cocos/math/kazmath -I%(cocosdir)s/extensions -I%(cocosdir)s/external -I%(cocosdir)s/cocos/editor-support -I%(cocosdir)s
cocos_flags = -DANDROID -U__MINGW32__

evo_headers = -I%(evo_root)s/include

extra_arguments = %(android_headers)s %(clang_headers)s %(cocos_headers)s %(evo_headers)s %(android_flags)s %(clang_flags)s %(cocos_flags)s %(extra_flags)s

headers = %(evo_header)s/TalkWidget.h
classes = TalkWidget

remove_prefix =
skip =
base_objects =
abstract_classes =
classes_have_type_info = no
rename =
rename_functions =
rename_classes =
# classes for which there will be no "parent" lookup
classes_have_no_parents =

# base classes which will be skipped when their sub-classes found them.
base_classes_to_skip =

# Determining whether to use script object(js object) to control the lifecycle of native(cpp) object or the other way around. Supported values are 'yes' or 'no'.
script_control_cpp = no

---------------------------------------------------------------------------------------

问题3:

如果自定义的类别里有自行定义的 namespace 时,跑 .bat 后看 output log 的最后一行会发现这样的错误:

Exception: The namespace (Evo::TalkWidget) conversion wasn't set in 'ns_map' section of the conversions.yaml

好吧,看错误内容……来去找一下  conversions.yaml  这个档,位置应该在  /tools/bindings-generator/targets/lua  底下,直接用文字编辑器打开来看。

我勒了个去!果然要把自订的 namespace 加到 ns_map 的变数中,那个 .ini 里的 cpp_namespace 作用果然只是用来卖萌的吧....=A=

要加的内容如下:

---------------------------------------------------------------------------------------
ns_map:
"cocos2d::extension::": "cc."
"cocos2d::ui::": "ccui."
"cocos2d::": "cc."
"spine::": "sp."
"cocostudio::": "ccs."
"cocosbuilder::": "cc."
"CocosDenshion::": "cc."
"Evo::": "evo."
---------------------------------------------------------------------------------------

问题4:

解决以上三个问题后,我的老天爷啊!很尴尬的是居然又遇上一个鸟问题,错误如下:

File ../../tools/bindings-generator/evo/../generator.py", line 220, in from_type
(ret_type, params) = r.groups()
AttributeError: 'NoneType' object has no attribute 'groups'

……无言以对。

花了点时间看了下  generator.py  才发现,原来在  generator.py  的 line  219 :

r = re.compile('function<(\S+) \((.*)\)>').search(cdecl.displayname)

这里并没有考虑到会有人在类别里写  std::function<Object*()>  或  std::function<Object&()>  这样回传物件 pointer 或是 reference 的 functor,所以 regex 解析到坏掉。

也就是说,如果你的 code 里写了像这样的,请换个写法吧!

class TalkWidget : public cocos2d::ui::Widget
{
public:
....

bool setParseMethod(std::function<std::string&(const std::string&, const int)> &func);

....
};

如上面的 setParseMethod, func  是一个会回传 std::string reference ( std::string& ) 的 functor,这样子写就不行!

把整个 cocos2d-x 3.0rc0 找了遍……赫!果然整个 cocos2d-x 3.0rc0 里的 function functor 都是回传标准型别或干脆就是不回传任何玩意的  void 。唉!真他喵的,踩到雷了……

由于不想多花时间去看整个  generator.py ,所以,山不转路转,换个写法就好了。 =___=

[2014-5-2 注:到目前为止 3.0 正式版,完全没有解决  c++11 functional  与  lambda function  参数自动绑定到 lua 中的任何解决方法,所以,问题四就直接无视吧!]

但是,麻烦有看到的大大请帮忙提醒一下要改正这个问题啊!这个是明显的 bug 而不是说明不详细了!

花了整整一下午才搞定,好累……看到这里,希望多少能提供点帮助给遇上一样问题的人。

以上!