概述
Qt 開發 MQTT 程序有兩種方式，一個是 Qt 官方提供的基於 MQTT 的封裝，一個是第三方（EMQ）開發的用於 Qt 調用 MQTT 的接口，二者使用方法大同小異，並且均提供了源碼。那么，這里先來介紹第一種，如基於 Qt 官方提供的封裝來使用 MQTT。
Qt 官方雖然在 2017 年就已經提供了對 MQTT 的封裝，但是並沒有正式加入到 Qt 的標准庫里面，所以需要自己下載源碼進行編譯。
Qt 官方介紹文檔地址：https://doc.qt.io/QtMQTT/qtmqtt-index.html
下載
Qt 官方在 github 上提供了源代碼，地址：https://github.com/qt/qtmqtt
這是最新的，基於 MQTT 5.0 協議的版本。先把源碼下載下來。
編譯
下載源碼后得到如下文件，直接打開工程文件准備編譯。
我這里的編譯環境是：Qt5.12.9 + MinGW-64
注意，編譯這個源碼需要安裝perl，否則會報錯：perl 不是內部或外部命令，也不是可運行的程序。
perl 下載地址：https://www.perl.org/get.html
官網下載速度比較慢，我上傳到網盤了，可以在這里下載：
鏈接：https://pan.baidu.com/s/1p5YOo-FU-ZLJUtuZSN0Rjg 提取碼：i0dm
下載好后直接安裝即可，安裝完 Perl 后會自動寫入環境變量， 這時候再次編譯（Release模式）QtMqtt 源碼，編譯完成后得到以下文件：
bin 目錄下就是我們要的庫文件：
但實際編譯過程中遇到很多問題，具體解決方法參考：編譯安裝 QtMqtt 的幾個問題及解決辦法
部署到Qt項目
編譯出來的 Qt Mqtt 庫，要使用它有兩種方式，一種是直接在項目中導入外部庫和頭文件，還有一種是將其以模塊的形式部署到 Qt 的安裝目錄，其中第二種的好處就是，只需要做一次操作，以后需要再用 Mqtt 庫就可以直接調用了，不需要每次都導入外部庫。這里兩種方法都介紹一下，首先來看第一種。
導入外部庫
新建一個 Qt 工程，然后拷貝剛剛編譯的源碼生成目錄下的 lib 文件夾中 libQt5Mqtt.a、libQt5Mqttd.a、Qt5Mqtt.dll、Qt5Mqttd.dll 這四個文件，在新建工程目錄下創建 lib 文件夾，將拷貝的文件粘貼進去。
然后在 qtmqtt 源碼目錄下（qtmqtt\src\mqtt）的所有 .h 頭文件拷貝，在新建工程目錄下創建 include 文件夾，將拷貝的文件粘貼進去：
打開新建工程的 pro 文件，添加：
再添加庫文件引用：
win32:CONFIG(release, debug|release): LIBS += -L$$PWD/lib/ -lQt5Mqtt
else:win32:CONFIG(debug, debug|release): LIBS += -L$$PWD/lib/ -lQt5Mqttd
添加 include 文件的引用：
INCLUDEPATH += $$PWD/include
DEPENDPATH += $$PWD/include
為了統一演示，先介紹完第二種方法后再來看 demo。
部署到Qt安裝目錄
再來看第二種方法，如何將 QtMqtt 的庫直接部署到 Qt 安裝目錄中，這樣只需要部署一次，以后在任何工程中引用都不需要再額外導入庫了，相比第一種來說更方便些。
首先，將 qtmqtt 源碼目錄下（qtmqtt\src\mqtt）的所有 .h 頭文件拷貝，然后在 Qt 安裝目錄下的 include 文件夾中創建一個 QtMqtt 目錄，將拷貝的文件粘貼進去：
然后將生成的動態庫和靜態庫復制到 Qt 安裝目錄下對應存放庫的路徑下：
到目前為止，我們只是將 mqtt 的靜態和動態庫復制到了 qt 安裝目錄下，但是並沒有作為一個模塊導入到 qt 中，要想在 pro 文件里寫 Qt+=mqtt 而不用我們每次都寫庫路徑，還需要將 MQTT 加入 QT 模塊中。
配置完畢，這種方式配置在新建工程中引用只需要引入模塊就可以直接使用了：
QT += mqtt
包含頭文件：
#include "QtMqtt/qmqttclient.h"
所以推薦使用第二種方式進行配置。接下來看看 Demo。
Demo演示
為了方便演示，我們直接使用 Qt Mqtt 源碼中自帶的示例來編譯運行。
這個示例 Qt 官方有詳細介紹的，https://doc.qt.io/QtMQTT/qtmqtt-simpleclient-example.html
將該示例打開，有個地方需要改一下，打開 Pro 文件：
將以上兩行注釋掉，要不然會有依賴，無法獨立運行。
我們直接編譯運行該示例，效果圖如下：
在官方文檔中介紹，可以直接連接以下兩個服務器地址：
經測試，第一個地址連接不上，所以我們直接輸入第二個地址進行測試：broker.hivemq.com
輸入地址，點擊連接后就可以連接服務器，並且 State 變成了 2 就表示已經連上了。
然后點擊訂閱按鈕，表示要訂閱這個主題，在點擊發布，就可以收到信息了：
可以在多台電腦上進行測試，只要訂閱了同一個主題，那么一端發送消息，其他端就可以接收到相應的信息。
Qt官方提供了非常詳細的文檔介紹，大家可以去參考接口的使用，最主要使用的類是QMqttClient。
至此，Qt官方提供的MQTT封裝模塊使用介紹已經全部完了，如果想了解第三方（EMQ）開發的用於 Qt 調用 MQTT 的接口，請參考：Qt開發MQTT（二） 之第三方QMQTT。
Demo下載
這是遇到了些編譯錯誤，解決修改好后的 MQTT 源碼下載地址（Qt 5.12.9 MinGW）：
https://github.com/confidentFeng/QtAppProject/tree/master/qtmqtt-dev
導入外部庫方式的 Demo 下載地址：https://github.com/confidentFeng/QtAppProject/tree/master/QMqttClientTool
參考：