基于Qt使用MQTT详细教程

最新推荐文章于 2024-09-11 16:50:17 发布

南风叔叔

最新推荐文章于 2024-09-11 16:50:17 发布

阅读量2.2k

点赞数 19

文章标签： qt 开发语言

本文链接：https://blog.csdn.net/qq_46291735/article/details/140162709

版权

步骤一：准备工作

安装 Eclipse Paho MQTT C++ 客户端库

首先，你需要下载并安装 Eclipse Paho MQTT C++ 客户端库。你可以从官方的 GitHub 仓库获取源码并编译安装，或者使用已经编译好的预编译库。

GitHub 仓库地址：Eclipse Paho C++

安装 Eclipse Paho MQTT C++ 客户端库在不同操作系统上略有不同。我将分别介绍在 Linux、Windows 和 macOS 上安装的基本步骤。

在 Linux 上安装 Eclipse Paho MQTT C++ 客户端库

在大多数 Linux 发行版上，你可以通过包管理器直接安装 Eclipse Paho MQTT C++ 客户端库。以下是在 Ubuntu 上的安装示例：

sudo apt-get update
sudo apt-get install libmqttcpp1 libmqttcpp-dev

这将安装预编译的 Eclipse Paho MQTT C++ 客户端库及其开发文件。如果你需要手动编译和安装，可以通过以下步骤：

获取源码：克隆或下载 Eclipse Paho MQTT C++ 客户端库的源代码：

git clone https://github.com/eclipse/paho.mqtt.cpp.git

编译和安装

进入源码目录，创建一个 build 目录并编译安装：

cd paho.mqtt.cpp
mkdir build
cd build
cmake ..
make
sudo make install

这将安装库文件到系统默认的位置。

在 Windows 上安装 Eclipse Paho MQTT C++ 客户端库

在 Windows 上安装 Eclipse Paho MQTT C++ 客户端库通常需要手动编译。

安装依赖

安装 CMake：从 CMake 官网下载并安装 CMake。
安装 MinGW 或 Visual Studio：建议使用 MinGW 或 Visual Studio 作为编译工具链。

获取源码：下载 Eclipse Paho MQTT C++ 客户端库的源代码，解压到本地。
编译：打开命令提示符 (cmd)，进入源码目录，创建一个 build 目录，然后使用 CMake 和 MinGW 或 Visual Studio 编译：
```
cd paho.mqtt.cpp
mkdir build
cd build
cmake -G "MinGW Makefiles" ..
mingw32-make
```
在 macOS 上安装 Eclipse Paho MQTT C++ 客户端库

在 macOS 上，你可以通过 Homebrew 或者手动编译安装 Eclipse Paho MQTT C++ 客户端库。
通过 Homebrew 安装：如果你已安装 Homebrew，可以通过以下命令安装：
```
brew install paho.mqtt.cpp
```
手动编译：如果你想手动编译，可以按照 Linux 上的步骤来进行：

git clone https://github.com/eclipse/paho.mqtt.cpp.git
cd paho.mqtt.cpp
mkdir build
cd build
cmake ..
make
sudo make install

创建一个新的 Qt 项目
打开 Qt Creator，创建一个新的 Qt 控制台项目或者 Qt GUI 项目，具体项目类型可以根据你的需求选择。
步骤二：配置项目
配置 Eclipse Paho MQTT C++ 客户端库

在 Qt 项目中，需要告诉编译器如何找到和使用 Eclipse Paho MQTT C++ 客户端库。这通常涉及设置包含路径和链接选项。

在 Qt Creator 中打开你的项目文件 .pro。
添加以下行来包含头文件路径和链接库：
INCLUDEPATH += /path/to/paho.mqtt.cpp/src
LIBS += -L/path/to/paho.mqtt.cpp/build/output -lpaho-mqttpp3 -lpaho-mqtt3c

将 /path/to/ 替换为你实际的 Eclipse Paho MQTT C++ 客户端库路径。

包含必要的头文件

在你的 Qt 项目中的头文件中包含 MQTT 相关的头文件：

#include <mqtt/client.h>

步骤三：编写 MQTT 客户端代码

现在我们来编写一个简单的 MQTT 客户端，实现连接到 MQTT 代理、发布消息和订阅主题的功能。

连接到 MQTT 代理：

#include <QCoreApplication>
#include <mqtt/client.h>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    mqtt::client client("tcp://localhost:1883", "client_id");

    mqtt::connect_options options;
    options.set_keep_alive_interval(20);
    options.set_clean_session(true);

    try {
        client.connect(options);

        qDebug() << "已连接到 MQTT 代理";

        // 订阅主题
        client.subscribe("topic/test", 0);

        // 发布消息
        mqtt::message_ptr pubmsg = mqtt::make_message("topic/test", "你好，来自 MQTT 的消息");
        client.publish(pubmsg);

        client.disconnect();
    } catch (const mqtt::exception& exc) {
        qDebug() << "错误: " << exc.what();
        return 1;
    }

    return a.exec();
}