QT Quick（C++）跨平台应用程序项目实战教程 2 — 环境搭建和项目创建

钱彬 (Qian Bin)

已于 2025-03-22 09:39:35 修改

阅读量1k

点赞数 24

文章标签： qt c++ qt quick qml 实战教程人工智能

于 2025-03-19 20:49:49 首次发布

本文链接：https://blog.csdn.net/qianbin3200896/article/details/146350184

版权

引言

在上一篇文章中，我们介绍了本教程的目标和结构，并简要说明了Qt Quick和C++在跨平台开发中的重要性。本文是教程的第2篇，我们将详细讲解如何搭建Qt开发环境，并创建一个Qt Quick项目。这是开发跨平台应用程序的第一步，也是至关重要的一步。

1. 安装Qt开发环境

1.1 下载Qt安装包

首先，需要下载并安装Qt开发环境。Qt提供了一个名为Qt Online Installer的工具，可以帮助我们轻松安装Qt框架、Qt Creator IDE以及相关的工具和库。

首先访问Qt官方网站并下载适用于Windows操作系统的安装包，如下图所示。

如果官网下载速度慢，也可以选择清华大学开源软件镜像站进行下载。

1.2 安装Qt

双击安装包进入安装界面。首先需要登录Qt账户，如果没有需要按照界面提示进行账户注册然后再登录。

然后选择安装目录并且选择自定义安装：

在接下来的安装过程中，需要选择要安装的组件，推荐按照下图所示进行勾选

最后按照默认提示完成安装即可（在安装过程中建议最好关闭杀毒软件）。安装过程中如果出现下载错误，可以单击“重试”按钮，大部分错误都是因为网络不稳定因素造成的，通过重试可以重新断点续传。

本教程安装的Qt版本为6.8.2，这是一个长期支持版本。Qt Creator版本为16.0.0。

1.3 安装MSVC编译器

前面安装的Qt本质上是一个C++组件库，它的运行还需要依赖C++及编译器环境。由于本教程是在Windows系统上进行开发，因此优先推荐适配Windows C++的MSVC编译器。

具体的，可以使用Visual Studio 2022来安装对应的MSVC编译器。首先前往Visual Studio官网下载Visual Studio 2022安装包。

下载完成后双击安装包进行安装，在组件选择时选择“使用C++的桌面开发”，如下图所示：

选择好以后安装默认提示进行安装即可。

2. 创建Qt Quick项目

2.1 创建新项目

打开Qt Creator，依次单击菜单栏顶部“文件”->“New Project”，在弹出的项目类型选项中选择Qt Quick Application：

设置项目路径及名称：

然后选择对应的Qt版本：

最后选择构建套件：

最后单击完成即可。

2.2 项目结构

创建项目后，会自动生成以下文件和文件夹：

Main.qml：这是Qt Quick应用程序的主界面文件，使用QML语言编写。
main.cpp：这是C++入口文件，负责启动QML引擎并加载main.qml。
CMakeLists.txt：这是项目的构建配置文件。

2.3 运行项目

单击左下角锤子状“按钮”，即可编译项目。

编译完成后，按Ctrl+R健运行启动程序，如下图所示：

你的第一个Qt Quick应用程序！

3. 理解项目代码

3.1 `main.cpp`文件

main.cpp是应用程序的入口点，代码如下：

#include <QGuiApplication>
#include <QQmlApplicationEngine>

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

    QQmlApplicationEngine engine;
    QObject::connect(
        &engine,
        &QQmlApplicationEngine::objectCreationFailed,
        &app,
        []() { QCoreApplication::exit(-1); },
        Qt::QueuedConnection);
    engine.loadFromModule("AudioPlayer", "Main");

    return app.exec();
}

QGuiApplication：管理GUI应用程序的控制流和主设置。
QQmlApplicationEngine：用于加载和运行QML文件。
engine.loadFromModule：加载Main.qml文件作为应用程序AudioPlayer的主界面。

3.2 M`ain.qml`文件

Main.qml定义了应用程序的用户界面，代码如下：

import QtQuick

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")
}

Window：表示应用程序的主窗口。
width和height：设置窗口的初始大小。
visible：设置窗口是否可见。
title：设置窗口标题。

现在，你已经成功搭建了Qt开发环境，并创建了第一个Qt Quick项目。在下一篇文章中，我们将深入探讨Qt Quick的基础知识，学习如何使用QML创建更复杂的用户界面。

上一章：QT Quick（C++）跨平台应用程序项目实战教程 1 — 教程简介-CSDN博客

下一章：QT Quick（C++）跨平台应用程序项目实战教程 3 — 项目基本设置（窗体尺寸、中文标题、窗体图标、可执行程序图标）-CSDN博客