C++常用的支持中文的GUI库Qt 6之二：项目的结构、资源文件的使用

上一篇Qt 6的下载、安装与简单使用https://blog.csdn.net/cnds123/article/details/130730203，本文介绍Qt 6的项目的结构、资源文件的使用与发布。

基础

这一部分，初学时不明白是何意思不要纠结，先大体了解即可，在学习实践一段时间后，回头看（回顾）时，就能更好的理解了。

在Qt6中， qmake、CMake 和 Qbs 构建系统的特点

qmake

qmake 使用起来非常简单，并且对于大多数项目来说，足以满足需求。如果你的项目仅需要基本的构建功能，例如编译和链接源文件、管理依赖库和创建安装程序，则使用 qmake 是一个不错的选择。

CMake

CMake 是一种跨平台的构建工具，它可以生成多种不同的项目文件类型，例如 Makefile、Visual Studio Solution 等。CMake 使用起来相比 qmake 要复杂一些，但是它更灵活，并且在处理更大型的项目时会更有优势。如果你打算开发较大规模的应用或库，使用 CMake 并将其与其他构建工具集成可能是一个更好的选择。

Qbs

Qbs 是 Qt 的下一代构建工具，它基于 QML 和 JavaScript，并提供了一种现代、模块化和易于使用的构建语言。Qbs 相比 qmake 和 CMake，使用起来需要一些学习成本，但是它的支持和集成良好，并且它的编译速度更快。如果你希望与 Qt Creator 集成更好，同时在构建速度和项目规模方面获得更大的优势，则使用 Qbs 可能是一个更好的选择。

Qt创建资源文件的方式有以下两种：

1.使用Qt Creator创建资源文件

在Qt Creator中右键单击项目文件夹或文件夹，选择“Add New”->“Qt”->“Qt Resource File”，在弹出的对话框中设置资源文件的名称和保存位置。然后在资源文件编辑器中添加你需要的资源文件，例如图片、音频等。

2.手动创建.qrc文件

可以手动创建一个.qrc文件，然后在文件中添加资源文件的路径及其相关信息。对新手来说，较难就不多说了。

这两种方式都可以用于在Qt6中创建资源文件。使用Qt Creator可以更快捷方便地创建.qrc文件，而手动创建.qrc文件则可以更加精细地控制资源文件的添加和管理。

不同的项目构建系统（qmake、CMake和Qbs）创建的项目资源文件的使用概述：

1.qmake项目

在Qt Creator中右键单击项目文件夹或文件夹，选择“Add New”->“Qt”->“Qt Resource File”，在弹出的对话框中设置资源文件的名称和保存位置。然后在资源文件编辑器中添加你需要的资源文件，例如图片、音频等。

添加资源文件后，在.pro项目文件中自动添加了以下代码：

RESOURCES += resources.qrc

其中，resources.qrc为你刚才创建的资源文件名称。

2.CMake项目：

在CMake项目中创建资源文件的方法与在qmake项目中类似。你可以创建一个资源文件，然后将它添加到项目中。例如，可以在项目目录下创建一个名为res.qrc的文件，然后在CMakeLists.txt中添加以下代码:

qt6_add_resources(QTRESOURCES res.qrc)

add_executable(project_name ${QTRESOURCES} ...)

其中，${QTRESOURCES}表示将res.qrc文件中的资源打包到项目中。注意其在文件中的位置：

# CMakeLists.txt

# 最开始应该是 cmake_minimum_required 和 project 命令

# ...

# 找包含 Qt 的 CMake 模块文件

find_package(Qt6 COMPONENTS Widgets REQUIRED)

# 添加资源文件的命令，这里以 res.qrc 为例

qt6_add_resources(QTRESOURCES res.qrc)

# 设置项目文件

set(PROJECT_SRC_FILES

    main.cpp

    # ... 其他源文件 ...

)

# 编译并链接可执行文件

add_executable(project_name

    ${PROJECT_SRC_FILES}

    ${QTRESOURCES} # 把资源文件添加到可执行文件中

)

target_link_libraries(project_name

    Qt6::Widgets

    # ... 其他依赖库 ...

)

3.Qbs项目：

在Qbs项目中创建资源文件与其他两种构建工具的项目略有不同。

首先，你需要在项目文件中添加以下代码片段，创建一个AssetBundle文件：

// 项目路径

var projectPath = project.sourceDirectory

// 资源路径

var assetsPath = projectPath.append("assets")

// 创建AssetBundle文件

var bundle = AssetBundle {

    name: "res.qrc"

    files: [

        // 添加资源文件

        assetsPath.append("icons/search.png")

    ]

}

project.addAssetBundle(bundle)

在上述代码中，project.sourceDirectory 指的是项目文件所在的目录，assets 文件夹是我们假设存在的资源文件存储目录。这里我们利用 AssetBundle 创建了一个 res.qrc 的二进制文件，其中包含 /assets/icons/search.png 这个路径下的图片资源，它将被打包到 AssetBundle 文件中。

然后在你需要使用资源文件的地方，你需要使用以下代码片段进行加载：

import qbs

// 加载方法

var resourceContent = "";

var resourcePath = qbs.getResolvedFilePath("qrc:/res.qrc/path/to/resource");

if (file.exists(resourcePath))

    resourceContent = file.read(resourcePath);

在上述代码中，我们使用 qbs.getResolvedFilePath 来获取类似于文件系统路径的 path。然后使用 file.read 命令读取它的内容，即我们之前要使用的图片资源。

总之，使用Qt Creator创建资源文件可以方便地管理和使用资源文件。对于不同的项目构建工具，具体操作略有不同，并需要遵循相关的规范和语法。

先创建一个Qt项目

要求：输入半径值，单击“计算”按钮后，显示圆面积值

运行Qt Creator，在欢迎界面左侧点“Projects”按钮

​

相应的文件已经自动加载到项目文件列表中，如下图：

​

QT Creator向导创建项目后，会自动生成一些源文件和资源文件。

现在，可以进行界面设计

点击Forms 部分展开，双击其中的.ui文件，这里是mainwindow.ui

​

拖曳控件容器栏的滑动条，在Display Widgets容器栏中找到Label标签控件，拖曳三个此控件到中间的窗体中；同样，在Input Widgets容器栏中找到Line Edit编辑框控件，拖曳此控件到中间的窗体中，用于输入半径值；在Buttons容器栏中找到Push Button按钮控件，拖曳此控件到中间的窗体中，用于提交响应单击事件。

​

​

然后需要对各控件属性进行修改，窗体中的控件在右侧出现相应的属性，按下表修改

修改后的情况：

​

现在，编写计算圆面积功能代码

在“Line Edit”编辑框内输入半径值，然后单击“计算”按钮，则在areaLabel_2中显示对应的圆面积。

操作步骤如下。

在“计算”按钮上按鼠标右键，在弹出的下拉菜单中选择“Go to slot...”命令，在“Go to slot”对话框中选择QAbstractButton的“clicked()”信号，单击“OK”按钮，如图所示：

​

进入MainWindow.cpp文件中按钮单击事件的槽函数on_countBtn_clicked()，在此函数中添加如下代码：

void MainWindow:: on_countBtn_clicked()
{bool ok;QString tempStr;QString valueStr = ui->radiusLineEdit->text();int valueInt = valueStr.toInt(&ok);double area = valueInt * valueInt * PI;				//计算圆面积ui->areaLabel_2->setText(tempStr.setNum(area));
}

在MainWindow.cpp文件开始处添加以下语句：

const static double PI = 3.1416;

参见下图：

​

现在可以编译运行程序了

在“Line Edit”文本框内输入半径值，单击“计算”按钮后，显示圆面积值：

​

QT Creator创建的项目的结构

QT Creator创建的项目通常具有以下结构，参见下图：

​

 ☆项目文件 /构建系统的配置文件:

Qmake的是.pro文件（应用程序名称.pro）

CMake的是CMakeLists.txt文件

Qbs的是. qbs文件（应用程序名称. qbs）

它们都是一个文本文件，包含了整个项目的配置信息，包括所需要的库文件和头文件等。

☆源代码文件 (.cpp, .h)：这些文件包含了程序的实现代码和头文件。在QT Creator中，这些文件可以通过项目目录中的“Sources”和“Headers”文件夹进行组织。

☆界面设计文件 (.ui)：这些文件用来描述应用程序的用户界面。在QT Creator中，这些文件可以通过项目目录中的“Forms”文件夹进行组织。

☆资源文件 (.qrc)：如果已建立这话，因为还未建立故未出现，后面将建立。这些文件用来管理应用程序中的图像、音频、文本和其他数据文件。在QT Creator中，这些文件可以通过项目目录中的“Resources”文件夹进行组织。

☆编译输出文件 (.exe, .dll, .so)：这些文件是编译器生成的最终可执行文件或库文件。在QT Creator中，这些文件可以通过项目（Projects）目录中的“Builds”文件夹进行组织。

资源文件的使用

Qt资源系统（Qt Resource System）是一种将图片、数据存储在二进制文件中的一套系统。

在GUI程序中，不可避免地将会使用各类资源，例如图片、音视频资源等，有这些资源，我们可以将普通的按钮设置成带图片的，一些标签也可以用图片来显示，还可以播放动图等。

为了方便的使用这些资源，我们需要使用Qt中的资源文件(.qrc文件)。

Qt使用资源文件(.qrc文件)可以将应用程序所需要的资源文件(如图片、字体、音频等)打包成一个二进制文件，以便于应用程序访问，避免了资源文件和应用程序分离导致的路径问题。这种方法的好处是，将资源文件打包到应用程序中可以使应用程序更加独立和可移植。无论您将应用程序复制到何处，都可以确保它具有所需的资源，而无需再次下载或复制它们。请注意，如果您需要更新应用程序中的资源文件（例如添加新的图像或更改现有的图像），则需要重新编译应用程序以将新的资源文件包括在内。

使用Qt Creator创建资源文件（.qrc文件），可以按照以下步骤进行：

在Qt Creator中创建一个新的Qt项目或打开一个已有的Qt项目。

在项目树中右键单击项目（Projects）名称，选择“添加新文件（Add New）”。

在“添加新文件（Add New）”对话框中，选择“Qt” > “Qt资源文件（Qt Resoorce File）”>“选择（Change）”按钮。

在“Qt资源文件（Qt Resoorce File）”对话框中的“Location”页，输入资源文件的名称和路径，单击“下一步”；

然后在“汇总页（Summary）”对话框中添加资源文件。单击“完成（Finish）”按钮，完成资源文件的添加。

参见下图：

​

添加资源文件后，才可以进行下面的操作。

为程序窗口建立图标。Qt程序窗口图标支持多种图片格式，例如ICO、PNG、SVG等。

在Qt Creator中，打开.qrc文件添加资源文件的步骤：

在Qt Creator中打开您的项目。

在左侧的“Projects（项目）”面板中选择您的项目文件夹并单击展开。

找到.qrc文件并右键单击它。

在弹出菜单中选择“Open in Editor（在编辑器中打开）”。

现在，就可以用资源视图中的"Add Prefix"和"Add Files"，并按照提示添加相应的文件或文件夹。

先点击资源视图中的Add Prefix按钮，添加前缀名可以修改（前缀名字主要是为了区分这些资源的作用，例如背景音乐资源文件，或者专门给按钮用的图片，或者专门用来做头像的图片等）。我这里建立一个 / Res

然后点击Add Files按钮，添加需要的资源文件。为了方便管理避免误操作和后续的修改，建议你在项目目录中建立子文件夹，将资源文件先手工复制进去。【否则出现如下提示

​

】

添加窗体图标（icon）、给按钮用的图标（icon）和给窗体背景图片有多种办法。

下面是设置窗体图标办法

我这里是（其中项目目录ch01，资源文件目录ResFolder）

​

用资源视图中的"Add Prefix"和"Add Files"，先将作为窗体图片的Qt.png图片文件添加到.qrc文件中，操作步骤：Qt Creator中，在左侧的“Projects(项目)”面板中，选择您的项目文件夹单击展开，找到.qrc文件并右键单击它，在弹出菜单中选择“Open in Editor （在编辑器中打开）”，这样，您就可以将资源文件——这里是Qt.png图片文件添加到.qrc文件中了。参见下图：

​

再按如下办法之一进行：

法1、在Qt Designer中直接设置：在窗体属性编辑器中，在"windowIcon"属性栏中选择图标文件。

​

法2、也可以使用代码设置

提示：在应用程序中使用资源文件，可以使用":/"前缀来表示该资源文件，如：QPixmap(":/images/logo.png")，其中":/"表示根目录，后面的"images/logo.png"则表示在资源文件中的路径。

我这里将图标文件添加到应用程序源文件中，在main.cpp中添加以下代码：

QGuiApplication::setWindowIcon(QIcon(":/Res/ResFolder/Qt.png"));//添加窗体图标

参见下图：

​

用上面两种办法之一即可。

现在运行看看，在Qt Creator中，可以通过“build”菜单中的【build Project “项目名”Ctrl+B】选项来编译程序，然后通过【run Ctrl+B】选项来运行程序。

运行后可见图标换了：

​

设置窗体背景图片

用资源视图中的"Add Prefix"和"Add Files"，先将作为窗体背景图片的BGImage.jpg图片文件添加到.qrc文件中，

参见下图：

​

再按如下办法进行：

在Qt Designer中直接设置：在窗体属性编辑器中，在"styleSheet"属性栏中指定背景图片路径。参见下图：

​

注意，上图中需要手工加入background-image: 

也可以使用代码设置窗体背景图片，比较麻烦，在此就不介绍了。

现在运行，窗体背景换了：

​

特别说明：将图像文件添加到.qrc文件中，则该文件会被打包进应用程序二进制文件中。这意味着，当运行应用程序时，而无需在磁盘上查找它。Qt6可以直接从应用程序二进制文件中读取图像数据，然后使用它来显示图像或进行其他操作。无论您将应用程序复制到何处，都可以确保它具有所需的资源，而无需再次下载或复制它们。

请注意，如果您需要更新应用程序中的资源文件（例如添加新的图像或更改现有的图像），则需要重新编译应用程序【在Qt Creator中，可以通过单击“Build Project”按钮或使用快捷键“Ctrl+B”来执行此操作】以将新的资源文件包括在内。

Qt 资源系统更多情况可参见https://zhuanlan.zhihu.com/p/60457016

上面的小应用程序就算开发完了，下篇介绍项目的发布：

C++常用的支持中文的GUI库Qt 6之三： 项目的发布 https://blog.csdn.net/cnds123/article/details/130827966