妃飞非菲 發表於 2026-1-5 09:27:04

QT安装MQTT库的实现步骤

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li>前言</li><li>一. 下载QT官方的MQTT源码</li><li>二. Windows下QT5安装MQTT库</li><ul class="second_class_ul"><li>2.1 方法1（使用Qt qcreator编译，然后自行移植）</li><li>2.2 方法2（使用命令行编译安装）</li></ul><li>三. Linux下QT5安装MQTT库</li><ul class="second_class_ul"><li>3.1 方法1（使用Qt qcreator编译，然后自行移植）</li><li>3.2 方法2（使用命令行编译安装）</li></ul><li>四. ARM板卡（RK3576）下QT5安装MQTT库</li><ul class="second_class_ul"><li>4.1 安装QT5的基本库</li><ul class="third_class_ul"><li>1.QT的安装</li><li>2.QT的安装路径</li></ul><li>4.2 安装QT5的MQTT库</li><ul class="third_class_ul"></ul></ul><li>五. Linux下QT6安装MQTT库</li><ul class="second_class_ul"></ul></ul></div><p class="maodian"></p><h2>前言</h2>
<ul><li>本文分别介绍了在Windows、Linux（Ubuntu系统）、ARM板卡（瑞芯微RK3576）下给QT安装MQTT库的步骤。</li><li>操作（二、三、四）只适用于QT5安装MQTT库；操作五用于QT6安装MQTT库。</li><li>qmake、cmake、make（<span>注意Windows下make为mingw32-make</span>）使用时候所依赖的文件：</li></ul>
<table><thead><tr><th>指令</th><th>所需文件</th><th>说明</th></tr></thead><tbody><tr><td>qmake</td><td>.pro文件</td><td>查看源码下是否有.pro文件，有.pro文件才能使用qmake（使用方法参看：操作二、三、四）</td></tr><tr><td>cmake</td><td>CMakeLists.txt文件</td><td>查看源码下是否有CMakeLists.txt文件，有CMakeLists.txt文件才能使用cmake（使用方法查看：操作六）</td></tr><tr><td>make</td><td>Makefile文件</td><td>一般执行完qmake或cmake后会生成Makefile文件，此时执行make即可</td></tr></tbody></table>
<p>QT5的MQTT库使用的是qmake，QT6的MQTT库已经都在使用cmake。</p>
<p class="maodian"></p><h2>一. 下载QT官方的MQTT源码</h2>
<p>代码地址：https://gitcode.com/gh_mirrors/qt/qtmqtt/tree/dev</p>
<p>根据电脑上的QT版本下载MQTT的版本</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240326.png" /></p>
<p class="maodian"></p><h2>二. Windows下QT5安装MQTT库</h2>
<p class="maodian"></p><h3>2.1 方法1（使用Qt qcreator编译，然后自行移植）</h3>
<p>1.解压源码，然把MQTT源码\src\mqtt文件夹下的.h文件打包到一个QtMqtt的文件下、并把文件夹移动到QT安装目录的\mingw73_64\include文件夹里。</p>
<p style="text-align:center"><img alt="" height="465" src="https://img.jbzj.com/file_images/article/202601/2026010509240371.jpg" width="1200" /></p>
<p>2.使用Qt qcreator打开 MQTT源码下<code>qtmqtt.pro</code>工程文件，并进行编译</p>
<p>3.源码编译完成后，将生成的动态库和静态库复制到QT安装目录下对应存放库的路径下</p>
<p>编译完成会生成一个build-qtmqtt-Desktop_Qt_5_14_2_MinGW_64_bit-Debug的文件夹，主要复制该文件夹下bin、include、lib、mkspecs文件夹的文件</p>
<ul><li>bin ：主要存放动态库</li><li>include ：主要存放头文件</li><li>lib ：主要存放静态库</li><li>mkspecs ：构建规范文件（有这个文件可以直接在QT的.pro文件中添加mqtt模块 如：QT += core gui network mqtt）</li></ul>
<p>把bin文件夹下的文件复制到QT安装目录下的mingw73_64\bin文件夹</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240370.png" /></p>
<ul><li><p>把include 文件夹下的QtMqtt文件夹复制到QT安装目录下的mingw73_64\include 文件夹，之前复制的.h文件不要删</p></li></ul>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240319.png" /></p>
<ul><li><p>把lib 文件夹下的文件复制到QT安装目录下的mingw73_64\lib 文件夹</p>
<p>lib\cmake文件夹下的QtMqtt文件夹复制到QT安装目录下的mingw73_64\lib\cmake文件夹</p>
<p>lib\pkgconfig文件夹下的文件复制到QT安装目录下的mingw73_64\lib\pkgconfig文件夹</p>
<p>lib文件夹下的libQt5Mqtt.、Qt5Mqtt.prl文件复制到QT安装目录下的mingw73_64\lib文件夹</p></li></ul>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240328.png" /></p>
<ul><li><p>把mkspecs\modules-inst文件夹下的文件复制到QT安装目录下的mingw73_64\mkspecs\modules文件夹</p></li></ul>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240375.png" /></p>
<p>4.打开并运行MQTT自带的例子（以simpleclient工程为例；工程路径：MQTT源码下examples\mqtt\simpleclient文件夹）</p>
<ul><li><p>在编译工程时候会报错，此时修改一下头文件即可</p></li></ul>
<div class="jb51code"><pre class="brush:cpp;">#include &lt;QMqttClient&gt;
#include &lt;QtMqtt/QMqttClient&gt;
//将上面两个头文件修改为下面的头文件
#include &lt;QtMqtt/qmqttclient.h&gt;</pre></div>
<ul><li><p>编译成功后，使用MQTT服务端工具进行调试（MQTT在线工具：http://course.xnkiot.com/tools）</p></li></ul>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240390.png" /></p>
<p style="text-align:center"><img alt="" height="516" src="https://img.jbzj.com/file_images/article/202601/2026010509240335.jpg" width="1200" /></p>
<p class="maodian"></p><h3>2.2 方法2（使用命令行编译安装）</h3>
<p>1.先按照<span><span>2.1 的步骤1</span></span>把.h文件移动到QT安装目录的\5.14.2\mingw73_64\include文件夹里</p>
<p>2.打开MinGW的控制台</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240312.png" /></p>
<p>3.进入到MQTT源码的目录下,然后依次执行qmake、mingw32-make、mingw32-make install 指令</p>
<p>qmake、mingw32-make、mingw32-make install 指令的功能</p>
<ul><li>qmake :构建生成Makefile文件</li><li>mingw32-make ：根据Makefile文件编译源代码，生成静态、动态库等目标文件</li><li>mingw32-make install ：将编译好的静态、动态库等目标文件复制到系统的标准安装目录中，使其可以被系统使用</li></ul>
<p style="text-align:center"><img alt="" height="690" src="https://img.jbzj.com/file_images/article/202601/2026010509240386.jpg" width="1107" /></p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240484.png" /></p>
<p>4.完成上面操作后，MQTT库此时已经被安装在QT的安装目录下（即完成了<span>2.1 的步骤3</span>的复制工作），然后按照 <span>2.1 的步骤4</span>进行MQTT自带例子的测试</p>
<p class="maodian"></p><h2>三. Linux下QT5安装MQTT库</h2>
<p class="maodian"></p><h3>3.1 方法1（使用Qt qcreator编译，然后自行移植）</h3>
<p>1.解压源码，然把MQTT源码\src\mqtt文件夹下的.h文件打包到一个QtMqtt的文件下、并把文件夹移动到QT安装目录的\gcc_64\include文件夹.</p>
<p style="text-align:center"><img alt="" height="398" src="https://img.jbzj.com/file_images/article/202601/2026010509240438.jpg" width="1200" /></p>
<p>2.使用Qt qcreator打开 MQTT源码下qtmqtt.pro工程文件，并进行编译</p>
<p>3.源码编译完成后，将生成的动态库和静态库复制到QT安装目录下对应存放库的路径下</p>
<blockquote><p>编译完成会生成一个build-qtmqtt-Desktop_Qt_5_14_2_GCC_64bit-Debug的文件夹，主要复制该文件夹下bin、include、lib、mkspecs文件夹的文件</p></blockquote>
<ul><li>Linux系统下编译后，bin是空的，所以不用复制</li><li>把include 文件夹下的QtMqtt文件夹复制到QT安装目录下的\gcc_64\include 文件夹，之前复制的.h文件不要删</li><li>把lib 文件夹下的文件复制到QT安装目录下的\gcc_64\lib 文件夹</li></ul>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240416.png" /></p>
<ul><li><p>把mkspecs\modules-inst文件夹下的文件复制到QT安装目录下的\gcc_64\mkspecs\modules文件夹</p></li></ul>
<p>4.按照 2.1 的步骤4进行MQTT自带例子的测试</p>
<p class="maodian"></p><h3>3.2 方法2（使用命令行编译安装）</h3>
<p>1.先按照3.1 的步骤1把.h文件移动到QT安装目录的\gcc_64\include文件夹里</p>
<p>2.进入到MQTT源码的目录下,然后依次执行<code>qmake</code>、<code>make</code>、<code>make install</code> 指令</p>
<p style="text-align:center"><img alt="" height="516" src="https://img.jbzj.com/file_images/article/202601/2026010509240469.jpg" width="1200" /></p>
<p>3.完成上面操作后，MQTT库此时已经被安装在QT的安装目录下（即完成了3.1 的步骤3的复制工作），然后按照 2.1 的步骤4进行MQTT自带例子的测试</p>
<p class="maodian"></p><h2>四. ARM板卡（RK3576）下QT5安装MQTT库</h2>
<p class="maodian"></p><h3>4.1 安装QT5的基本库</h3>
<p class="maodian"></p><h4>1.QT的安装</h4>
<ul><li>qtbase5-dev ：包含qt最基础的类库</li><li>qtbase5-dev-tools ：开发qt时所用到的工具</li><li>qt5-qmake ：安装qmake</li></ul>
<p>一般在安装qtbase5-dev库时候会自动安装qtbase5-dev-tools 、qt5-qmake，为防止意外也再安装一下这两个库。</p>
<div class="jb51code"><pre class="brush:bash;">apt-get install qtbase5-dev qtbase5-dev-tools qt5-qmake</pre></div>
<p class="maodian"></p><h4>2.QT的安装路径</h4>
<p>QT安装成功后，在开发板上QT的安装路径会不一样，下面是QT主要的文件安装路径：</p>
<ul><li>bin路径：<code>/usr/lib/aarch64-linux-gnu/qt5/bin</code></li><li>lib路径：<code>/usr/lib/aarch64-linux-gnu</code></li><li>include路径：<code>/usr/include/aarch64-linux-gnu/qt5</code></li></ul>
<p class="maodian"></p><h3>4.2 安装QT5的MQTT库</h3>
<blockquote><p>建议安装5.14版本以上的MQTT库，我安装的是5.14.2（低版本的可能会有某些函数不能使用）。</p>
<p>这里使用的是直接编译安装的方法，不用使用移植的方法，移植的方法在这里比较麻烦。</p></blockquote>
<p>1.先按照3.1 的步骤1把.h文件移动到QT安装目录的<code>/usr/include/aarch64-linux-gnu/qt5</code>文件夹里</p>
<p>2.进入到MQTT源码的目录下,然后依次执行下面指令（执行过程中会有警告，忽略即可）。</p>
<div class="jb51code"><pre class="brush:cpp;"># 生成编译环境
qmake
# 编译
make
# 安装
sudo make install</pre></div>
<p>3.MQTT库安装成功后，会在<code>/usr/lib/aarch64-linux-gnu</code>下生成库文件。</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509240493.png" /></p>
<p>4.完成上面操作后，MQTT库此时已经被安装在QT的安装目录下，然后按照 2.1 的步骤4进行MQTT自带例子的测试</p>
<p class="maodian"></p><h2>五. Linux下QT6安装MQTT库</h2>
<p>1.在linux下完成QT6的安装（本操作使用的是：QT6.8.3）。</p>
<ul><li><p>安装QT6的时候记得安装QT6自带的cmake，Linux系统自带的cmake可能版本太低，导致编译不成功。</p></li></ul>
<p style="text-align:center"><img alt="" height="548" src="https://img.jbzj.com/file_images/article/202601/2026010509240434.jpg" width="798" /></p>
<p>2.请按照操作一，下载QT6相应版本的MQTT源码。</p>
<p>3.把源码拷贝到Linux下，进行下面的操作</p>
<div class="jb51code"><pre class="brush:bash;"># 1.进入mqtt源码目录
cd qtmqtt-6.8.3/
​
# 2.创建build目录
mkdir build
​
# 3.进入build目录
cd build
​
# 4.设置环境变量，告诉 CMake 在哪里查找 Qt6（下面的路径根据实际情况修改）
export CMAKE_PREFIX_PATH=/home/topeet/Qt/6.8.3/gcc_64/
​
# 5.使用cmake生成编译环境（使用QT6自带的cmake，Linux系统自带的cmake可能版本太低，可能导致编译不成功）
/home/topeet/Qt/Tools/CMake/bin/cmake ..
​
# 6.使用make进行编译
make
​
# 7.使用 make install进行自动安装（安装完成后到QT6安装目录下查找MQTT库，若没找到MQTT库，请执行下面的复制步骤）
make install</pre></div>
<p>4.若make install 安装不能用，请然后按照<span>3.1的步骤3</span>进行复制即可，需要复制的文件都在<span>build目录下</span>。</p>
<p>5.完成上面操作后，MQTT库此时已经被安装在QT的安装目录下，按照 <span>2.1 的步骤4</span>进行MQTT自带例子的测试</p>
<p>到此这篇关于QT安装MQTT库的实现步骤的文章就介绍到这了,更多相关QT安装MQTT 内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！</p>
                           
                            <div class="art_xg">
                              <b>您可能感兴趣的文章:</b><ul><li>Springboot整合mqtt实现软硬件通信的示例代码</li><li>C#中MQTT的使用小结</li><li>springboot整合mqtt的步骤示例详解</li><li>Java对接MQTT协议的完整实现示例代码</li><li>Java&nbsp;MQTT实战应用</li><li>MQTT&nbsp;SpringBoot整合实战教程</li></ul>
                            </div>

                        </div>
                        <!--endmain-->
頁: [1]
查看完整版本: QT安装MQTT库的实现步骤