集成Qt Webkit 到cocos2d-x-Windows系列-PHP中文网

集成Qt Webkit 到cocos2d-x

雪夜

发布： 2025-05-13 08:36:01

原创

641人浏览过

前言

最近我尝试开发一个基于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