將Qt項目升級到Qt6吐血經驗總結
Qt的版本發佈越來越頻繁,Qt6發佈已經有一段時間瞭,越來越多的人咨詢之前的代碼是否可以增加對Qt6的支持,包括開源的項目QWidgetDemo(一年時間超過2.6K star),近期百忙之中,對所有項目進行瞭Qt6的兼容升級,自此所有項目從Qt4兼容到瞭Qt6,耗時一個多月,總計更新調整代碼行數一萬多行。雖然更新工作量不是很大,但還是廢瞭九牛二虎之力,畢竟項目數太多,光幾十個項目作品中的其中之一自定義控件就188個子項目,為瞭方便自己也為瞭總結分享經驗,特意整理瞭從Qt4兼容到Qt6的一些經驗要點,隻是部分,後期持續更新,也歡迎各位留言補充。
直觀總結
- 增加瞭很多輪子,同時原有模塊拆分的也更細致,估計為瞭方便拓展個管理。
- 把一些過度封裝的東西移除瞭(比如同樣的功能有多個函數),保證瞭隻有一個函數執行該功能。
- 把一些Qt5中兼容Qt4的方法廢棄瞭,必須用Qt5中對應的新的函數。
- 跟隨時代腳步,增加瞭不少新特性以滿足日益增長的客戶需求。
- 對某些模塊和類型及處理進行瞭革命性的重寫,運行效率提高不少。
- 有參數類型的變化,比如 long * 到 qintptr * 等,更加適應後續的拓展以及同時對32 64位不同系統的兼容。
- 源碼中的double數據類型全部換成瞭qreal,和Qt內部數據類型高度一致和統一。
- 我測試的都是QWidget部分,quick部分沒有測試,估計quick部分更新可能會更多。
- 強烈建議暫時不要用Qt6.0到Qt6.2之間的版本,一些模塊還缺失,相對來說BUG也比較多,推薦6.2版本開始正式遷移。
經驗總結
- 萬能方法:安裝5.15版本,定位到報錯的函數,切換到源碼頭文件,可以看到對應提示字樣 QT_DEPRECATED_X(“Use sizeInBytes”) 和新函數。按照這個提示類修改就沒錯,一些函數是從Qt5.7 5.9 5.10等版本新增加的,可能你的項目還用的Qt4的方法,但是Qt6以前都兼容這些舊方法,到瞭Qt6就徹底需要用新方法瞭。
- Qt6對core這個核心類進行瞭拆分,多出來core5compat,因此你需要在pro增加對應的模塊已經代碼中引入對應的頭文件。
//pro文件引入模塊 greaterThan(QT_MAJOR_VERSION, 4): QT += widgets greaterThan(QT_MAJOR_VERSION, 5): QT += core5compat //代碼中引入頭文件 #if (QT_VERSION >= QT_VERSION_CHECK(5,0,0)) #include <QtWidgets> #endif #if (QT_VERSION >= QT_VERSION_CHECK(6,0,0)) #include <QtCore5Compat> #endif
3.默認Qt6開啟瞭高分屏支持,界面會變得很大,甚至字體發虛,很多人會不習慣,因為這種模式如果程序很多坐標計算沒有采用devicePixelRatio進行運算的話,100%會出現奇奇怪怪的問題,因為坐標不準確瞭。要取消這種效果可以設置高分屏縮放因子。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0)) QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::Floor); #endif
4.原有的隨機數函數提示用QRandomGenerator替代,為瞭兼容所有qt版本,改動最小的辦法是直接用c++中的隨機數,比如qsrand函數換成srand,qrand函數換成rand,查看過源代碼,其實封裝的就是c++中的隨機數,很多類似的封裝比如qSin封裝的sin。
5.QColor的 light 改成 lighter ,dark 改成 darker,其實 lighter、darker 這兩個方法以前一直有。
6.QFontMetricsF 中的 fm.width 換成 fm.horizontalAdvance ,從5.11開始用新函數。
7.QPalette調色板枚舉值,Foreground = WindowText, Background = Window,其中 Foreground 和 Background 沒有瞭,要用 WindowText 和 Window 替代,以前就有。類似的還有 setTextColor 改成瞭 setForeground 。
8.QWheelEvent的 delta() 改成 angleDelta().y(),pos() 改成 position() 。
9.svg模塊拆分出來瞭svgwidgets,如果用到瞭該模塊則需要在pro增加 QT += svgwidgets 。
10.qlayout中的 margin() 函數換成 contentsMargins().left(),查看源碼得知以前的 margin() 返回的就是 contentsMargins().left(),在四個數值一樣的時候,默認四個數值就是一樣。類似的還有setMargin移除瞭,統統用setContentsMargins。
11.之前 QChar c = 0xf105 全部要改成強制轉換 QChar c = (QChar)0xf105,不再有隱式轉換,不然編譯報錯提示error: conversion from ‘int’ to ‘QChar’ is ambiguous 。
12.qSort等一些函數用回c++的 std::sort 。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0)) std::sort(ipv4s.begin(), ipv4s.end()); #else qSort(ipv4s); #endif
13.Qt::WA_NoBackground 改成 Qt::WA_OpaquePaintEvent 。
14.QMatrix 類廢棄瞭沒有瞭,換成 QTransform ,函數功能基本一致,QTransform 類在Qt4就一直有。
15.QTime 計時去掉瞭,需要改成 QElapsedTimer ,QElapsedTimer 類在Qt4就一直有。
16.QApplication::desktop()廢棄瞭, 換成瞭 QApplication::primaryScreen()。
#if (QT_VERSION > QT_VERSION_CHECK(5,0,0)) #include "qscreen.h" #define deskGeometry qApp->primaryScreen()->geometry() #define deskGeometry2 qApp->primaryScreen()->availableGeometry() #else #include "qdesktopwidget.h" #define deskGeometry qApp->desktop()->geometry() #define deskGeometry2 qApp->desktop()->availableGeometry() #endif
17.獲取當前屏幕索引以及尺寸需要分別處理。
//獲取當前屏幕索引 int QUIHelper::getScreenIndex() { //需要對多個屏幕進行處理 int screenIndex = 0; #if (QT_VERSION >= QT_VERSION_CHECK(5,0,0)) int screenCount = qApp->screens().count(); #else int screenCount = qApp->desktop()->screenCount(); #endif if (screenCount > 1) { //找到當前鼠標所在屏幕 QPoint pos = QCursor::pos(); for (int i = 0; i < screenCount; ++i) { #if (QT_VERSION >= QT_VERSION_CHECK(5,0,0)) if (qApp->screens().at(i)->geometry().contains(pos)) { #else if (qApp->desktop()->screenGeometry(i).contains(pos)) { #endif screenIndex = i; break; } } } return screenIndex; } //獲取當前屏幕尺寸區域 QRect QUIHelper::getScreenRect(bool available) { QRect rect; int screenIndex = QUIHelper::getScreenIndex(); if (available) { #if (QT_VERSION >= QT_VERSION_CHECK(5,0,0)) rect = qApp->screens().at(screenIndex)->availableGeometry(); #else rect = qApp->desktop()->availableGeometry(screenIndex); #endif } else { #if (QT_VERSION >= QT_VERSION_CHECK(5,0,0)) rect = qApp->screens().at(screenIndex)->geometry(); #else rect = qApp->desktop()->screenGeometry(screenIndex); #endif } return rect; }
18.QRegExp類移到瞭core5compat模塊,需要主動引入頭文件 #include 。
19.QWheelEvent構造參數和對應的計算方位函數變瞭。
//模擬鼠標滾輪 #if (QT_VERSION < QT_VERSION_CHECK(6,0,0)) QWheelEvent wheelEvent(QPoint(0, 0), -scal, Qt::LeftButton, Qt::NoModifier); #else QWheelEvent wheelEvent(QPointF(0, 0), QPointF(0, 0), QPoint(0, 0), QPoint(0, -scal), Qt::LeftButton, Qt::NoModifier, Qt::ScrollBegin, false); #endif QApplication::sendEvent(widget, &wheelEvent); //鼠標滾輪直接修改值 QWheelEvent *whellEvent = (QWheelEvent *)event; //滾動的角度,*8就是鼠標滾動的距離 #if (QT_VERSION < QT_VERSION_CHECK(6,0,0)) int degrees = whellEvent->delta() / 8; #else int degrees = whellEvent->angleDelta().x() / 8; #endif //滾動的步數,*15就是鼠標滾動的角度 int steps = degrees / 15;
20.qVariantValue 改成 qvariant_cast ,qVariantSetValue(v, value) 改成瞭 v.setValue(val)。相當於退回到最原始的方法,查看qVariantValue源碼封裝的就是qvariant_cast。
21.QStyleOption的init改成瞭initFrom。
22.QVariant::Type 換成瞭 QMetaType::Type ,本身以前的 QVariant::Type 封裝的就是 QMetaType::Type 。
23.QStyleOptionViewItemV2 V3 V4 之類的全部沒有瞭,暫時可以用 QStyleOptionViewItem 替代。
24.QFont的 resolve 的一個重載函數換成瞭 resolveMask。
25.QSettings的 setIniCodec 方法移除瞭,默認就是utf8,不需要設置。
26.qcombobox 的 activated(QString) 和 currentIndexChanged(QString) 信號刪除瞭,用int索引參數的那個,然後自己通過索引獲取值。個人覺得這個沒必要刪除。
27.qtscript模塊徹底沒有瞭,盡管從Qt5時代的後期版本就提示為廢棄模塊,一致堅持到Qt6才正式廢棄,各種json數據解析全部換成qjson類解析。
28.QByteArray 的 append indexOf lastIndexOf 等眾多方法的QString參數重載函數廢棄瞭,要直接傳 QByteArray,就在原來參數基礎上加上 .toUtf8() 。查看源碼也看得到以前的QString參數也是轉成.toUtf8()再去比較。
29.QDateTime的時間轉換函數 toTime_t + setTime_t 名字改瞭,對應改成瞭 toSecsSinceEpoch + setSecsSinceEpoch ,這兩個方法在Qt5.8時候新增加的。
30.QLabel的 pixmap 函數之前是指針 *pixmap() 現在換成瞭引用 pixmap()。
31.QTableWidget的 sortByColumn 方法移除瞭默認升序的方法,必須要填入第二個參數表示升序還是降序。
32.qtnetwork中的錯誤信號error換成瞭errorOccurred。
33.XmlPatterns模塊木有瞭,全部用xml模塊重新解析。
34.nativeEvent的參數類型變瞭。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0)) bool nativeEvent(const QByteArray &eventType, void *message, qintptr *result); #else bool nativeEvent(const QByteArray &eventType, void *message, long *result); #endif
到此這篇關於Qt項目升級到Qt6吐血經驗總結的文章就介紹到這瞭,更多相關Qt項目升級到Qt6內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!