Qt下开发基于QGIS的应用程序

这篇具有很好参考价值的文章主要介绍了Qt下开发基于QGIS的应用程序。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

目的

由于有在背景地图上进行动态轨迹（曲线）显示的需要，故采用Qt+QGIS的方案！

版本说明

Qt5.12.12，VS2015编译器，QGIS3.10.1。
在配置之前，电脑是新装机的系统，没有任何相关软件版本。

1、Qt的安装

在Qt官网（https://download.qt.io/）或国内镜像网站（https://mirrors.tuna.tsinghua.edu.cn/qt/archive/qt）或网络搜索下载Qt5.12.12安装包。

下载完成进入安装，如下图，首先需要进行账号的注册。
Qt下开发基于QGIS的应用程序,qt,开发语言
全部next后到Select Components,具体按照下面两张图进行组件选择：

之后全部按next，直到等待安装完成。

2、MSVC套件与Windows 10 SDK的下载

Visual Studio Installer可以提供这两个东西的下载。百度官网就能下载Visual Studio Installer
具体的安装选择只需要下图所示的3个勾，其余的都可以取消。
Qt下开发基于QGIS的应用程序,qt,开发语言

3、QGIS开发有关的库文件下载

在官网下载OSGeo4W network installer。
Qt下开发基于QGIS的应用程序,qt,开发语言
下载后运行

这里选择Direct Connection

这里选择download.osgeo.org

搜素栏输入qgis

点击Libs后的小圈，变成Install

一直点击下一步，就可以开始下载了

但是下载速度一般是比较慢的。所以还是推荐直接下载其他人下载好的压缩包。

下载解压后的文件组成如下图：
Qt下开发基于QGIS的应用程序,qt,开发语言

4、环境搭建

运行Qt Creator
Qt下开发基于QGIS的应用程序,qt,开发语言
新建工程后，双击Qt Widgets Application

一直下一步，直到Kit Selection，可以只选择MSVC2015

Qt下开发基于QGIS的应用程序,qt,开发语言
完成后如下图

左下角选择Release,编译运行，成功显示空白窗口

工程文件夹里出现build-test_1-Desktop_Qt_5_12_12_MSVC2015_64bit-Release文件夹。
到此为止，已经可以成功在Qt中使用MSVC编译器

这个过程中，有可能无法运行rc.exe的编译错误，把C:\Program Files (x86)\Windows Kits\10\bin\10.0.20348.0\x64文件夹下的rc.exe、rcdll.dll文件拷贝到C:\Qt\Qt5.12.12\5.12.12\msvc2015_64\bin下即可。

还有可能出现的问题，运行时会提示
Starting E:\QTex\build-untitled-Desktop_Qt_5_12_12_MSVC2015_64bit-Debug\debug\untitled.exe …
程序异常结束。
The process was ended forcefully.
E:\QTex\build-untitled-Desktop_Qt_5_12_12_MSVC2015_64bit-Debug\debug\untitled.exe crashed.
这是少了动态链接库
可以直接双击E:\QTex\build-untitled-Desktop_Qt_5_12_12_MSVC2015_64bit-Debug\debug\untitled.exe运行，会提示具体缺少哪些动态库，直接从电脑上找到拷贝过来即可
把vcruntime140d.dll从C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\debug_nonredist\x64\Microsoft.VC140.DebugCRT拷贝到C:\Qt\Qt5.12.12\5.12.12\msvc2015_64\bin下即可。

下面进行Qgis开发环境搭建。

5、QGIS开发环境搭建

注意：在Qt下开发QGIS程序时，都是构建Release版本。记得在Qt左下角选构建Release。

打开OSGeo4W64文件夹
Qt下开发基于QGIS的应用程序,qt,开发语言
拷贝OSGeo4W64\apps\Qt5\bin目录下全部dll到exe目录(在工程文件的release文件夹下)下。

拷贝OSGeo4W64\apps\Qt5\plugins 目录下的platforms目录到exe目录下plugins目录（自己新建）里。

拷贝OSGeo4W64\apps\qgis-ltr\bin 目录下全部文件考到exe目录下。
拷贝OSGeo4W64\bin 目录下全部dll文件和gdalplugins目录考到exe目录下。
把OSGeo4W64\apps\qgis-ltr\plugins目录下全部文件考到exe同级plugins目录下。
拷贝OSGeo4W64\share 中gdal目录到exe同级的share目录下（自己新建）。
在exe目录下新建一个qt.conf文件，填写如下内容，用txt写完之后换个拓展名就可。
Qt下开发基于QGIS的应用程序,qt,开发语言

到此为止，文件移动完毕.
下面打开工程，修改pro文件

其中有关文件夹位置根据自己下载的情况进行修改
修改main函数

刚开始修改会显示找不到qgsapplication.h文件，那是因为还没有编译pro文件，直接编译运行就可以了。

修改mainwindow.h文件
Qt下开发基于QGIS的应用程序,qt,开发语言
修改mainwindow.cpp文件

在左下角选择构建Release版本，编译运行，显示绿幕，Qgis开发环境已成功搭建。

6、展示网页地图

双击mainwindow.ui，进行ui设计
Qt下开发基于QGIS的应用程序,qt,开发语言
右键画布，点击添加工具栏
点击画布左下角新建动作，设定对象名称为actshowmap

点击OK，发现Action Editor框内多出一栏动作，将其拖拽至上方工具栏处，发现下面使用那里已经打勾，说明动作已成功导入工具栏。

新建动作“退出”，重复上面操作
Qt下开发基于QGIS的应用程序,qt,开发语言
点击下方signals and slots editor,点击绿色加号，如下图选择栏目

编译运行，成功展示出工具栏，点击退出也可实现退出，说明成功实现工具栏动作。

下面进行展示地图的代码实现。
在mainwindow.h文件中，定义函数addLayers(),定义图层集mapLayerSet，添加头文件，如下

#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include<QtMath>
#include <QMainWindow>
#include <qgsmapcanvas.h>
#include <QList>

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

public slots:
    void addLayers();

private:
    Ui::MainWindow *ui;
    QgsMapCanvas* mapCanvas;
    QList <QgsMapLayer*>  mapLayerSet;
};
#endif // MAINWINDOW_H

在mainwindow.cpp文件中写addLayer(),这里添加的是栅格图层，如下

void MainWindow::addLayers()
{
    QgsRasterLayer* rasterLayer = 0;
    auto url = QString("http://webrd02.is.autonavi.com/appmaptile?lang=zh_cn&size=1&scale=1&style=8&x=105&y=48&z=7");
    rasterLayer= new QgsRasterLayer(url);
    if ( !rasterLayer->isValid() )
    {
        QMessageBox::critical( this, "error","layer is invalid" );
        return;
    }
    QgsProject::instance()->addMapLayer(rasterLayer);
    mapLayerSet.append( rasterLayer );
    mapCanvas->setExtent( rasterLayer->extent() );
    mapCanvas->setLayers( mapLayerSet );
    mapCanvas->setVisible( true );
    mapCanvas->freeze( false );
    mapCanvas->refresh();
}

图层url选择的是
http://webrd02.is.autonavi.com/appmaptile?lang=zh_cn&size=1&scale=1&style=8&x=105&y=48&z=7
添加头文件:

#include <qgsrasterlayer.h>
#include <QMessageBox>
#include <qgsproject.h>

如果之前环境搭建好了，这里应该是不会显示找不到文件的

最后添加显示地图按键的connect，如下：

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    mapCanvas = new QgsMapCanvas();
    this->setCentralWidget(mapCanvas);
    mapCanvas->enableAntiAliasing(true);
    mapCanvas->setCanvasColor( QColor(0, 255, 0));
    mapCanvas->setVisible(true);

    connect( ui->actshowmap, SIGNAL( triggered() ), this, SLOT( addLayers() ) );
}

编译运行，发现点击展示地图按钮没有反应，在下方应用程序输出栏可以看见原因是
Cannot find proj.db
使用everthing搜素文件proj.db和proj.lib,在exe目录新建文件夹proj，将这两个文件复制进去
Qt下开发基于QGIS的应用程序,qt,开发语言
在main函数中添加路径

#include "mainwindow.h"

#include <QApplication>
#include <QtMath>
#include "qgsapplication.h"

int main(int argc, char *argv[])
{
    QDir dir;
    QString PROJ_LIB_PATH = dir.currentPath() + "/proj";
    qputenv("PROJ_LIB",PROJ_LIB_PATH.toLatin1());

    QString PROJ_DB_PATH = dir.currentPath() + "/proj";
    qputenv("PROJ_DB",PROJ_DB_PATH.toLatin1());

    QgsApplication app(argc, argv, true, QString());
    MainWindow *pMainWindow = new MainWindow(0);
    pMainWindow->show();
    app.setActiveWindow(pMainWindow);
    int iRet = app.exec();
    delete pMainWindow;
    return iRet;
}