6步！教你写一个mqtt调试助手
点击上方“小麦大叔”，选择“置顶/星标公众号”
大家好，我是小麦，之前写过一篇MQTT的文章，里面用来测试的mqtt client程序是自己编译的。可以参考上一篇文章《MQTT协议，终于有人讲清楚了》。
在这篇文章里我简单总结了如何基于Qt的Mqtt库，编译一个mqtt client.
Qt开发MQTT程序有两种方式；
Qt官方已经提供了基于MQTT的封装，但是并没有正式加入到Qt的标准库中，需要自己进行编译添加； 基于第三方EMQ开发的MQTT接口；
本文主要介绍第一种方式，即使用Qt官方的MQTT封装库，我们将编译MQTT库，并编译一个官方的Demo，实际需要写的代码其实并不多。
下载地址
Qt已经在GitHub上托管了相应的MQTT库的代码，地址：https://github.com/qt/qtmqtt
这个库是基于MQTT V3.1和V3.1.1实现的，这里要注意协议版本。
如上图所示，这里有很多分支；
这里我测试6.2这个版本，它需要通过CMake对项目进行构建，但是发现这个版本的MQTT需要QT 6 以上的版本才行，具体报错信息如下图所示：
下面，简单罗列一下，整体的环境；
QT版本：Qt5.12.11
MQTT库版本：5.12.10
整体环境：Win10+QtCreator + MinGW-W64
编译QtMqtt库
D:\Qt\Qt5.12.11\5.12.11\mingw73_64\include
在Qt的安装目录下新建QtMqtt文件夹；
然后将qtmqtt-5.12.10路径下的文件复制到D:\Qt\Qt5.12.11\5.12.11\mingw73_64\include路径下；
总结一下上述的过程，具体如下图所示；
具体的实际路径要根据自己的安装情况为主。
这时候我们重新回到qtmqtt-5.12.10路径下，打开qtmqtt.pro，就可以进行编译了；
这里可以编译成Debug和Release模式，编译成功之后就可以找到 Qt5Mqtt.dll和Qt5Mqttd.dll；
复制DLL库和lib库
将lib文件夹的文件复制到
这时候，我们可以打开simple mqtt client项目进行测试了，路径如下所示；
这时候已经可以进行编译了，但是会发现有还两个报错情况：
第一个报错信息如下：
Unknown module(s) in QT: mqtt
无法识别mqtt模块；
解决方案如下：
将qt_lib_mqtt.pri文件和qt_lib_mqtt_private.pri复制到Qt的安装路径下的mkspecs\modules路径中即可，例如我的电脑上的路径是D:\Qt\Qt5.12.11\5.12.11\mingw73_64\mkspecs\modules；
mingw73_64是我具体使用的工具链，这里要根据实际使用的工具链进行选择。
第二个报错信息如下：
QMqttClient does not exist
原因是头文件无法找到，做出如下修改；
//#include <QMqttClient>
#include <QtMqtt/qmqttclient.h>
再次编译运行，程序可以正常运行。
简单总结一下：
库版本和位置是否放置在相应编译工具链目录下。 头文件是否对应到类名文件，并放置到编译工具链目录下。 modules-inst下的pri文件是否放置到编译工具链目录的相应目录下， QT +=mqtt 能否正常工作都依赖目录里的pri文件。
为了方便测试mqtt的一些自定义指令，我在原来的demo基础上简单修改了一下，最多支持9条消息编辑和单独发送，具体如下所示；
这里可以通过修改cmd.ini文件进行配置主机地址，端口，以及需要发送的Topic和Message的内容；
注意：cmd.ini必须和可执行文件处于同一路径下；
代码已经上传到Github，目前功能比较简单，不支持设置QoS，支持文本格式数据接收，不支持遗嘱消息，感兴趣的同学可以看一下，地址如下：https://github.com/hotsauce1861/mqtt-client-debug-helper.git
如果大家更好的推荐，可以在下方留言区积极讨论。
另外我编译了一个可执行程序；
星标公众号，后台回复【MQTT】，即可获取。
欢迎转发、留言、点赞、分享给你的朋友，感谢您的支持！
点击上方名片关注公众号
分享 💬 点赞 👍 在看 ❤️
以“三连”行动支持优质内容!