QtWebkits如何向QtWebEngine过渡

1. 前言

很遗憾,QtWebkits在Qt5.6以上版本被淘汰了,对于这个接口良且和其他类例如QWebFrame完美结合的组件就这么没了,我只能表示惋惜。对于QtWebEngine新的组件,不得不承认它从Chromium继承过来的强大的性能,但接口上还不是很丰富,和其他类的交互也不是很完美,期待Qt能够对其进行进一步开发,我也会不断的升级Qt,尝试新的接口。

目前而言,QWebEngine有以下缺点:

  • MinGW版本的Qt不支持,即便是Qt5.6版本以上也是不支持的。仅仅支持MSVC版本。
  • 接口暂时不丰富
  • 无法和QWebFrame进行交互(使用了新的QWebChannel和QWebEnginePage组合进行交互)

基于我们的GPS定位项目,参考:[Qt开发北斗定位系统融合百度地图API及Qt程序打包发布] ,我们在该项目中使用的是Qt5.5版本,在嵌入的浏览器作为加载地图用的是QWebKits组件,我们将其升级使用QWebEngine进行加载地图,和HTML和JS进行交互。我们以此为例,进行简要的介绍。

2. 两者的UI上面的区别

你刚刚升级到Qt5.6版本可能在UI设计界面时候在组件中找不到QWebEngineView这个组件,无法从这里拖拽这个组件到你的UI界面上。我查阅了很多资料,看到别人经常使用 ui->webEngineview->... 这样,我甚至怀疑是否因为安装了其他版本的Qt影响到了我,我卸载了包含5.6版本的所有Qt,又重新安装了一遍,但是再重启软件后,依然没有发现QWebEngineView这个鬼东西。在Qt5.5中你也能发现有这样的组件QWebView,如图1所示:

QWebView组件可以通过QWebFrame来进行HTML和JS的通信,如果过渡到QWebEngineView,要是没有这个UI组件的话,我如何把浏览器嵌入到软件界面,实现网页和软件的混合编程呢。根据官方提供的一个例子中,cookiebrowser中找到了答案,这也是官方给的例子中,唯一一个嵌入到网页中的!(不得不说,Qt给的例子很模糊很差!) 经过研究, QWebEngineView使用widget组件,拖拉出来是一个透明的组件,对着组件按右键->promote to.. ->选择QWebEngineView,如图2,完成操作。

有了QWebEngineView这个UI组件,我们可以在程序中调用其成员、方法和函数完成操作了。

3. 使用方法区别

在使用方法上有很大的区别,可以说是两个完全不同理念的东西,这里为了更通俗易懂,就不粘贴API文档中函数解释,就用最常用的!

#include     // 基本组件
#include         // HTML页面
#include           // C++和JS/HTML双向通信,代替了已淘汰的QtWebFrame的功能

在我们的项目中一开始就要引入这样的组件,但在我们的项目中,没有频繁用到与JS的互相交互,所以这里暂时没有关于QWebChannel的使用方法,只留下这个接口。

以下为区别:


  • 在WebKits中的初始化:
QUrl url(strMapPath);        // strMapPath为QString类,是你html文件的路径
ui->webView->load(url);
ui->webView->setContentsMargins(0,0,0,0);
ui->webView->setTextSizeMultiplier(1);//设置网页字体大小
connect(ui->webView->page()->mainFrame(), SIGNAL(javaScriptWindowObjectCleared()),
            this, SLOT(slotPopulateJavaScriptWindowObject()));

我们会使用load方法加载html所在的界面,使用QWebFrame类的mainFrame()中的SIGNAL和槽函数

void Widget::slotPopulateJavaScriptWindowObject()
{
    ui->webView->page()->mainFrame()->addToJavaScriptWindowObject("ReinforcePC", this);
}

进行响应。参考文献1:《javascript调用qt》,可以解释这个槽函数的重要性。

  • 在WebEngine中的初始化:
QWebEnginePage *page = new QWebEnginePage(this);  // 定义一个page作为页面管理
QWebChannel *channel = new QWebChannel(this);     // 定义一个channel作为和JS或HTML交互
page->load(strMapPath);                            // page上加载html路径
page->setWebChannel(channel);                    // 把channel配置到page上,让channel作为其信使
ui->webEngine->setPage(page);                    // 建立page和UI上的webEngine的联系

如果你的 初始化程序写到这里,当你运行程序的时候,无论是webKits里的WebView还是新版的webEngineView,你的UI界面上的那个组件区域就会显示那个html文件了。

到此,我们完成了两者的初始化。


  • WebKits组件中的运行JS:

我们以按钮的槽函数为例,当点击按钮时,会向JS发送命令,运行JS脚本,我们这里发送的是将显示变为卫星图的JS命令:

void Widget::on_pushButtonStreetMap_clicked()
{
    QWebFrame *frame = ui->webView->page()->mainFrame(); // 定义一个QWebFrame负责交互
    QString cmd = QString("showStreetMap()"); // JS的命令
    frame->evaluateJavaScript(cmd);              // 使用frame下的命令运行该命令
}

从这个例子中我们也可以看到,QWebFrame是JS交互的关键。

  • WebEngine组件中的运行JS:

还是以该槽函数为例:

void Widget::on_pushButtonSatelliteMap_clicked()
{
    QString cmd = "showSatelliteMap()";
    ui->webEngine->page()->runJavaScript(cmd);        // 直接page()下就可以运行
}

在JS单向通信中十分简单,也不需要使用QWebChannel信使,但该方法runJavaScript()无法在构造函数中使用,原因不明。也可以这样使用:

connect(ui->webEngine,&QWebEngineView::loadFinished,[=](int){
             ui->webEngine->page()->runJavaScript(cmd1);

第二个参数SIGNAL位置的,只能使用这样的方式调用,如果使用SIGNAL(....loadFinished),报错。

4. 总结

通过这样的方法,我们就完成了一个初级的过渡。本人由于是研究嵌入式的程序员,只是上位机学习简单的Qt做一点点当成辅助开发,并没有什么高深的Qt技术,也正在学习中,欢迎讨论。

参考文献:

[1] 在水一方著.javascript调用Qt.CSDN博客.2011-07-18.

[2]Я!ńɡ著.QT5利用chromium内核与HTML页面交互.CNBLOGS. 2015-11-17.

[3]liuyez123著.[实现QT与HTML页面通信]. CSDN博客. 2016-01-13.

posted @ 2017-07-17 13:15 Carlos·Wei at Yichun

你可能感兴趣的:(qt)