在 Qt6 中使用 MQTT：入门指南

简介

Qt 是一个跨平台框架和工具包，可用于开发能够在不同硬件平台和操作系统上运行的软件。Qt 框架包括丰富的库和工具，开发者可以轻松构建具备本地 UI 和性能的应用程序。它被广泛应用于嵌入式设备和物联网软件的开发。

MQTT 是一种基于发布/订阅模式的轻量级物联网消息协议。它能够以非常少的代码和带宽为网络设备提供实时可靠的消息服务。

本文提供了在 Qt6 中使用 MQTT 进行无缝通信的分步指南。您将学习如何编译 Qt MQTT 模块并使用它建立连接、订阅和取消订阅主题、发布消息以及实时接收消息。

Qt6 项目准备

本文中，我们在搭载 M2 芯片的 MacBook 上使用了 Qt v6.6.2。您可以在此处下载并安装 Qt 的开源版本。

建议在安装前先注册一个 Qt 账户。

安装 Qt 后，您需要安装 g++ 和 XCode 并设置一些环境变量。Qt 官方文档提供了在 macOS 上的相关设置说明。

通过 CMake 编译 Qt MQTT 模块

Qt MQTT 模块是 Qt 的官方库，提供了符合标准的 MQTT 协议规范实现。然而，该模块并未包含在开源安装包中，需要从源代码编译。

首先，从 GitHub 下载 Qt MQTT 的源代码。确保 Qt MQTT 的版本与您机器上安装的 Qt 版本匹配。

git clone git://code.qt.io/qt/qtmqtt.git -b 6.6.2

接下来，在 QtCreator 中编译 Qt MQTT。在 Qt6 中，您可以使用 qmake 或 CMake 来构建代码。本文中我们使用 CMake。打开 Qt MQTT 的 CMakeLists.txt 文件并编译项目。

编译成功后，将创建一个名为 build-qtmqtt-Desktop_arm_darwin_generic_mach_o_64bit-Release 的新文件夹，所有静态和动态库文件将生成并存储在此文件夹中。

添加 Qt MQTT 模块

编译完成后，有两种方式可以使用该模块。一种是在项目中将 qtmqtt 导入为第三方模块，另一种是将编译后的文件直接放置在 Qt 的安装目录中。本文中，我们采用第二种方式。

1. 在目录 Qt/6.6.2/macos/include/ 下创建一个名为 QtMqtt 的新文件夹。然后将 qtmqtt/src/mqtt/ 下的所有文件复制到该文件夹。
2. 将生成的静态和动态库复制到 Qt 的安装目录。
   1. 将 build-qtmqtt-Desktop_arm_darwin_generic_mach_o_64bit-Release/lib 目录下的所有文件和文件夹复制到 Qt/6.6.2/macos/lib/ 目录中。如有需