对于高版本的QT,如果想要创建使用qmake构建,需要选择compat,如下图所示,但是指定不同的最小QT版本时,项目的默认结构会有不同。本文通过对QT5和QT6两种版本的默认项目进行分析,确定不同QT版本下怎么进行资源的管理。
.pro
文件内容QT += quick
# You can make your code fail to compile if it uses deprecated APIs.
# In order to do so, uncomment the following line.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000 # disables all the APIs deprecated before Qt 6.0.0
SOURCES += \
main.cpp
RESOURCES += qml.qrc
# Additional import path used to resolve QML modules in Qt Creator's code model
QML_IMPORT_PATH =
# Additional import path used to resolve QML modules just for Qt Quick Designer
QML_DESIGNER_IMPORT_PATH =
# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target
qml.qrc
文件并追加到RESOURCES
,使用qml.qrc
统一管理资源文件.qrc
文件中需要为每个资源指定一个前缀,在使用资源文件时,要以指定的前缀开头,利用前缀可以方便对资源进行分组管理等。以资源编辑器方式打开qml.qrc
文件时如下所示,可以发现,资源文件的默认前缀为/
。注意:在QT5版本的项目中,添加QML文件时一定要选择添加到默认的.qrc
文件中,如果选择添加到qt5_project.pro
文件中,会像QT6版本的项目一样,只在.pro
文件中向DISTFILES
字段追加新建的QML文件。具体情况请参见下面的QT6新建QML文件。
main.cpp
#include
#include
int main(int argc, char *argv[])
{
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
#endif
QGuiApplication app(argc, argv);
QQmlApplicationEngine engine;
const QUrl url(QStringLiteral("qrc:/main.qml"));
QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
&app, [url](QObject *obj, const QUrl &objUrl) {
if (!obj && url == objUrl)
QCoreApplication::exit(-1);
}, Qt::QueuedConnection);
engine.load(url);
return app.exec();
}
main.cpp
文件中多了个低版本情况下启用高DPI下屏幕自适应的设置main.qml
import QtQuick 2.15
import QtQuick.Window 2.15
Window {
width: 640
height: 480
visible: true
title: qsTr("Hello World")
}
.pro
文件内容QT += quick
SOURCES += \
main.cpp
resources.files = main.qml
resources.prefix = /$${TARGET}
RESOURCES += resources
# Additional import path used to resolve QML modules in Qt Creator's code model
QML_IMPORT_PATH =
# Additional import path used to resolve QML modules just for Qt Quick Designer
QML_DESIGNER_IMPORT_PATH =
# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target
默认使用resources
管理资源文件,resources
变量也需要追加到RESOURCES
变量,该变量有两个成员:
resources.files
保存所有资源文件的列表resources.prefix
表示使用资源文件时的前缀名,这和QT5的.qrc
文件中的前缀名相对应新建的.qml
文件时默认只会将新文件追加在.pro
文件中的DISTFILES
字段中
.pro
文件变为:
添加后的目录结构为:
注意:这时如果想要使用新建的.qml
文件,会报QQmlApplicationEngine failed to load component
错,因为DISTFILES
并不能告诉编译器新建了资源文件,如果想要正常使用,需要将资源文件的名字追加到resoures.file
后
make
编译时需要添加到dist目标中的文件,我们可以将其中指定的.qml
文件删除掉,并不影响程序的运行最后的.pro
文件如下图所示:
main.cpp
#include
#include
int main(int argc, char *argv[])
{
QGuiApplication app(argc, argv);
QQmlApplicationEngine engine;
const QUrl url(u"qrc:/qt6_project/main.qml"_qs);
QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
&app, [url](QObject *obj, const QUrl &objUrl) {
if (!obj && url == objUrl)
QCoreApplication::exit(-1);
}, Qt::QueuedConnection);
engine.load(url);
return app.exec();
}
main.qml
import QtQuick
Window {
width: 640
height: 480
visible: true
title: qsTr("Hello World")
}
此时向两个项目中都添加一个images
文件夹,并向其中添加一张图片qt.png
,目录结构分别变为:
资源文件需要先添加到项目中才可以使用,由于在两个版本中管理资源文件的方式并不相同,所以添加资源文件的方式也不同。
QT5默认使用.qrc
管理资源文件,因此应该使用.qrc
文件专门管理图片资源,参考——Qt 资源系统(Qt Resource System)。
由于本文主要对比两个版本的差异,这里直接右键qml.qrc
将qt.png
添加到qml.qrc
文件中,如下所示:
由于QT6默认在.pro
文件中使用resources
变量管理资源文件,所以添加资源时,直接将资源文件追加到resources.file
后即可,如下:
尽管在QT6版本中,默认情况下将资源的管理方式修改为了使用resources
变量,但是通过编译时的执行过程可以发现,实际还是会生成一个qmake_resources.qrc
文件,如下所示:
实际应该还是通过.qrc
进行资源管理,所以在这两种方式下,使用资源文件的方式是相同的。
根据官方文档的描述,在使用图片时,有两种形式。以上面的QT5项目为例,使用图片的方式为:
Image {
id: img
source: "images/qt.png"
}
Image {
id: img
source: "qrc:/images/qt.png"
}
注意,QT6项目的资源文件的默认前缀是/$${TARGET}
,其中$${TARGET}
表示TARGET
变量的值,默认情况下TARGET
的值和.pro
文件名相同。
所以在以上创建的QT6项目中,使用资源文件时需要添加的前缀就是/qt6_project
,这从main.cpp
文件里加载main.qml
中也有体现:
因此,在上面的QT6项目中,使用图片的两种方式为:
Image {
id: img
source: "qt6_project/images/qt.png"
}
Image {
id: img
source: "qrc:/qt6_project/images/qt.png"
}
.qrc
文件管理资源resources
变量管理资源.qrc
文件中,可以直接使用resources
变量后才能使用.qrc
文件管理资源resources
变量管理资源