c++ - 与Qt 4(QtQuick 1.x)和Qt 5(QtQuick 2.x)兼容的C++/QML项目

当编写不使用QML且不依赖于Qt 5的新功能的Qt应用程序时，我们可以同时使用Qt 4和Qt 5对其进行编译(少数源不兼容性除外)。

当我们想使用Qt 5功能但又想使用等效但效率较低的Qt 4解决方案时，我们可以简单地使用#if来检查Qt版本，例如使用新的QStringLiteral，但在使用Qt 4进行编译时会回落到QString::fromUtf8。

我们如何使用QtQuick来做同样的事情？请注意，可以在Qt 5中将QDeclarativeView与QtQuick 1.x一起使用，但是不会使用Qt 5中的新场景图。1.x仅支持QDeclarativeView，而2.x仅支持QQuickView，即使我不使用引入的功能在Quick 2.0中。

我想要的是:

使用Qt 4进行编译时，请使用QDeclarativeView和好友。在QML中:import QtQuick 1.x

使用Qt 5进行编译时，请使用新的QQuickView和好友。在QML中:import QtQuick 2.x

仅具有一组QML文件，但没有一组用于QtQuick 1.x，另一组用于QtQuick 2.x

关于C++部分，这似乎很容易。在Qt 4中，我们可以简单地添加:

#include <QApplication>
#include <QDeclarativeView>
#include <QDeclarativeEngine>
typedef QApplication QGuiApplication;
typedef QDeclarativeView QQuickView;

然后在Qt 4和Qt 5中都使用QGuiApplication，QQuickView等。但是，当QML文件包含QtQuick的导入声明时，我无法添加#if在1.x和2.x之间进行选择。有没有一种正式的方法，比如说添加一个别名，以使QtQuick 1.x在QQuickView中起作用(因此实际上被解析为QtQuick 2.0)？

最佳答案

我所做的是在部署所有QML文件时替换了字符串QtQuick x.y。如果源树中有一个qml文件夹，而您的构建树中有一个相同的qml文件夹，则可以部署该文件夹，但替换字符串以匹配所需的QtQuick版本。

以下解决方案在POSIX系统上有效，因为它需要一些命令行工具。在Linux(Ubuntu)上进行了测试。也许有Windows命令行经验的人可以为Windows添加一个版本。

添加您的.pro:(以下代码假定从buildt文件夹内，../src/可以访问源文件夹；如果不是这种情况，请更改***注释所在的路径)

// Define QT5 macro for use in C++, and select the correct module for QML:
greaterThan(QT_MAJOR_VERSION, 4) {
    DEFINES += QT5
    QT += quick
} else {
    QT += declarative
}

// Define qmake variables for QtQuick version, and if you want, QtQuick Controls:
equals(QT_MAJOR_VERSION, 4) {
    equals(QT_MINOR_VERSION, 7) {
        QT_QUICK_VERSION = 1.0
    }
    equals(QT_MINOR_VERSION, 8) {
        QT_QUICK_VERSION = 1.1
    }
}
equals(QT_MAJOR_VERSION, 5) {
    QT_QUICK_VERSION = 2.$${QT_MINOR_VERSION}
    equals(QT_MINOR_VERSION, 1): QT_QUICKCONTROLS_VERSION = 1.0
    equals(QT_MINOR_VERSION, 2): QT_QUICKCONTROLS_VERSION = 1.1
    equals(QT_MINOR_VERSION, 3): QT_QUICKCONTROLS_VERSION = 1.2
}

// Add a pre-build step which copies your qml folder
QtQuickVersion.target = FORCE
QtQuickVersion.commands = "rm -rf qml/;"
QtQuickVersion.commands += "cp -r ../src/qml/ .;"  // <-- *** Here is the source path
!isEmpty(QT_QUICK_VERSION) {
    QtQuickVersion.commands += "grep -rl 'QtQuick [0-9]\\.[0-9]' qml/ | xargs -r sed -i 's/QtQuick [0-9]\\.[0-9]/QtQuick $${QT_QUICK_VERSION}/g';"
}
!isEmpty(QT_QUICKCONTROLS_VERSION) {
    QtQuickVersion.commands += "grep -rl 'QtQuick.Controls [0-9]\\.[0-9]' qml/ | xargs -r sed -i 's/QtQuick.Controls [0-9]\\.[0-9]/QtQuick.Controls $${QT_QUICKCONTROLS_VERSION}/g';"
}

// Give the Makefile target *any* name which will *not* be created
// as a file, so the step is always executed
PRE_TARGETDEPS += FORCE
QMAKE_EXTRA_TARGETS += QtQuickVersion

在C++(main.cpp)中，您可以创建一个QQuickView，该Qt 4会退回到QDeclarativeView:

#ifdef QT5

#include <QGuiApplication>
#include <QQuickView>
#include <QQmlEngine>

#else

#include <QApplication>
#include <QDeclarativeView>
#include <QDeclarativeEngine>
typedef QApplication QGuiApplication;
typedef QDeclarativeView QQuickView;
// The following is the official fallback for QStringLiteral,
// see qstring.h in Qt 5 after #ifndef QStringLiteral */
#define QStringLiteral(str) QString::fromUtf8("" str "", sizeof(str) - 1)
#endif


int main(int argc, char *argv[])
{
    QGuiApplication a(argc, argv);

    // (add qmlRegisterType etc.)

    // Open the QML view with the main QML document:
    QQuickView view;
    view.setSource(QUrl::fromLocalFile(QStringLiteral("qml/main.qml")));
    view.show();

    // Needed for "Qt.quit()" within QML:
    QObject::connect(view.engine(), SIGNAL(quit()), &a, SLOT(quit()));

    // I normally use this sizing behavior:
    view.setResizeMode(QQuickView::SizeRootObjectToView);

    return a.exec();
}

由上面的代码打开的QML文件qml/main.qml 如下所示:

// This import will replaced with the largest supported QtQuick version:
import QtQuick 1.0

Rectangle {
    width: 450
    height: 200

    Text {
        anchors.centerIn: parent
        horizontalAlignment: Text.AlignHCenter
        font.pointSize: Math.min(parent.width / 10, parent.height / 5)

        // This text will also be replaced to show the correct QtQuick version:
        text: "Hello from\nQtQuick 1.0!"

        // Some fancy animations...
        SequentialAnimation on scale {
            running: true; loops: Animation.Infinite
            NumberAnimation { from: 1; to: .6; easing.type: Easing.InOutQuad; duration: 600 }
            NumberAnimation { from: .6; to: 1; easing.type: Easing.InOutQuad; duration: 600 }
        }
        SequentialAnimation on rotation {
            running: true; loops: Animation.Infinite
            NumberAnimation { from: -10; to: 10; easing.type: Easing.InOutQuad; duration: 2000 }
            NumberAnimation { from: 10; to: -10; easing.type: Easing.InOutQuad; duration: 2000 }
        }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: Qt.quit()
    }
}

QML文件包含一个导入指令，它将选择正确的QtQuick版本(您可以在build文件夹中检查它)。 Text元素中的字符串也将被替换，因此您将在此演示中轻松看到该版本。