Qt4/5升級到Qt6吐血經驗總結V202308

00:直觀總結

  1. 增加了很多輪子,同時原有模塊拆分的也更細緻,估計爲了方便拓展個管理。
  2. 把一些過度封裝的東西移除了(比如同樣的功能有多個函數),保證了只有一個函數執行該功能。
  3. 把一些Qt5中兼容Qt4的方法廢棄了,必須用Qt5中對應的新的函數。
  4. 跟隨時代腳步,增加了不少新特性以滿足日益增長的客戶需求。
  5. 對某些模塊和類型及處理進行了革命性的重寫,運行效率提高不少。
  6. 有參數類型的變化,比如 long * 到 qintptr * 等,更加適應後續的拓展以及同時對32 64位不同系統的兼容。
  7. 源碼中的double數據類型全部換成了qreal,和Qt內部數據類型高度一致和統一。
  8. 我測試的都是QWidget部分,quick部分沒有測試,估計quick部分更新可能會更多。
  9. 強烈建議暫時不要用Qt6.0到Qt6.2之間的版本,一些模塊還缺失,相對來說BUG也比較多,推薦6.2.2版本開始正式遷移。

01:01-10

  1. 萬能方法:安裝5.15版本,定位到報錯的函數,切換到源碼頭文件,可以看到對應提示字樣 QT_DEPRECATED_X("Use sizeInBytes") 和新函數。按照這個提示類修改就沒錯,一些函數是從Qt5.7 5.9 5.10等版本新增加的,可能你的項目還用的Qt4的方法,但是Qt6以前都兼容這些舊方法,到了Qt6就徹底需要用新方法了。PS:如果本身就是Qt6新增的功能函數則此方法無效

  2. 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
  1. 默認Qt6開啓了高分屏支持,界面會變得很大,甚至字體發虛,很多人會不習慣,因爲這種模式如果程序很多座標計算沒有采用devicePixelRatio進行運算的話,100%會出現奇奇怪怪的問題,因爲座標不準確了。要取消這種效果可以設置高分屏縮放因子。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
    QGuiApplication::setHighDpiScaleFactorRoundingPolicy(Qt::HighDpiScaleFactorRoundingPolicy::Floor);
#endif
  1. 原有的隨機數函數提示用QRandomGenerator替代,爲了兼容所有qt版本,改動最小的辦法是直接用c++中的隨機數,比如qsrand函數換成srand,qrand函數換成rand,查看過源代碼,其實封裝的就是c++中的隨機數,很多類似的封裝比如qSin封裝的sin。

  2. QColor的 light 改成 lighter ,dark 改成 darker,其實 lighter、darker 這兩個方法以前一直有。

  3. QFontMetricsF 中的 fm.width 換成 fm.horizontalAdvance ,從5.11開始用新函數。

  4. QPalette調色板枚舉值,Foreground = WindowText, Background = Window,其中 Foreground 和 Background 沒有了,要用 WindowText 和 Window 替代,以前就有。類似的還有 setTextColor 改成了 setForeground 。

  5. QWheelEvent的 delta() 改成 angleDelta().y(),pos() 改成 position() 。

  6. svg模塊拆分出來了svgwidgets,如果用到了該模塊則需要在pro增加 QT += svgwidgets ,同理opengl模塊拆分出來了openglwidgets。

  7. qlayout中的 margin() 函數換成 contentsMargins().left(),查看源碼得知以前的 margin() 返回的就是 contentsMargins().left(),在四個數值一樣的時候,默認四個數值就是一樣。類似的還有setMargin移除了,統統用setContentsMargins。

02:11-20

  1. 之前 QChar c = 0xf105 全部要改成強制轉換 QChar c = (QChar)0xf105,不再有隱式轉換,不然編譯報錯提示error: conversion from 'int' to 'QChar' is ambiguous 。

  2. qSort等一些函數用回c++的 std::sort 。

#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
    std::sort(ipv4s.begin(), ipv4s.end());
#else
    qSort(ipv4s);
#endif
  1. Qt::WA_NoBackground 改成 Qt::WA_OpaquePaintEvent 。

  2. QMatrix 類廢棄了沒有了,換成 QTransform ,函數功能基本一致,QTransform 類在Qt4就一直有。

  3. QTime 計時去掉了,需要改成 QElapsedTimer ,QElapsedTimer 類在Qt4就一直有。

  4. 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
  1. 獲取當前屏幕索引以及尺寸需要分別處理。
//獲取當前屏幕索引
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;
}
  1. QRegExp類移到了core5compat模塊,需要主動引入頭文件 #include "QRegExp"。
    //設置限制只能輸入數字+小數位
    QString pattern = "^-?[0-9]+([.]{1}[0-9]+){0,1}$";
    //設置IP地址校驗過濾
    QString pattern = "(2[0-5]{2}|2[0-4][0-9]|1?[0-9]{1,2})";

    //確切的說 QRegularExpression QRegularExpressionValidator 從5.0 5.1開始就有
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
    QRegularExpression regExp(pattern);
    QRegularExpressionValidator *validator = new QRegularExpressionValidator(regExp, this);
#else
    QRegExp regExp(pattern);
    QRegExpValidator *validator = new QRegExpValidator(regExp, this);
#endif
    lineEdit->setValidator(validator);
  1. 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;
  1. qVariantValue 改成 qvariant_cast ,qVariantSetValue(v, value) 改成了 v.setValue(val)。相當於退回到最原始的方法,查看qVariantValue源碼封裝的就是qvariant_cast。

03:21-30

  1. QStyleOption的init改成了initFrom。

  2. QVariant::Type 換成了 QMetaType::Type ,本身以前的 QVariant::Type 封裝的就是 QMetaType::Type 。

  3. QStyleOptionViewItemV2 V3 V4 之類的全部沒有了,暫時可以用 QStyleOptionViewItem 替代。

  4. QFont的 resolve 的一個重載函數換成了 resolveMask。

  5. QSettings的 setIniCodec 方法移除了,默認就是utf8,不需要設置。

  6. qcombobox 的 activated(QString) 和 currentIndexChanged(QString) 信號刪除了,用int索引參數的那個,然後自己通過索引獲取值。個人覺得這個沒必要刪除。

  7. qtscript模塊徹底沒有了,儘管從Qt5時代的後期版本就提示爲廢棄模塊,一致堅持到Qt6才正式廢棄,各種json數據解析全部換成qjson類解析。

  8. QByteArray 的 append indexOf lastIndexOf 等衆多方法的QString參數重載函數廢棄了,要直接傳 QByteArray,就在原來參數基礎上加上 .toUtf8() 。查看源碼也看得到以前的QString參數也是轉成.toUtf8()再去比較。

  9. QDateTime的時間轉換函數 toTime_t + setTime_t 名字改了,對應改成了 toSecsSinceEpoch + setSecsSinceEpoch ,這兩個方法在Qt5.8時候新增加的。

  10. QLabel的 pixmap 函數之前是指針 *pixmap() 現在換成了引用 pixmap()。

04:31-40

  1. QTableWidget的 sortByColumn 方法移除了默認升序的方法,必須要填入第二個參數表示升序還是降序。

  2. qtnetwork模塊中(TCP/UDP相關的socket)的錯誤信號error換成了errorOccurred,就改了個名字,注意websocket那塊居然沒統一改過來依然是叫error。

#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
    connect(udpSocket, SIGNAL(errorOccurred(QAbstractSocket::SocketError)), this, SLOT(error()));
    connect(tcpSocket, SIGNAL(errorOccurred(QAbstractSocket::SocketError)), this, SLOT(error()));
#else
    connect(udpSocket, SIGNAL(error(QAbstractSocket::SocketError)), this, SLOT(error()));
    connect(tcpSocket, SIGNAL(error(QAbstractSocket::SocketError)), this, SLOT(error()));
#endif

//特別注意websocket中依然還是用error
connect(webSocket, SIGNAL(error(QAbstractSocket::SocketError)), this, SLOT(error()));
  1. XmlPatterns模塊木有了,全部用xml模塊重新解析。

  2. 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
  1. QButtonGroup的buttonClicked信號中int參數的函數全部改名字叫idClicked。
    QButtonGroup *btnGroup = new QButtonGroup(this);
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
    connect(btnGroup, SIGNAL(idClicked(int)), ui->xstackWidget, SLOT(setCurrentIndex(int)));
#else
    connect(btnGroup, SIGNAL(buttonClicked(int)), ui->xstackWidget, SLOT(setCurrentIndex(int)));
#endif
  1. QWebEngineSettings之前是QWebEngineSettings::defaultSettings();現在改成了QWebEngineProfile::defaultProfile()->settings();通過查看之前的源碼得知QWebEngineSettings::defaultSettings();封裝的就是QWebEngineProfile::defaultProfile()->settings();因爲Qt6去除了N多過度封裝的函數。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
    QWebEngineSettings *webSetting = QWebEngineProfile::defaultProfile()->settings();
#else
    QWebEngineSettings *webSetting = QWebEngineSettings::defaultSettings();
#endif
  1. Qt6將enterEvent的參數QEvent改成了QEnterEvent也不打個招呼。這種改變編譯也不會提示的。
#if (QT_VERSION >= QT_VERSION_CHECK(6,0,0))
    void enterEvent(QEnterEvent *);
#else
    void enterEvent(QEvent *);
#endif

//後面經過JasonWong大佬的指點,從父類重新實現的virtual修飾的函數,建議都加上override關鍵字。
//這樣的話一旦父類的函數或者參數變了則會提示編譯報錯,而不是編譯通過但是運行不正常會一臉懵逼茫然,從而把鍋扣給Qt。

//下面是父類函數
virtual void enterEvent(QEvent *event);
//子類建議加上override
void enterEvent(QEvent *event) override;
  1. Qt6中多個類進行了合併,比如現在QVector就成了QList的別名,意味着這兩個類是同一個類沒有任何區別,可能Qt內部對兩種的優點都集中在一起,並儘量重寫算法或者其他處理規避缺點。同理QStringList現在也成了 QList<QString> 的別名,是同一個類,沒有單獨的類。

  2. 在Qt4時代默認QWidget構造函數父類是0,到了Qt5變成了Q_NULLPTR,到了Qt6居然用的是默認的c++標準中的nullptr而不是Qt自定義定義的Q_NULLPTR(同樣的還有Q_DECL_OVERRIDE換成了用override等),可能是爲了徹底拋棄歷史包袱擁抱未來。

//下面依次是Qt4/5/6的寫法
MainWindow(QWidget *parent = 0);
MainWindow(QWidget *parent = Q_NULLPTR);
MainWindow(QWidget *parent = nullptr);

//查閱Qt源碼查看Q_NULLPTR原來是根據編譯器定義來選擇
#ifdef Q_COMPILER_NULLPTR
# define Q_NULLPTR         nullptr
#else
# define Q_NULLPTR         NULL
#endif

//Qt高版本兼容低版本寫法比如Qt5/6都支持 *parent = 0 這種寫法。
  1. 對於委託的進度條樣式QStyleOptionProgressBar類的屬性,在Qt4的時候不能設置橫向還是垂直樣式,默認橫向樣式,要設置orientation需要用另外的QStyleOptionProgressBarV2。從Qt5開始新增了orientation和bottomToTop屬性設置。在Qt6的時候徹底移除了orientation屬性,只有bottomToTop屬性,而且默認進度是垂直的,很操蛋,理論上默認應該是橫向的纔對,絕大部分進度條場景都是橫向的。這個時候怎麼辦呢,原來現在的處理邏輯改了,默認垂直的,如果要設置橫向的直接設置 styleOption.state |= QStyle::State_Horizontal 這種方式設置纔行,而Qt6以前默認方向是通過 orientation 值取得,這個State_Horizontal從Qt4就一直有,Qt6以後要主動設置下才是橫向的就是。

05:41-50

  1. Qt6.2版本開始增加了對多媒體模塊的支持,但是在mingw編譯器下還是有問題,直到6.2.2才修復這個問題,官網解釋是因爲mingw編譯器版本不支持,到6.2.2採用了新的mingw900_64,這個編譯器版本才支持。所以理論上推薦從6.2.2開始使用新的Qt6。

  2. QTextStream中的setCodec方法改成了setEncoding,參數變了,功能更強大。

QTextStream stream(&file);
#if (QT_VERSION < QT_VERSION_CHECK(6,0,0))
stream.setCodec("utf-8");
stream.setCodec("gbk");
#else
stream.setEncoding(QStringConverter::Utf8);
stream.setEncoding(QStringConverter::System);
#endif
  1. QModelIndex的查找子節點child函數去掉了,但是查找父節點parent函數保留,查閱代碼得知之前的child函數就是封裝的model->index(row, column, QModelIndex)函數。
//下面兩個函數等價 如果要兼容Qt456則用下面這個方法
QModelIndex index = indexParent.child(i, 0);
QModelIndex index = model->index(i, 0, indexParent);

//下面兩個函數等價 如果要兼容Qt456則用下面這個方法
QModelIndex indexChild = index.child(i, 0);
QModelIndex indexChild = model->index(i, 0, index);
  1. 之前QPixmap類中的靜態函數grabWindow和grabWidget徹底廢棄了,改成了用QApplication::primaryScreen()->grabWindow,其實這個從Qt5開始就建議用這個。
#if (QT_VERSION >= QT_VERSION_CHECK(5,0,0))
    QPixmap pixmap = QApplication::primaryScreen()->grabWindow(widget->winId());
#else
    QPixmap pixmap = QPixmap::grabWidget(widget->winId());
#endif
  1. QProcess中的start方法以前直接支持傳入完整的命令,到了Qt6嚴格要求必須拆分後面的參數。
//Qt6以前支持執行完整命令
QProcess p;
p.start("wmic cpu get Name");
//Qt6需要改成下面的方法,此方法也兼容Qt4、5、6
p.start("wmic", QStringList() << "cpu" << "get" << "Name");
  1. 在qss中對屬性的枚舉值寫法到了Qt6換成了數值表示(需要翻閱枚舉值的定義找到對應的值),這個改動挺大,切記需要切換過來,而且這種寫法不兼容Qt5。
//Qt4/5 通過樣式表設置標籤右上角對齊
ui->label->setStyleSheet("qproperty-alignment:AlignRight;");
//Qt4/5 通過樣式表設置標籤居中對齊
ui->label->setStyleSheet("qproperty-alignment:AlignHCenter|AlignVCenter;");

//Qt6 通過樣式表設置標籤右上角對齊 翻閱 AlignRight 的枚舉值=2
ui->label->setStyleSheet("qproperty-alignment:2;");
//Qt6 通過樣式表設置標籤居中對齊 翻閱 AlignHCenter|AlignVCenter 的枚舉值=0x04|0x80=0x84=132
ui->label->setStyleSheet("qproperty-alignment:132;");
  1. Qt6中多媒體模塊的類做了巨大調整改動,有些是類名的變化,比如音頻輸出(也叫播放)之前是 QAudioOutput 現在是 QAudioSink ,音頻輸入(也叫錄音)之前是 QAudioInput 現在是 QAudioSource ,默認音頻輸入輸出設備集合之前是 QAudioDeviceInfo::defaultInputDevice()、QAudioDeviceInfo::defaultOutputDevice(),現在是 QMediaDevices::defaultAudioInput()、QMediaDevices::defaultAudioOutput()。感覺這個名字改的沒有以前貼切。
#if (QT_VERSION >= QT_VERSION_CHECK(6,2,0))
#define AudioInput QAudioSource
#define AudioOutput QAudioSink
#else
#define AudioInput QAudioInput
#define AudioOutput QAudioOutput
#endif
//使用的時候只需要new就行
AudioInput *input = new AudioInput(format, this);

#if (QT_VERSION >= QT_VERSION_CHECK(6,2,0))
#define QAudioInput QAudioSource
#define QAudioOutput QAudioSink
#endif
//使用的時候只需要new就行
QAudioInput *input = new QAudioInput(format, this);
  1. Qt6開始默認用cmake,所以現在新版的qtcreator在新建項目的時候默認選擇的就是cmake,很多初學者首次用的時候會發現,怎麼突然之間生成的項目,結構都不一樣,突然之間懵逼了,所以要在新建項目的過程中選擇qmake,選擇一次以後就默認qmake了。

  2. Qt6.4開始對應類QString/QByteArray的count函數廢棄了,改用size/length函數,估計可能描述更準確吧。

  3. Qt6.4.1新增了N多BUG,強烈不建議使用,比如QAudioSink播放聲音沒有聲音 https://bugreports.qt.io/browse/QTBUG-108383,DPI縮放嚴重變形 https://bugreports.qt.io/browse/QTBUG-108593。這些BUG在6.4.0/6.5.0是不存在的,KPI害死人啊。

  4. Qt6.5版本開始取消了QVariant的默認構造函數,之前return QVariant() 現在必須改成 QVariant(QVariant::Invalid) 纔不會有警告提示。通過打印值發現QVariant()本身就=QVariant(QVariant::Invalid),所以統一寫成QVariant(QVariant::Invalid)兼容Qt456。

項目大全 https://qtchina.blog.csdn.net/article/details/97565652







發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章