最近有一个项目要求基于qgis+QT进行二次开发开发,要使用到qgis平台。陆陆 续续花了差不多两个多星期,在把开发环境搭建起来。
首先就面临2种选择,一种 到qgis官网下载源码,进行编译,此 情况我走了一般编译成功,但是很麻烦,还有很多问题没有解决。
另外,直接在线下载, 官方网站 编译好的二次开发SDK包。本篇 文章采用的是第2种方法,简单快捷,但是也遇到各种各样的问题,现记录如下,尽可能的详细。期间看过很多大神的博客,在此表示感谢。
一,开发环境《注意很重要,我就是在此没有注意,遇到各种坑,耽误不少时间》
VS2015 + QT5.10.1 + OSGeo4W
注意,QT 平台的版本与qgis下载的版本有关,本文采用QT是32位, 通过OSGeo4w下载也是qgis也是32位,如果使用qt是64位,那么应该使用OSGeo4w64来下载qgis;
如果下载qgis-ltr(官网的长期支持版,qgis 2.18),那么建议qt采用5.0以下的版本;
如果下载qgis 是3.0版本以上,个人建议qt版本,下载高于qt5.9.2
另外如果是使用VS2013,那么好像不能编译qgis3.0版本以上的,c++11个部分语法报错。好了不啰嗦了,正式介绍了。
二,关于qgis二次开发SDK下载
官网网站 https://www.qgis.org/en/site/
下载OSGeo4w https://www.qgis.org/en/site/forusers/download.html 自己选择32位还是64位, 这个软件的下载速度很慢,要有耐心,反正在帝都只有一般20-40kb/s,还容易出错。
osgeo4w-setup-x86.exe ,安装使用默认路径,直接上图
1 选择Andvance Install
2 Install from Intenet
3 中间省略几步,使用默认即可
4 到这个步骤,在搜索框内输入qgis, desktop表示下载安装桌面版的qgis,lib表示我们要二次开发sdk库
5 我在这里将qgis3.2版本, qgis2.18长期版都下载下来了, 实际可根据自己的情况进行选择,下载
过程很漫长,并且会下载很多依赖的库。很 耗时。
三,vs2015搭建工程
由于我们qgis的二次开发包,是release版本,所以我们的vs工程环境,编译也应该是release版本,否则报各种错误,
大致是debug与release版本混淆导致,错误如下图所示。
对工程项目进行配置,加载第3方的 qgis库,
1,项目工程,右键属性-->C/C++ 点击常规,附加包含目录,点击文件夹图标,添加qgis库的头文件目录,我在此处选择的是
qgis3.2版本。
C:\OSGeo4W\include
C:\OSGeo4W\apps\qgis\include
2, 链接器中,常规 选择qgis的库
3,链接器,输入,书写加载qgis库,
qgis_core.lib qgis_app.lib qgis_gui.lib
4, 关于测试工程的代码,如下,非本人原创,参考其他博客得来。
首先,main.cpp
#include "gisTest2.h"
#include
int main(int argc, char *argv[])
{
QgsApplication a(argc, argv, true);
QgsApplication::setPrefixPath("C:/OSGeo4W/apps/qgis", true);
QgsApplication::initQgis(); //初始化QGIS应用
gisTest2 w; //创建一个窗体,类似于Qt
w.show();
return a.exec();
}
gisTest2.cpp代码如下:
#include "gisTest2.h"
#include
#include
#include
#include
gisTest2::gisTest2(QWidget *parent)
: QMainWindow(parent)
{
this->resize(600, 400);
// create the menus and then add the actions to them.
fileMenu = this->menuBar()->addMenu("File");
openFileAction = new QAction("Open", this);
this->connect(openFileAction, SIGNAL(triggered(bool)), this, SLOT(on_openFileAction_triggered()));
fileMenu->addAction(openFileAction);
// initialize the map canvas
mapCanvas = new QgsMapCanvas();
this->setCentralWidget(mapCanvas);
mapCanvas->setCanvasColor(QColor(255, 255, 255));
mapCanvas->setVisible(true);
mapCanvas->enableAntiAliasing(true);
}
void gisTest2::on_openFileAction_triggered() {
addVectorLayer();
}
void gisTest2::addVectorLayer()
{
QString fileName = QFileDialog::getOpenFileName(this, tr("Open shape file"), "", "*.shp");
QStringList temp = fileName.split('/');
QString basename = temp.at(temp.size() - 1);
QgsVectorLayer* vecLayer = new QgsVectorLayer(fileName, basename, "ogr");
if (!vecLayer->isValid())
{
QMessageBox::critical(this, "error", QString("layer is invalid: \n") + fileName);
return;
}
mapCanvas->setExtent(vecLayer->extent());
layers.append(vecLayer);
mapCanvas->setLayers(layers);
mapCanvas->refresh();
}
gisTest2.h代码
#pragma once
#include
#include "ui_gisTest2.h"
#include
#include
#include
class gisTest2 : public QMainWindow
{
Q_OBJECT
public:
gisTest2(QWidget *parent = Q_NULLPTR);
private:
// create the menus and then add the actions to them.
QMenu *fileMenu;
QAction *openFileAction;
//map canvas
QgsMapCanvas *mapCanvas;
QList
public slots:
void on_openFileAction_triggered();
//
public:
void addVectorLayer();
};
四,工程项目编译或运行时,提示很多库找不到
将 C:\OSGeo4W\apps\qgis\bin
C:\OSGeo4W\bin
目录下dll文件拷贝到工程目录下,编译搞定,当然运行还是报错,根据错误提示将
C:\OSGeo4W\apps\Qt5\bin 目录下的dll库拷贝,工程目录下,一直到成功编译运行成功为止。
运行结果如下:
关于shp 文件的数据,大家可以到 国家地理信息公共服务平台 http://www.tianditu.gov.cn/index.html 下载
好了,到此初步qgis开发二次开发环境,基本搭建完成了。