详解针对genbindings.py 脚本

2015年03月24日 11:04 1 点赞 0 评论 更新于 2025-11-21 18:23

1. 自定义配置文件

衔接上一篇关于 cocos2dx.ini 文件的内容,我们需要自定义一个 custom_api.ini 文件,后续会用到该文件。

2. 查找关键信息

在使用 genbindings.py 脚本之前,我们首先要找到所需的关键内容。在 frameworks/cocos2d-x/tools/tolua 目录下的 genbindings.py 文件中搜索 cmd_args

3. 添加自定义配置并注释其他文件

将自定义的 custom_api.ini 文件添加到相应配置中,并注释掉其他 .ini 文件(这些文件不需要重新生成),具体操作可参考下图(此处原文未提供图,若有图可补充在相应位置)。

4. 运行脚本

运行方式

在终端运行 genbindings.py 脚本。为了方便操作,我直接编写了一个批处理文件 .bat 来执行该脚本。

成功条件

只要所需的工具都已下载、安装并正确配置,一般情况下脚本就能成功生成所需文件。若生成失败,基本是由于工具未正确配置导致的。

5. 查找生成文件

C++ 桥接文件

脚本生成成功后,可在 frameworks/cocos2d-x/cocos/scripting/lua-bindings/auto 目录中找到生成的 C++ 桥接文件 lua_custom_api_auto.cpplua_custom_api_auto.hpp

Lua 调用接口文件

同时,在 frameworks/cocos2d-x/cocos/scripting/lua-bindings/auto/api 目录中也能找到提供给 Lua 调用的接口文件。