將Qt項目升級到Qt6吐血經(jīng)驗總結(jié)
Qt的版本發(fā)布越來越頻繁，Qt6發(fā)布已經(jīng)有一段時間了，越來越多的人咨詢之前的代碼是否可以增加對Qt6的支持，包括開源的項目QWidgetDemo（一年時間超過2.6K star），近期百忙之中，對所有項目進行了Qt6的兼容升級，自此所有項目從Qt4兼容到了Qt6，耗時一個多月，總計更新調(diào)整代碼行數(shù)一萬多行。雖然更新工作量不是很大，但還是廢了九牛二虎之力，畢竟項目數(shù)太多，光幾十個項目作品中的其中之一自定義控件就188個子項目，為了方便自己也為了總結(jié)分享經(jīng)驗，特意整理了從Qt4兼容到Qt6的一些經(jīng)驗要點，只是部分，后期持續(xù)更新，也歡迎各位留言補充。
直觀總結(jié)
- 增加了很多輪子，同時原有模塊拆分的也更細致，估計為了方便拓展個管理。
- 把一些過度封裝的東西移除了（比如同樣的功能有多個函數(shù)），保證了只有一個函數(shù)執(zhí)行該功能。
- 把一些Qt5中兼容Qt4的方法廢棄了，必須用Qt5中對應(yīng)的新的函數(shù)。
- 跟隨時代腳步，增加了不少新特性以滿足日益增長的客戶需求。
- 對某些模塊和類型及處理進行了革命性的重寫，運行效率提高不少。
- 有參數(shù)類型的變化，比如 long * 到 qintptr * 等，更加適應(yīng)后續(xù)的拓展以及同時對32 64位不同系統(tǒng)的兼容。
- 源碼中的double數(shù)據(jù)類型全部換成了qreal，和Qt內(nèi)部數(shù)據(jù)類型高度一致和統(tǒng)一。
- 我測試的都是QWidget部分，quick部分沒有測試，估計quick部分更新可能會更多。
- 強烈建議暫時不要用Qt6.0到Qt6.2之間的版本，一些模塊還缺失，相對來說BUG也比較多，推薦6.2版本開始正式遷移。
經(jīng)驗總結(jié)
- 萬能方法：安裝5.15版本，定位到報錯的函數(shù)，切換到源碼頭文件，可以看到對應(yīng)提示字樣 QT_DEPRECATED_X("Use sizeInBytes") 和新函數(shù)。按照這個提示類修改就沒錯，一些函數(shù)是從Qt5.7 5.9 5.10等版本新增加的，可能你的項目還用的Qt4的方法，但是Qt6以前都兼容這些舊方法，到了Qt6就徹底需要用新方法了。
- Qt6對core這個核心類進行了拆分，多出來core5compat，因此你需要在pro增加對應(yīng)的模塊已經(jīng)代碼中引入對應(yīng)的頭文件。
//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開啟了高分屏支持，界面會變得很大，甚至字體發(fā)虛，很多人會不習慣，因為這種模式如果程序很多坐標計算沒有采用devicePixelRatio進行運算的話，100%會出現(xiàn)奇奇怪怪的問題，因為坐標不準確了。要取消這種效果可以設(shè)置高分屏縮放因子。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::Floor);
#endif
4.原有的隨機數(shù)函數(shù)提示用QRandomGenerator替代，為了兼容所有qt版本，改動最小的辦法是直接用c++中的隨機數(shù)，比如qsrand函數(shù)換成srand，qrand函數(shù)換成rand，查看過源代碼，其實封裝的就是c++中的隨機數(shù)，很多類似的封裝比如qSin封裝的sin。
5.QColor的 light 改成 lighter ，dark 改成 darker，其實 lighter、darker 這兩個方法以前一直有。
6.QFontMetricsF 中的 fm.width 換成 fm.horizontalAdvance ，從5.11開始用新函數(shù)。
7.QPalette調(diào)色板枚舉值，F(xiàn)oreground = 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() 函數(shù)換成 contentsMargins().left()，查看源碼得知以前的 margin() 返回的就是 contentsMargins().left()，在四個數(shù)值一樣的時候，默認四個數(shù)值就是一樣。類似的還有setMargin移除了，統(tǒng)統(tǒng)用setContentsMargins。
11.之前 QChar c = 0xf105 全部要改成強制轉(zhuǎn)換 QChar c = (QChar)0xf105，不再有隱式轉(zhuǎn)換，不然編譯報錯提示error: conversion from 'int' to 'QChar' is ambiguous 。
12.qSort等一些函數(shù)用回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 ，函數(shù)功能基本一致，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;
}
//獲取當前屏幕尺寸區(qū)域
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構(gòu)造參數(shù)和對應(yīng)的計算方位函數(shù)變了。
//模擬鼠標滾輪 #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 //滾動的步數(shù),*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 的一個重載函數(shù)換成了 resolveMask。
25.QSettings的 setIniCodec 方法移除了，默認就是utf8，不需要設(shè)置。
26.qcombobox 的 activated(QString) 和 currentIndexChanged(QString) 信號刪除了，用int索引參數(shù)的那個，然后自己通過索引獲取值。個人覺得這個沒必要刪除。
27.qtscript模塊徹底沒有了，盡管從Qt5時代的后期版本就提示為廢棄模塊，一致堅持到Qt6才正式廢棄，各種json數(shù)據(jù)解析全部換成qjson類解析。
28.QByteArray 的 append indexOf lastIndexOf 等眾多方法的QString參數(shù)重載函數(shù)廢棄了，要直接傳 QByteArray，就在原來參數(shù)基礎(chǔ)上加上 .toUtf8() 。查看源碼也看得到以前的QString參數(shù)也是轉(zhuǎn)成.toUtf8()再去比較。
29.QDateTime的時間轉(zhuǎn)換函數(shù) toTime_t + setTime_t 名字改了，對應(yīng)改成了 toSecsSinceEpoch + setSecsSinceEpoch ，這兩個方法在Qt5.8時候新增加的。
30.QLabel的 pixmap 函數(shù)之前是指針 *pixmap() 現(xiàn)在換成了引用 pixmap()。
31.QTableWidget的 sortByColumn 方法移除了默認升序的方法，必須要填入第二個參數(shù)表示升序還是降序。
32.qtnetwork中的錯誤信號error換成了errorOccurred。
33.XmlPatterns模塊木有了，全部用xml模塊重新解析。
34.nativeEvent的參數(shù)類型變了。
#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
到此這篇關(guān)于Qt項目升級到Qt6吐血經(jīng)驗總結(jié)的文章就介紹到這了,更多相關(guān)Qt項目升級到Qt6內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章主要給大家介紹了關(guān)于如何利用現(xiàn)代化C#語法簡化代碼的相關(guān)資料,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2021-04-04
這篇文章主要介紹了WPF ComboBox獲取當前選擇值的實例詳解，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2021-01-01
這篇文章介紹了C#生成Token字符串的方法，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-06-06
NLog 是 .NET 的日志記錄框架,具有豐富的日志路由和管理能力,極大地幫助您生成和管理日志,NLog 是一個庫,可以輕松地同時記錄和管理多個不同區(qū)域中的數(shù)據(jù),本文將給大家介紹在C#中使用 NLog 庫進行日志記錄的教程,需要的朋友可以參考下2024-06-06
這篇文章主要介紹了C#編程之事務(wù)用法,結(jié)合實例形式對比分析了C#中事務(wù)提交與回滾的具體實現(xiàn)技巧與相關(guān)注意事項,具有一定參考借鑒價值,需要的朋友可以參考下2015-11-11
本文是對C#中對象與XMl文件之間的相互轉(zhuǎn)換進行了詳細的介紹，需要的朋友可以過來參考下，希望對大家有所幫助2013-10-10
這篇文章主要介紹了C#實現(xiàn)在服務(wù)器端裁剪圖片的方法,涉及C#操作圖片的相關(guān)技巧,需要的朋友可以參考下2015-04-04
今天小編就為大家分享一篇關(guān)于C#實現(xiàn)順序隊列和鏈隊列的代碼實例，小編覺得內(nèi)容挺不錯的，現(xiàn)在分享給大家，具有很好的參考價值，需要的朋友一起跟隨小編來看看吧2018-10-10
這篇文章首先給大家介紹了關(guān)于C#中try...catch的語法，而后又給大家分享了關(guān)于C#中try...catch最常見的面試題，具有一定的參考借鑒價值，需要的朋友們下面來一起看看吧。2017-02-02
這篇文章主要為大家詳細介紹了如何利用C#編寫一個獲取硬件信息的簡單工具類,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起了解一下2023-11-11