Qt编写地图综合应用24-miniblink内核

一、前言

用Qt做项目过程中，遇到需要用到浏览器控件的项目，可能都会绕不开一个问题，那就是从Qt5.6版本开始mingw编译器的Qt构建套件，不再提供浏览器控件了，之前还可以用webkit控件，这下很多项目要么选择5.6以下版本，要么选择msvc的构建套件，而且大部分的msvc构建套件还不自带浏览器控件，也需要自己编译，只有原配的构建套件比如Qt5.9+VS2015、Qt5.12+VS2017这种搭配才可能有浏览器控件，不然就算你勾选了浏览器控件也不会安装，这样就使得很多依赖浏览器控件的项目比较被动，于是必须寻找一个轻量级的浏览器控件来替代，比如cef、miniblink，个人更倾向于miniblink，用法极其简单，依赖极其精简就一个dll，在linux和mac系统上本来qt就一直会有浏览器控件，所以也就不涉及到跨平台的问题，所以miniblink暂支持windows的缺点也就不算缺点了。

miniblink是一个追求极致小巧的浏览器内核项目，全世界第三大流行的浏览器内核控件。其基于chromium最新版内核，去除了chromium所有多余的部件，只保留最基本的排版引擎blink。miniblink保持了10M左右的极简大小，是所有同类产品最小的体积，同时支持windows xp、npapi。miniblink的作者非常牛逼，QQ暱称叫扫地僧，犹如天龙八部中的扫地僧一般，极其隐秘又武功极高，精通各种绝技，确实相当的屌。

qt+miniblink用法步骤：

• 第一步：调用wkeSetWkeDllPath函数加载dll文件路径，一个项目只需要执行一次。
• 第二步：调用wkeInitialize初始化动态库，一个项目只需要执行一次。
• 第三步：调用wkeCreateWebWindow创建一个浏览器控件，传入句柄。
• 第四步：调用wkeOnLoadingFinish注册回调加载完成信号，有需要才注册。
• 第五步：调用wkeJsBindFunction注册回调接收数据的方法，一定要放在这里在网页加载前执行。
• 第六步：调用wkeLoadURL加载网址、wkeLoadFile加载网页文件、wkeLoadHtmlWithBaseUrl加载网页内容。
• 第七步：调用wkeRunJS执行js函数，超级简单。
• 第八步：调用wkeFinalize释放资源，只要执行一次，在整个项目结束的时候。

qt+miniblink完整demo开源地址：
https://gitee.com/feiyangqingyun/QWidgetDemo/tree/master/miniblink
https://github.com/feiyangqingyun/QWidgetDemo/tree/master/miniblink

二、功能特点

1. 同时支持在线地图和离线地图两种模式。
2. 同时支持webkit内核、webengine内核、miniblink内核、IE内核。
3. 支持设置多个标注点，信息包括名称、地址、经纬度。
4. 可设置地图是否可单击、拖动、鼠标滚轮缩放。
5. 可设置协议版本、秘钥、主题样式、中心座标、中心城市、地理编码位置等。
6. 可设置地图缩放比例和级别，缩略图、比例尺、路况信息等控件的可见。
7. 支持地图交互，比如鼠标按下获取对应位置的经纬度。
8. 支持查询路线，可设置起点位置、终点位置、路线模式、路线方式、路线方案（最少时间、最少换乘、最少步行、不乘地铁、最短距离、避开高速）。
9. 可显示点线面工具，可直接在地图上划线、点、矩形、圆形等。
10. 可设置行政区划，指定某个城市区域绘制图层，在线地图自动输出行政区划边界点集合到js文件给离线地图使用。
11. 可静态或者动态添加多个覆盖物。支持点、折线、多边形、矩形、圆形、弧线、点聚合等。
12. 提供函数接口处理经纬度解析成地址和地址解析成经纬度座标。
13. 提供的demo直接可以单独选点执行对应的处理比如路线查询。
14. 可以拿到路线查询到的点座标信息集合，比如用于机器人座标导航等。
15. 封装了丰富的函数比如删除指定点和所有点，删除指定覆盖物和所有覆盖物等。
16. 标注点弹框信息可以自定义内容，标准html格式。
17. 标注点单击事件可选 0-不处理 1-自己弹框 2-发送信号。
18. 标注点可设置动画效果 0-不处理 1-跳动 2-坠落
19. 标注点可设置本地图片文件等。
20. 函数接口友好和统一，使用简单方便，就一个类。
21. 支持js动态交互添加点、删除点、清空点、重置点，不需要刷新页面。
22. 支持任意Qt版本、任意系统、任意编译器。

三、体验地址

1. 体验地址：https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A 提取码：o05q 文件名：bin_map.zip
2. 国内站点：https://gitee.com/feiyangqingyun
3. 国际站点：https://github.com/feiyangqingyun
4. 个人主页：https://blog.csdn.net/feiyangqingyun
5. 知乎主页：https://www.zhihu.com/people/feiyangqingyun/

四、效果图

五、相关代码

#ifndef MINIBLINK_H
#define MINIBLINK_H

#include <QWidget>
#include "wke.h"

class miniblink : public QWidget
{
    Q_OBJECT
public:
    explicit miniblink(QWidget *parent = 0);

    //初始化资源
    static void init();
    //释放资源
    static void release();

protected:
    //设置浏览器控件自动适应大小
    void resizeEvent(QResizeEvent *);

private:
    //浏览器控件对象
    wkeWebView webView;

signals:
    //网页载入完成
    void loadFinished(bool ok);
    //收到网页发出来的数据
    void receiveDataFromJs(const QString &type, const QVariant &data);

public:
    //给回调用的函数
    void loadFinish(bool ok);
    void receiveData(const QString &type, const QVariant &data);

public slots:
    //加载网址或者本地文件
    void load(const QString &url, bool file = false);
    //加载html内容
    void setHtml(const QString &html, const QString &baseUrl);
    //执行js函数
    void runJs(const QString &js);
};

#endif // MINIBLINK_H
#include "miniblink.h"
#include "qapplication.h"
#include "qdebug.h"

void onLoadingFinish(wkeWebView, void *param, const wkeString, wkeLoadingResult result, const wkeString)
{
    //qDebug() << "onLoadingFinish" << result;
    //在注册函数的地方就已经传入了类指针
    miniblink *widget = (miniblink *)param;
    //0 = WKE_LOADING_SUCCEEDED, 1 = WKE_LOADING_FAILED, 2 = WKE_LOADING_CANCELED
    widget->loadFinish(result == 0);
}

jsValue WKE_CALL_TYPE objName_receiveData(jsExecState es, void *param)
{
    if (0 == jsArgCount(es)) {
        return jsUndefined();
    }

    //挨个取出参数,设定的通用方法,只有两个参数
    jsValue arg0 = jsArg(es, 0);
    jsValue arg1 = jsArg(es, 1);
    if (!jsIsString(arg0)) {
        return jsUndefined();
    }

    //在注册函数的地方就已经传入了类指针
    miniblink *widget = (miniblink *)param;
    QString type = QString::fromStdString(jsToString(es, arg0));
    QVariant data = QString::fromStdString(jsToString(es, arg1));
    widget->receiveData(type, data);
    return jsUndefined();
}

miniblink::miniblink(QWidget *parent) : QWidget(parent)
{
    //第一步先初始化动态库
    init();
    //第二步初始化浏览器控件
    //创建一个浏览器控件,放入句柄
    webView = wkeCreateWebWindow(WKE_WINDOW_TYPE_CONTROL, (HWND)this->winId(), 0, 0, this->width(), this->height());
    //关联完成信号
    wkeOnLoadingFinish(webView, onLoadingFinish, this);
    //设置浏览器控件可见
    wkeShowWindow(webView, TRUE);
    //注册通用的接收数据的方法,一定要放在这里在网页加载前执行
    wkeJsBindFunction("objName_receiveData", objName_receiveData, this, 2);
}

void miniblink::init()
{
    //全局只需要初始化一次
    static bool isInit = false;
    if (!isInit) {
        isInit = true;
        //不同的构建套件位数加载不同的动态库
#ifdef Q_OS_WIN64
        QString file = qApp->applicationDirPath() + "/miniblink_64.dll";
#else
        QString file = qApp->applicationDirPath() + "/miniblink.dll";
#endif
        const wchar_t *path = reinterpret_cast<const wchar_t *>(file.utf16());
        wkeSetWkeDllPath(path);
        bool ok = wkeInitialize();
        qDebug() << QString("init miniblink %1").arg(ok ? "ok" : "error");
    }
}

void miniblink::release()
{
    wkeFinalize();
}

void miniblink::resizeEvent(QResizeEvent *)
{
    wkeResize(webView, this->width(), this->height());
}

void miniblink::loadFinish(bool ok)
{
    emit loadFinished(ok);
}

void miniblink::receiveData(const QString &type, const QVariant &data)
{
    emit receiveDataFromJs(type, data);
}

void miniblink::load(const QString &url, bool file)
{
    const char *temp = url.toLocal8Bit().data();
    if (file) {
        wkeLoadFile(webView, temp);
    } else {
        wkeLoadURL(webView, temp);
    }
}

void miniblink::setHtml(const QString &html, const QString &baseUrl)
{
    wkeLoadHtmlWithBaseUrl(webView, html.toLocal8Bit().data(), baseUrl.toLocal8Bit().data());
}

void miniblink::runJs(const QString &js)
{
    wkeRunJS(webView, js.toLocal8Bit().data());
}