VS2019、Qt5.12及QGis3.16开发常见问题汇总

       在C++、Qt软件开发过程中,常常遇到一些编译错误或警告;本文将VS2019、Qt5.12.10和QGis3.16.10的二次开发过程常见的问题做了整理,供大家参考,也便于日后查阅。该内容分为四部分:VS+Qt环境搭配、VS编译常见问题、Qt常见问题、QGis二次开发常见问题。(转载请注明出处:https://www.cnblogs.com/1024bytes/p/15464404.html)


一、VS创建Qt项目
      1、安装VS2019或VS2017,编译器原则上是越新越好(此贴发布时VS2022测试版已经发布,没试过有啥新功能),VS选择需要的组件和编译器,不用全选。
      2、Qt用5.12版中最新的,我用的是Qt5.12.10(Qt5.15是向Qt6过渡的产品),组件也是根据需求选择。
      3、VS中要安装Qt Visual Studio Tools,菜单栏依次选择“扩展”-“管理扩展”-“联机”-“Visual Studio Marketplace”,在右侧搜索“Qt”,选择“Qt Visual Studio Tools”,点击下载,安装界面弹出后,关闭VS,安装完成。重启VS,可在该菜单栏看到菜单“Qt VS Tools”。在该菜单下选择“Qt Versions”配置Qt路径;创建界面可由此菜单选择“Luanch Qt Designer”。
      4、新建项目->Visual C++/跨平台->Qt,选择Qt Widgets Application。

二、VS编译常见问题
Q: “M_PI”: 未声明的标识符
A: 程序中头文件的选择,要选择math.h头文件,在cmath文件中是没有对M_PI 的定义的(现在的cmath中对M_PI好像已有定义)。选择“项目”——>”XXX属性"——>配置属性——>C/C++——>预处理器——>预处理器定义,将“_USE_MATH_DEFINES”添加进去。

Q: 源代码字符编码问题: Warning C4819 该文件包含不能在当前代码页(936)中表示的字符,请将该文件保存为 Unicode 格式以防止数据丢失
A: 光标定位到该文件,选择菜单里的高级保存选项utf-8 with signature,带签名的65001,高级保存选项添加方式见https://www.cnblogs.com/daxueba-ITdaren/p/7272210.html

Q: Warning MSB8004: Output Directory does not end with a trailing slash
A: 设置的目录参数不是以反斜杠结束的目录名称,属性→General→Output Direction里加上反斜杠。

Q: 不允许指针指向不完整的类类型
A: 添加该类类型的头文件,如QStatusBar

Q: LNK1169 找到一个或多个多重定义的符号
A: 多次引用头文件,比如所处位置为.h里,改到.cpp里。哪个文件需要,放在哪个文件里,不需要的不要放在.h里

Q: 引用头文件后遇到无法解析的外部符号
A: link里加入lib,目录要添加lib所在目录

Q: Error LNK2019: unresolved external symbol WinMain referenced in function "int _cdecl invoke_main(void)"
A: 右键点击项目,属性→linker→System,修改subsystem。函数入口为main的,选择console;另一种解决办法见QGis二次开发常见问题。

三、Qt常见问题
Q:无法打开包括文件: “QDomDocument”、“QSvgRenderer”之类的问题: No such file or directory
A:C++的包含目录要包含问题模块所处的路径,如QtXml、QtSvg,打印支持还要添加QtPrintSupport、网络QtNetwork

Q: svg的图片为什么在工具栏不显示、编译成功运行不起来?
A: 复制Qt的plugins目录下的imageformats文件夹到程序运行目录;依赖的Qt的dll也要拷到运行目录里(windeployqt了解一下)。


Q:This applicationfailed to start because no Qt platform plugin could be initialized
A: 复制Qt的plugins目录下的platform文件夹到程序运行目录;依赖的Qt的dll也要拷到运行目录里(windeployqt了解一下)。

Q: 信号SIGNAL和槽SLOT如何连接?
A: 如果一个信号不多个槽相联系的话,那么,当这个信号被发射时,与之相关的槽被激活的顺序将是随机的。当点击菜单时,动作触发了多次,这跟connect有关,手动和内部自动重复。connect的几种写法如下:

QMenu* fileMenu = new QMenu;
fileMenu = this->menuBar()->addMenu("File");
actionOpenFile = new QAction("Open", this);
// connect 方式一:SLOT参数传actionOpenFile的默认触发槽函数on_openFileAction_triggered()
connect(actionOpenFile, SIGNAL(triggered(bool)), this, SLOT(on_openFileAction_triggered()));

/**
* connect 方式二:手动设置object name, 然后再显式调用connectSlotsByName()。
* 若由designer自动创建的连接,代码加了connectSlotsByName则会触发两次,因此不要在代码里再连接信号槽。
* 代码创建的部件,可以自定义槽函数void on_<窗口部件名称>_<信号名称>_(<信号参数>),用下面方法连接
* actionOpenFile->setObjectName("actionOpenFile");
* QMetaObject::connectSlotsByName(this);
**/

QgsLayerTreeViewDefaultActions* actions = QgisDemo::instance()->layerTreeView()->defaultActions();
connect(actions->actionRemoveGroupOrLayer(), SIGNAL(triggered(bool)), QgisDemo::instance(), SLOT(slot_updateAppTile()));//connect用法1
//connect(actions->actionRemoveGroupOrLayer(), &QAction::triggered, QgisDemo::instance(), &QgisDemo::slot_updateAppTile);//connect用法2
View Code

 

Q: 一个信号和两个或多个槽函数连接时,由于先后顺序随机性,如何作调整?
A: 将其中一个槽函数里写入非阻塞的延迟处理,调用processEvents会让Qt继续处理线程所在的消息队列中未处理的消息,直到消息队列中没有消息可以处理。当进行长时间的操作的时候可以调用此函数(比方说拷贝文件)。这个函数可能和我们要使用msleep的本意有差别,但是使用它可以在svalue时间内处理events,从而达到类似sleep的目的。可参考https://www.cnblogs.com/bokeyuan-dlam/articles/6794911.html,代码如下:

Time dieTime = QTime::currentTime().addMSecs(svalue);
while( QTime::currentTime() < dieTime )
QCoreApplication::processEvents(QEventLoop::AllEvents, 100);
View Code

 

Q: QwtPlot是qwt6的绘图类,第三方库,如何用?
A: linker里添加qwt.lib,C++包含目录里加入对应的include文件qwt6。

Q: Uic'ing xxx.ui系统找不到指定的路径
A: 问题原因是工程引用了环境变量”QTDIR”,但是用户安装QT后没有配置该环境变量。方法一:在系统环境变量里添加QTDIR,重新启动VS。方法二:右键点击xxx.ui文件,选择属性,将命令行和附加依赖项的uic.exe的路径改成qt目录的绝对路径。注意生成的ui_xxx.h路径,可在C/C++附加目录中添加进去,否则头文件找不到。

四、QGis二次开发常见问题
注意:QGis3.16是基于Qt5.11.2编译的,如果开发用Qt5.12版本,库也需要同样版本重新编译一下。

Q: 若用Qt Creator作二次开发构建,如何配置库引用?
A: 在pro文件中加入以下代码:

INCLUDEPATH += "C:/OSGeo4W64/apps/qgis/include"
INCLUDEPATH += "C:/OSGeo4W64/include"

LIBS += -L"C:/OSGeo4W64/apps/qgis/lib" -lqgis_core -lqgis_gui
LIBS += -L"C:/OSGeo4W64/lib" -lgdal_i

DEFINES += CORE_EXPORT=__declspec(dllimport)
DEFINES += GUI_EXPORT=__declspec(dllimport)
View Code

 

Q: VS提示LNK1104: 无法打开文件“qgis_core.lib”
A: 将依赖库拷到运行目录


Q:VS构建需要的依赖库
A:(1)C/C++常规->附加包含目录:
D:\QGIS\OSGeo4W64\include
D:\QGIS\OSGeo4W64\apps\qgis-ltr\include
D:\Qt5\5.12.10\msvc2017_64\include\QtXml
     (2)链接器->常规—>附加库目录:
D:\QGIS\OSGeo4W64\apps\qgis-ltr\lib
D:\Qt5\5.12.10\msvc2017_64\lib
     (3)链接器->输入->附加依赖项:qgis_core.lib qgis_gui.lib qgis_analysis.lib(根据需求添加,如果app里需要的部分头文件和源文件拷贝过来的话,qgis_app.lib不需要;否则也要加上)

Q: 2.x版本的一些示例中的类在3.x中找不到头文件
A: 参考官网资料,3.x版本作了一些删改与合并,比如QgsProject替代qgsmaplayerregistry,3.x前后API变动记录详见https://qgis.org/api/api_break.html

Q: 如何取消地图工具状态?
A: 切换回到原来的无地图工具状态,解决思路就有了。先获取到当前的地图工具,然后 unset 掉它,并不设置新的工具,就可以了。代码如下:

QgsMapTool *lastMapTool = m_mapCanvas->mapTool();
m_mapCanvas->unsetMapTool( lastMapTool );

 

Q: qgis_gui项目中出现未定义的标识符 "QWebElement"
A: 附件目录添加D:\QGIS\OSGeo4W64\apps\Qt5\include\QtWebKit;但是由于Qt5.6起弃用这个类,变换了新类,因此要么从源码解决这个问题,要么cmake在build源码时取消WITH_QTWEBKIT;要么注释掉报错函数关于QWebElemen类的内容,并在qgismaptip.cpp文件开头注释掉WITH_QTWEBKIT:

//#if WITH_QTWEBKIT
//#endif

 

Q: error LNK2019: 无法解析的外部符号 WinMain,MSVCRT.lib
A: 方法一:见上方的“VS常见问题”;方法二:由于QGis新建项目是控制台应用程序,而程序通过的是WinMian(及windows入口函数),因此需要作下处理:在“qgis_core项目”->“属性”->“连接器”->“输入”附加依赖项中,debug版本添加D:\Qt\Qt5.12.10\msvc2017_64\qtmaind.lib,release版本则添加qtmain.lib。

posted @ 2021-10-26 11:45  攻城的炮车  阅读(497)  评论(0编辑  收藏  举报