跳转至

1 Qt 简介

Qt 是一个跨平台的 C++ 应用框架，可以用于开发图形用户界面 (GUI) 程序和命令行工具。具有功能丰富的 API 和强大的开发工具。

2 Qt 开发环境安装

Qt 作为开发图形界面的软件，用户需要预先使能环境的图形化界面，部分命令只能在图形化界面执行。关于使能图形化界面，本文不展开介绍，用户可以参考《安装启动指南》中的”桌面安装“章节。

2.1 dnf 安装

用户可以直接使用如下命令安装：

dnf install -y qt5-qtbase qt5-qtbase-devel

2.2 自定义安装

如果用户期望自定义安装，可以参考如下步骤，从 Qt 官网获取 online 安装器进行安装：

1 预装安装器的依赖包

dnf install -y xcb-util-wm xcb-util-image xcb-util-keysyms xcb-util-renderutil
2 到 Qt 官网下载安装器，用户可自行选择安装器的版本

wget https://download.qt.io/archive/online_installers/4.5/qt-unified-linux-x64-4.5.2-online.run
chmod +x qt-unified-linux-x64-4.5.2-online.run
3 点开图形化界面的 Terminal 工具，在此直接执行安装器

./qt-unified-linux-x64-4.5.2-online.run

执行后会出现 Qt 的安装界面，用户按照指引一步步安装即可

qt 安装界面

3 Qt 简单使用

在 Qt 项目中，工程结构是文件和目录组织的方式，以便于开发、构建和部署 Qt 应用程序。以下是一个典型的 Qt 工程结构：

my_project/
├── my_project.pro           // Qt 项目文件，描述项目的构建信息
├── src/                     // 存放源代码文件的目录
│   ├── main.cpp             // 应用程序入口点
│   ├── mainwindow.cpp       // 主窗口类实现文件
│   ├── mainwindow.h         // 主窗口类头文件
│   ├── widgets.cpp          // 其他组件类的实现文件
│   └── widgets.h            // 其他组件类的头文件
├── resources/               // 资源文件目录，如图标、图片等
│   ├── images/              // 图像文件目录
│   ├── icons/               // 图标文件目录
│   └── qml/                 // 存放 QML 文件的目录（如果使用 Quick 或 QML）
├── forms/                   // 存放 UI 文件（.ui）的目录
│   ├── mainwindow.ui        // 主窗口 UI 设计文件
│   └── widget.ui            // 其他组件 UI 设计文件
└── tests                    // 单元测试目录
    ├── reverse_test.cpp     // 单元测试源码
    └── tests.pro            // 单元测试项目文件，描述项目的构建信息

为了便于理解，以一个简单的例子来介绍 Qt 项目，这个 demo 最终将在图形界面打开一个窗口，输出 "Hello OpenCloudOS!"

3.1 创建项目

参考上文中关于目录结构的介绍，创建如下文件和目录：

cd hello_opencloudos/
tree -L 3
.
├── hello_opencloudos.pro
├── src
│   ├── main.cpp
│   ├── mainwindow.cpp
│   ├── mainwindow.h
│   └── utils.h
└── tests
    ├── reverse_test.cpp
    └── tests.pro

源代码如下：

hello_opencloudos.pro 文件内容：

TEMPLATE = app

QT += widgets

TARGET = hello_opencloudos
CONFIG += console

SOURCES += src/main.cpp \
           src/mainwindow.cpp \

HEADERS += src/mainwindow.h \
           src/utils.h

src/main.cpp 文件内容：

#include <QApplication>
#include "mainwindow.h"

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    MainWindow mainWindow;

    mainWindow.setWindowTitle("Hello OpenCloudOS!");
    mainWindow.show();

    return app.exec();
}

src/mainwindow.h 文件内容：

#pragma once

#include <QWidget>

class MainWindow : public QWidget
{
    Q_OBJECT

public:
    MainWindow();
};

src/mainwindow.cpp 文件内容：

#include "mainwindow.h"
#include "utils.h"
#include <QWidget>
#include <QVBoxLayout>
#include <QLabel>

MainWindow::MainWindow()
{
    QVBoxLayout *layout = new QVBoxLayout(this);
    QLabel *label = new QLabel("Hello OpenCloudOS!", this);
    layout->addWidget(label);

    setLayout(layout);
}

src/utils.h 文件内容：

#pragma once

#include <QString>

// Reverse returns a reversed copy of a QString.
static inline QString Reverse(const QString &s)
{
    auto r = s;
    std::reverse(r.begin(), r.end());
    return r;
}

tests/tests.pro 文件内容：

TEMPLATE = app
CONFIG += console
CONFIG -= app_bundle

QT += testlib

TARGET = reverse_test
DEPENDPATH += ../src
INCLUDEPATH += ../src

SOURCES += reverse_test.cpp

tests/reverse_test.cpp 文件内容：

#include <QtTest>
#include "../src/utils.h"

class TestReverse : public QObject
{
    Q_OBJECT

private slots:
    void reverse_data();
    void reverse();
};

void TestReverse::reverse_data() {
    QTest::addColumn<QString>("input");
    QTest::addColumn<QString>("expected");

    QTest::newRow("empty") << "" << "";
    QTest::newRow("single-char") << "a" << "a";
    QTest::newRow("odd-length") << "abc" << "cba";
    QTest::newRow("even-length") << "abcd" << "dcba";
}

void TestReverse::reverse() {
    QFETCH(QString, input);
    QFETCH(QString, expected);

    QString result = Reverse(input);
    QCOMPARE(result, expected);
}

QTEST_MAIN(TestReverse)
#include "reverse_test.moc"

3.2 构建项目

返回项目根目录，执行如下命令生成 Makefile，本例中，根目录为 hello_opencloudos/

qmake-qt5

完成后会在当前目录下生成 Makefile

ls
hello_opencloudos.pro  Makefile  src  tests

执行如下命令构建项目

make -j

构建成功后会在当前目录生成二进制文件

tree -L 3
.
├── hello_opencloudos
├── hello_opencloudos.pro
├── main.o
├── mainwindow.o
├── Makefile
├── moc_mainwindow.cpp
├── moc_mainwindow.o
├── moc_predefs.h
├── src
│   ├── main.cpp
│   ├── mainwindow.cpp
│   ├── mainwindow.h
│   └── utils.h
└── tests
    ├── reverse_test.cpp
    └── tests.pro

3.3 执行

点开图形化界面的 Terminal 工具，在此直接上一步生成的二进制，即可得到预期的打印窗口 qt demo演示

3.4 单元测试

到 tests/ 目录下执行如下命令

qmake-qt5
make -j

会在当前目录生成二进制文件

ls -al reverse_test
-rwxr-xr-x 1 root root 23920 May 30 14:56 reverse_test

点开图形化界面的 Terminal 工具，执行生成的二进制文件，即可运行用例 test.png

4 代码调试

4.1 通用调测工具

由于代码本身是用 C++ 编写的，用户可以直接使用通用的调测工具进行调试，如：valgrind, perf, strace, gdb 等，具体用法本节不多介绍

4.2 qDebug() 函数

qDebug() 函数可以将调试信息直接输出到控制台，在开发阶段也是不错的调测选择，使用方式如下：

#include<QDebug>

...
qDebug("x: %d",x);
...

5 Qt 包管理

系统默认的 dnf 包管理工具已经可以处理 Qt 相关软件包的依赖关系。除此之外，Qt 提供了自己的包管理工具 aqtinstall，使用方式如下

使用如下命令安装 aqtinstall

dnf install -y pip
pip3 install aqtinstall

默认情况下命令行工具路径为 /usr/local/bin/aqt，需要添加环境变量

export PATH=$PATH:/usr/local/bin

之后就可以通过 aqt 命令安装 Qt 的软件包，格式如下：

aqt install <Qt-version> <host> <target> [--outputdir <install_dir>] [other-options]

如：安装一个 gcc_64 到 ~/Qt 目录下

aqt install 5.12.0 linux desktop gcc_64 --outputdir ~/Qt

6 Qt 工具介绍

6.1 qtpaths 命令

qtpaths 是一个命令行实用程序，用于查询与 Qt 安装相关的路径。它可以提供有关 Qt 安装位置、库、插件、数据文件等的路径信息。在调试 Qt 项目或查找特定组件位置时，qtpaths 非常有用。

6.1.1 安装 qtpaths 命令

执行如下命令即可安装 qtpaths 命令

dnf install -y qt5-qttools

6.1.2 qtpaths 命令使用

qtpaths 命令可以在非图形桌面执行，以下是一些常用选项的示例：

  • 获取 Qt 安装路径：

qtpaths --install-prefix
- 获取插件路径：

qtpaths --plugin-dir

6.2 qtdiag 命令

qtdiag 是一个用于诊断 Qt 安装和配置问题的命令行工具。

6.2.1 安装 qtdiag 命令

执行如下命令即可安装 qtdiag 命令

dnf install -y qt5-qttools-devel

6.2.2 qtdiag 命令使用

qtdiag 命令需要在图形化界面的 Terminal 工具中执行。

直接执行 qtdiag 命令后，会全量打印Qt 版本信息、操作系统信息、已安装图像格式插件、可用字体等。

qtdiag