目录

前言

QT_QML_SINGLETON_TYPE 属性

基本用法

示例

1. 创建一个基本的 CMake 项目

2. 编辑 CMakeLists.txt

3. 创建 main.cpp

4. 创建 MySingleton.qml

5. 创建 qml.qrc

6. 创建 main.qml

构建和运行项目

结论

---

前言

在使用 Qt 和 CMake 构建项目时，有时你可能需要将某些 QML 文件设置为单例类型。Qt 为此提供了一个名为 QT_QML_SINGLETON_TYPE 的属性，可以通过 CMake 的 set_source_files_properties 命令来设置。

QT_QML_SINGLETON_TYPE 属性

当你希望将某个 QML 文件在整个应用程序中作为单例实例使用时，可以将其标记为单例类型。这在大型 QML 项目中尤其有用，因为它简化了状态管理和资源共享。

基本用法

你可以通过以下步骤在 CMake 项目中设置 QT_QML_SINGLETON_TYPE 属性：

1. 确保你已经导入了 Qt 和 QML 模块。
2. 使用 set_source_files_properties 命令设置 QML 文件的 QT_QML_SINGLETON_TYPE 属性。

示例

以下是一个完整的示例，展示如何在 CMake 项目中将 QML 文件设置为单例类型。

1. 创建一个基本的 CMake 项目

首先，创建一个基本的 CMake 项目结构：

MyQtApp/
├── CMakeLists.txt
├── main.cpp
├── MySingleton.qml
└── qml.qrc

2. 编辑 CMakeLists.txt

在 CMakeLists.txt 文件中，添加以下内容：

cmake_minimum_required(VERSION 3.14)
project(MyQtApp LANGUAGES CXX)find_package(Qt6 REQUIRED COMPONENTS Core Quick)set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)add_executable(MyQtAppmain.cppqml.qrc
)set_source_files_properties(MySingleton.qml PROPERTIES QT_QML_SINGLETON_TYPE TRUE)target_link_libraries(MyQtAppPRIVATE Qt6::Core Qt6::Quick
)qt_add_qml_module(MyQtAppURI MyAppVERSION 1.0QML_FILES MySingleton.qml
)

3. 创建 main.cpp

在项目目录中，创建 main.cpp 文件，并添加以下内容：

#include <QGuiApplication>
#include <QQmlApplicationEngine>int main(int argc, char *argv[])
{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();
}

4. 创建 MySingleton.qml

在项目目录中，创建 MySingleton.qml 文件，并添加以下内容：

import QtQuick 2.15QtObject {id: singletonproperty string message: "Hello from Singleton!"
}

5. 创建 qml.qrc

在项目目录中，创建 qml.qrc 文件，并添加以下内容：

<!DOCTYPE RCC><RCC version="1.0">
<qresource><file>MySingleton.qml</file><file>main.qml</file>
</qresource>
</RCC>

6. 创建 main.qml

在项目目录中，创建 main.qml 文件，并添加以下内容：

import QtQuick 2.15
import QtQuick.Controls 2.15
import MyApp 1.0ApplicationWindow {visible: truewidth: 640height: 480title: qsTr("Hello World")Text {text: MySingleton.messageanchors.centerIn: parent}
}

构建和运行项目

完成上述步骤后，你可以构建并运行你的 Qt 项目，看看 QML 单例的效果。

mkdir build
cd build
cmake ..
cmake --build .
./MyQtApp

结论

通过这些步骤，你应该能够在 CMake 项目中使用 set_source_files_properties 命令将 QML 文件设置为单例类型。如果有任何问题或需要进一步的帮助，请随时告诉我！