Hello! 欢迎来到小浪云!


集成Qt Webkit 到cocos2d-x


前言

最近我尝试开发一个基于cocos2d的工具。之前在Win32工具中集成的调试辅助工具直接使用了Windows API,扩展起来非常麻烦。此外,Windows默认使用宽字符集,而cocos2d与lua交互时需要转换为UTF-8,过程十分繁琐。因此,我决定一次性解决这个问题。

与其他工具相比,qt更为简单,且支持跨平台。虽然本工具主要针对Windows,但为了扩展方便,直接将其设计为webview是个不错的选择。幸运的是,Qt内置了webkit组件,可以直接使用。

初识Qt

这是我第一次接触Qt,之前只是听说过,没有实际使用过。初次使用后,感觉还是相当简单的。以下是我遇到的一些问题:

  • Qt的主循环必须在主线程中运行。将其放在子线程会导致消息无法触发。虽然我觉得这点难以理解,但事实如此。由于cocos2d没有提供类似于渲染一帧的接口,我不得不使用多线程来解决这个问题。即:Qt主循环主线程,cocos2d在子线程。
  • Qt自定义了消息传递方式,即信号(signal)和槽(SLOT)。需要支持信号和槽的类必须在.h文件中添加Q_OBJECT宏。注意,必须在.h文件中添加,.cpp文件中无效。声明信号和槽时,槽需要自己实现,而信号的代码将由Qt的mocker工具生成。Qt的工具做得相当不错。
  • Qt实现了一套对象管理模式,默认对象都是全局的QApplication的子节点,删除父节点时子节点也会被删除。需要特别注意与其他对象管理方式混用的问题。我之前因为使用了STL的shared_ptr来管理自定义对象,由于全局对象析构时不保证顺序,导致shared_ptr在QApplication之后析构时,程序退出时可能会崩溃。
  • c++函数和对象绑定到Webkit的方式也很简单,只需声明为Q_INVOKABLE即可。虽然提供的访问脚本层的接口功能不太强大,但已经足够使用。

为了方便继承,可以将接口导出为C接口,然后在C++中加载并添加回调。由于Webkit默认不允许主动打开本地磁盘文件,我还增加了读取本地文件的接口。

#ifdef _MSC_VER #define DEBUGER_EXPORT __declspec(dllexport) #define DEBUGER_IMPORT __declspec(dllimport) #else #define DEBUGER_EXPORT __attribute__((visibility("default"))) #define DEBUGER_IMPORT __attribute__((visibility("default"))) #endif #pragma comment(lib, "debuger.lib") extern "C" {     typedef void(*debuger_js_fn)(const char **, size_t*, size_t, char**, size_t*);     DEBUGER_IMPORT void debuger_init_app(int argc, char** argv);     DEBUGER_IMPORT int debuger_exec(int(*fn)(int, char**), void(*exit_fn)());     DEBUGER_IMPORT void debuger_exit(int code);     DEBUGER_IMPORT void debuger_open_local_file(const char* path, size_t len);     DEBUGER_IMPORT void debuger_open_url(const char* path, size_t len);     DEBUGER_IMPORT void debuger_get_charset(char* name, size_t len);     DEBUGER_IMPORT void debuger_set_charset(const char* name);     DEBUGER_IMPORT void debuger_eval(const char* code, size_t len, char* ret, size_t* ret_len);     DEBUGER_IMPORT void debuger_invoke(const char* name, debuger_js_fn fn); <pre class="brush:php;toolbar:false">// 注册的回调函数 static void debuger_invoke_run_code(const char ** argv, size_t* argv_len, size_t argc, char** ret, size_t* ret_len) {     if (argc > 0) {         const char* code = argv[0];         addPendingCode(code);     } }  // 初始化注册 void CommandWindow::init(int argc, char** argv) {     cmd_argc_ = argc;     cmd_argv_ = argv;     // 初始化     debuger_init_app(cmd_argc_, cmd_argv_);     // 打开本地web页     debuger_open_local_file("../proj.win32/debuger.webview/index.html", 0);     // debuger_open_url("http://www.baidu.com", 0);     // 函数注入     debuger_invoke("run_code", debuger_invoke_run_code); }

}

接下来,只需导入一个Web组件即可完成。我导入了jquery、jQuery ui和codemirror。唯一需要注意的是,由于Qt线程和cocos2d处于不同线程,需要注意多线程安全。

完成后,可以通过编写Web页面来创建客户端工具,比使用C++方便得多。效果如下:

集成Qt Webkit 到cocos2d-x

点击“执行脚本”按钮,将会执行上面注入的debuger_invoke_run_code函数。非常棒吧。

所有代码已托管在:https://www.php.cn/link/007f1041969194e99b73e4e5fac7396f

相关阅读