创建 Qt Quick 项目
下表列出了从头开始创建新 Qt Quick 项目的向导模板。
类别 | 向导模板 | 目的 |
---|---|---|
应用程序 (Qt) | Qt 快速应用程序 | 创建一个可以包含 QML 和 C++ 代码的 Qt Quick 2 应用程序项目。您可以构建应用程序并将其部署到桌面、嵌入式和移动目标平台。 |
应用程序(Qt for Python) | Qt for Python - Qt 快速应用程序 | 创建一个包含空 Qt Quick Application 的 Python 项目。 |
其他项目 | Qt Quick UI 原型 |
使用包含主视图的单个 QML 文件创建 Qt Quick UI 项目。您可以在 QML 场景预览工具中预览 Qt Quick 2 UI 项目。您不需要构建它们,因为它们不包含任何 C++ 代码。 此项目类型与 Qt Design Studio 兼容。但是,仅当您进行原型设计时才使用此模板。您无法使用此模板创建完整的应用程序。 Qt Quick UI 项目不能部署到嵌入式或移动目标平台。对于这些平台,请改为创建 Qt Quick 应用程序。 |
图书馆 | Qt Quick 2 扩展插件 | 创建 C++ 插件,以提供可以动态加载到 Qt Quick 2 应用程序中的扩展。 |
注意:特定目标平台的 SDK 可能会为该平台安装额外的模板。例如,QNX 模板作为 QNX SDK 的一部分安装。
Qt Creator 创建必要的样板文件。一些文件特定于特定的目标平台。
创建 Qt Quick 应用程序
- 选择文件>新建项目>应用程序 (Qt) > Qt Quick Application >选择.
- 在“项目位置”对话框的“名称”字段中,输入项目的名称。请记住,您以后不能轻易更改项目名称。
- 在Create in字段中,输入项目文件的路径。选中用作默认项目位置复选框以默认在此文件夹中创建新项目。您可以稍后移动项目文件夹而不会出现问题。
- 选择下一步(或在 macOS 上继续)以打开定义构建系统对话框。
- 在Build system字段中,选择用于构建和运行项目的构建系统:qmake、CMake或Qbs。
- 选择下一步打开定义项目详细信息对话框。
- 在所需的最低 Qt 版本字段中选择要开发的Qt 版本。Qt 版本决定了 QML 文件中使用的 Qt Quick 导入。
- 选中Use Qt Virtual Keyboard复选框以向应用程序添加对Qt Virtual Keyboard的支持。
- 选择下一步打开翻译文件对话框。
- 在语言字段中,选择您计划将应用程序翻译成的语言。您可以稍后通过编辑项目文件来添加其他语言。
- 在翻译文件字段中,您可以编辑将为所选语言生成的翻译源文件的名称。
- 选择下一步打开套件选择对话框。
-
为您要为其构建应用程序的平台选择套件。
注意:如果已在Edit > Preferences > Kits(在 Windows 和 Linux 上)或在Qt Creator > Preferences > Kits(在 macOS 上)中指定了套件,则会列出这些套件。有关更多信息,请参阅添加套件。
- 选择下一步打开项目管理对话框。
- 查看项目设置,然后选择完成(在 Windows 和 Linux 上)或完成(在 macOS 上)以创建项目。
Qt Creator 创建一个 QML 文件main.qml,您可以在编辑模式下对其进行修改。
创建基于 Qt Quick 的 Python 应用程序
Qt for Python - Qt Quick Application - Empty向导使您能够创建包含主 QML 文件的 Python 项目。指定运行应用程序的最低 PySide 版本。
该向导将以下导入添加到源文件以提供对QGuiApplication和QQmlApplicationEngine的访问:
import sys
from pathlib import Path
from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine
该向导还添加了一个 main 函数,它创建一个QGuiApplication实例并将系统参数传递给QGuiApplication对象:
if __name__ == "__main__":
app = QGuiApplication(sys.argv)
...
主类中的以下行创建一个QQmlApplicationEngine实例并将生成的 QML 文件加载到引擎对象:
engine = QQmlApplicationEngine()
qml_file = Path(__file__).resolve().parent / "main.qml"
engine.load(qml_file)
最后,向导添加了检查文件是否成功加载的代码。如果加载文件失败,应用程序将退出并显示错误代码。如果加载成功,向导调用该app.exec()
方法进入Qt主循环并开始执行Qt代码:
if not engine.rootObjects():
sys.exit(-1)
sys.exit(app.exec())
在编辑模式下打开 .qml 文件以设计 Qt Quick UI,或使用Qt Design Studio。
创建 Qt Quick UI 项目
例如,Qt Quick UI Prototype 项目可用于测试或制作用户界面原型,或者用于为 QML 编辑设置单独的项目。您不能将它们用于应用程序开发,因为它们不包含:
有关如何将 Qt Quick UI Prototype 项目转换为 Qt Quick Application 项目的更多信息,请参阅。
要创建 Qt Quick UI Prototype 项目:
- 选择File > New Project > Other Project > Qt Quick UI Prototype。
- 选择选择打开项目位置对话框。
- 在名称字段中,输入应用程序的名称。
- 在Create in字段中,输入项目文件的路径。选中用作默认项目位置复选框以默认在此文件夹中创建新项目。
- 选择下一步(或在 macOS 上继续)以打开“定义项目详细信息”对话框。
-
在最低要求的 Qt 版本字段中,选择要使用的 Qt 版本。Qt 版本决定了 QML 文件中使用的 Qt Quick 导入。
您可以稍后添加导入以将 Qt Quick 基本类型与 Qt Quick Controls、Qt Quick Dialogs 和 Qt Quick Layouts(自 Qt 5.1 起可用)结合起来。
-
选中Use Qt Virtual Keyboard复选框以向应用程序添加对Qt Virtual Keyboard的支持。
注意:如果您在安装 Qt 时尚未安装 Qt Virtual Keyboard 模块,则在尝试打开main.qml时会出现错误消息。
- 选择下一步打开套件选择对话框。
-
为您要为其构建应用程序的平台选择套件。
注意:如果已在Edit > Preferences > Kits(在 Windows 和 Linux 上)或在Qt Creator > Preferences > Kits(在 macOS 上)中指定了套件,则会列出这些套件。有关更多信息,请参阅添加套件。
- 选择下一步打开项目管理对话框。
- 查看项目设置,然后选择完成(在 Windows 和 Linux 上)或完成(在 macOS 上)以创建项目。
Qt Creator 创建以下文件:
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。