FairyGUI在Cocos2d-x下的多平台接入和lua绑定

Cocos2d-x版本是3.16
FairyGUI库来自https://github.com/fairygui/FairyGUI-cocos2dx

接入前确保你的项目在接入前可以通过cocos compile -p xxx 命令正常编译打包，每接入一个平台都可以通过此命令编译打包以确认是否接入正常。

预备

1. 复制libfairygui到frameworks\cocos2d-x\cocos\editor-support\fairygui
2. 修改CCLabel.h的672行，void updateBMFontScale();前添加virtual

绑定tolua

编写cocos2d-x\tools\tolua\cocos2dx_fairygui.ini，修改ini里的headers字段，后面添加LuaBasicConversions_fairygui.h，这样生成的auto文件才会inlucde。还是用我的吧。

1. 修改 cocos2d-x\tools\tolua\genbindings.py，添加fairygui一行：

'cocos2dx_fairygui.ini' : ('cocos2dx_fairygui', 'lua_cocos2dx_fairygui_auto'), \

2. 修改cocos2d-x\tools\bindings-generator\targets\lua\conversions.yaml里的ns_map:下添加fairygui的命名空间"fairygui::": "fgui."，另外，还要分别在中间和底部添加下面代码，以便处理Margin类型的转换。

"Margin": "ok &= luaval_to_margin(tolua_S, ${arg_idx}, &${out_value}, \"${lua_namespaced_class_name}:${func_name}\")"
"Margin": "margin_to_luaval(tolua_S, ${in_value})"

3. 在frameworks\cocos2d-x\cocos\scripting\lua-bindings\manual下新建fairygui目录，把下面四个文件拷进去。

lua_cocos2dx_fairygui_manual.hpp
lua_cocos2dx_fairygui_manual.cpp
LuaBasicConversions_fairygui.h
LuaBasicConversions_fairygui.cpp

4. 在cmd中，切换到frameworks\cocos2d-x\tools\tolua目录，运行python genbindings.py，正常的话会在frameworks\cocos2d-x\cocos\scripting\lua-bindings\auto生成两个文件：

lua_cocos2dx_fairygui_auto.hpp
lua_cocos2dx_fairygui_auto.cpp

5. 修改frameworks\cocos2d-x\cocos\scripting\lua-bindings\manual\lua_module_register.cpp，添加

#include "scripting/lua-bindings/manual/fairygui/lua_cocos2dx_fairygui_manual.hpp"

在lua_module_register中添加

register_all_cocos2dx_fairygui_manual(L);

接入Win32

1. 在VS工程右键“添加” “现有项目”，找到libfairygui.vcxproj，在VS左侧下端选择“属性管理器”，展开libfairygui，在Debug和Release中分别添加现有属性表“cocos2dx.props”和“cocos2d_headers.props”，在cocos2d\2d目录下可以找到。
2. 在VS中的libluacocos2d下的manual中新建项fairygui，并把四个文件添加进去。
3. 打开属性表的“cocos2dx.props”,通用属性|链接器|输入|附加依赖项，添加libfairygui.lib

接入ios_mac

在xcode里的cocos2d_libs.xcodeproj下的editor-support下添加fairygui的引用，然后在Build Settings的左上角，选择cocos2d_libs（注意是蓝色图标），在User Header Search Paths中添加${SRCROOT}/../cocos/editor-support/fairygui/Classes。然后在cocos2d_lua_bindings.xcodeproj的auto和manual里添加对应的文件，貌似就可以了。

接入android

修改frameworks\cocos2d-x\cocos\Android.mk，在适当的位置添加

LOCAL_STATIC_LIBRARIES += fairygui_static
$(call import-module,editor-support/fairygui)

修改frameworks\cocos2d-x\cocos\scripting\lua-bindings\proj.android\Android.mk，
在适当的位置添加

LOCAL_SRC_FILES += ../manual/fairygui/lua_cocos2dx_fairygui_manual.cpp \
                   ../manual/fairygui/LuaBasicConversions_fairygui.cpp \
                   ../auto/lua_cocos2dx_fairygui_auto.cpp

LOCAL_C_INCLUDES
        $(LOCAL_PATH)/../../../editor-support/fairygui/Classes \
        $(LOCAL_PATH)/../manual/fairygui \

LOCAL_EXPORT_C_INCLUDES下添加
        $(LOCAL_PATH)/../manual/fairygui \

测试

测试比较简单，首先确保各平台运行正常，然后在lua里调用
fgui.UIPackage:addPackage("res/test")
加载test包即可，具体使用请参考官网http://www.fairygui.com

ps:

对了，运行tolua的时候，要用ndk r9b，然后用cocos命令编译的时候要换成r16b，不然会报错……