VS2019、Qt5.12及QGis3.16專案開發常見問題

       在C++、Qt軟體軟體程序中，常常遇到一些編譯錯誤和警告；博主通過VS2017+Qt5.12.10+QGis3.16二次開發專案，將這些常見問題做個整理，以便日后查閱，該內容分為四部分：VS+Qt環境搭配、VS編譯常見問題、Qt常見問題、QGis二次開發常見問題，

一、VS創建Qt專案
      1、安裝VS2017或VS2019，編譯器原則上是越新越好（此貼發布時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

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);

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)

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_QTWEBKITWITH_QTWEBKIT；要么注釋掉報錯函式關于QWebElemen類的內容，并在qgismaptip.cpp檔案開頭注釋掉WITH_QTWEBKIT：

//#if WITH_QTWEBKIT
//#endif

Q: error LNK2019: 無法決議的外部符號 WinMain，MSVCRT.lib
A: 一種方式見VS常見問題，由于QGis新建專案是控制臺應用程式，而程式通過的是WinMian（及windows入口函式），因此需要作下處理，在“qgis_core專案”->“屬性”->“連接器”->“輸入”附加依賴項中，release版本添加D:\QGIS\OSGeo4W64\apps\Qt5\lib\qtmain.lib，debug版本則添加qtmaind.lib，

標籤：C++

上一篇：在magento2中將產品添加到購物車后如何發送電子郵件？

下一篇：vscode C++環境的配置