QT5.12.10
Win11
mingw
Qt开发MQTT程序有两种方式,一个是Qt官方提供的基于MQTT的封装,一个是第三方(EMQ)开发的用于Qt调用MQTT的接口,二者使用方法大同小异,并且均提供了源码。那么,这里先来介绍第一种,如基于Qt官方提供的封装来使用MQTT。
Qt官方虽然在2017年就已经提供了对MQTT的封装,但是并没有正式加入到Qt的标准库里面,所以需要自己下载源码进行编译。
Qt官方介绍文档地址:https://doc.qt.io/QtMQTT/qtmqtt-index.html
首先要下载官方源码,注意一定要对应自己的qt版本否则容易出现库和软件不兼容情况。
Qt官方在github上提供了源代码,地址:https://github.com/qt/qtmqtt
我这里由于QT版本是5.12.10,所以找了5.12.10的官方库
重点!!!
目录下.pro文件极为重要,需要它来编译产生后面移植所需要的库。我这里找的是可以直接编译qt的pro文件版本的,默认下载的是dev开发版本,需要cmake编译才出现pro文件。不会cmake的可以在github左上角切换分支找到有pro文件的开发版本来下载
下载源码后得到如下文件,直接打开工程文件准备编译。(默认下载的是dev开发版本,需要cmake编译才出现pro文件。不会cmake的可以在github左上角切换分支找到有pro文件的开发版本来下载)
注意,编译这个源码需要安装perl,否则会报错:perl 不是内部或外部命令,也不是可运行的程序。
perl下载地址:https://www.perl.org/get.html
官网下载速度比较慢,我上传到网盘了,可以在这里下载:
链接:https://pan.baidu.com/s/1p5YOo-FU-ZLJUtuZSN0Rjg 提取码:i0dm
安装完Perl后会自动写入环境变量, 这时候再次编译(Release模式)QtMqtt源码,编译完成后得到以下文件:
接下来就可以将mqtt部署到自己的Qt项目中了。
编译出来的Qt Mqtt库,要使用它有两种方式,一种是直接在项目中导入外部库和头文件,还有一种是将其以模块的形式部署到Qt的安装目录,其中第二种的好处就是,只需要做一次操作,以后需要再用Mqtt库就可以直接调用了,不需要每次都导入外部库。这里介绍第二种。
如何将QtMqtt的库直接部署到Qt安装目录中,这样只需要部署一次,以后在任何工程中引用都不需要再额外导入库了,相比第一种来说更方便些。
首先,将qtmqtt源码目录下(qtmqtt\src\mqtt)的所有.h头文件拷贝,Qt安装目录下的include文件夹中创建一个QtMqtt目录文件夹,将拷贝的文件粘贴进去。(注:这个文件夹命名可以随便改,但是一定要记住,因为后面要用到。)
然后,将源码编译生成(Debug或者Release都行)目录下的lib中以下4个文件拷贝
并粘贴到Qt安装目录下的lib文件夹中去:
接下来将源码编译生成的两个库文件拷贝到Qt安装目录的bin和lib中:
最后再拷贝模块配置文件到Qt安装目录中
这两张图片直接照搬别人的博客,懒得弄。。。
ok,配置完毕,这种方式配置在新建工程中引用只需要引入模块就可以直接使用了
在工程的pro文件中这里需要加一个network
QT += network
添加QtMqtt库
win32:CONFIG(release, debug|release): LIBS += -L$$PWD/lib/ -lQt5Mqtt
else:win32:CONFIG(debug, debug|release): LIBS += -L$$PWD/lib/ -lQt5Mqttd
添加头文件inlcude
INCLUDEPATH += $$PWD/include
DEPENDPATH += $$PWD/include
在.c和.h里引入头文件
#include "QtMqtt/qmqttclient.h"
这里的QtMqtt就是我们上面操作的文件夹名称,如果我们改了文件夹名就换上去就行了。
在.h文件里初始化QMqttClient对象、异步连接回调、接收消息异步回调
protected:
QMqttClient *pMqttClient;//mqtt服务器对象
protected slots:
void connected_isr();//连接回调函数
private slots:
void recv_message(QByteArray message);//接收消息回调
.c文件主函数
pMqttClient=new QMqttClient(this); //实例化QMqttClient对象
pMqttClient->setHostname(IP地址); //连接mqtt服务器
pMqttClient->setPort(1883);
pMqttClient->connectToHost();
connect(pMqttClient,&QMqttClient::connected, //连接异步槽
this,&Widget::connected_isr);
connect(pMqttClient,&QMqttClient::messageReceived,
this,&Widget::recv_message);
//成功连接回调
void Widget::connected_isr()
{
qDebug()<<"Connected successfully!";
pMqttClient->subscribe(QMqttTopicFilter("test"));//订阅频道
}
//收到消息回调
void Widget::recv_message(QByteArray message)
{
qDebug()<
发布订阅消息
QString topic="test";//发布的频道
QString payload="123456";//消息内容体
pMqttClient->publish(QMqttTopicName(topic),payload.toLocal8Bit());//发布消息
pMqttClient->subscribe(QMqttTopicFilter("test"));//订阅频道