利用QT自带的windeployqt打包发布程序

最新推荐文章于 2025-07-17 09:36:01 发布

转载最新推荐文章于 2025-07-17 09:36:01 发布 · 4k 阅读

文章标签：

#QT #打包 #发布

QT学习专栏收录该内容

2 篇文章

订阅专栏

本文介绍如何使用windeployqt工具简化Qt程序的发布流程，包括QtWidgetsApplication和QtQuickApplication两种类型的程序。此外，还详细介绍了如何利用NSIS编辑器创建个性化的安装包。

●◎◇写在前面：本文是本人搜集整理网上的资料弄出来的。出处如下：

◆步骤一出处：感谢作者：winland0704 原文：http://tieba.baidu.com/p/3730103947，

◆步骤二出处：感谢作者：╰☆奋斗ing❤孩子` 原文：http://blog.sina.com.cn/s/blog_a6fb6cc90101fer8.html。

◆技术在于交流、沟通，转载请注明出处并保持作品的完整性。

步骤一：windeployqt的用法

Qt 官方开发环境使用的动态链接库方式，在发布生成的exe程序时，需要复制一大堆 dll，
如果自己去复制dll，很可能丢三落四，导致exe在别的电脑里无法正常运行。
因此 Qt 官方开发环境里自带了一个工具：windeployqt.exe。
以官方 Qt 5.4.0+MinGW 开发环境为例，
从开始菜单--》Qt 5.4.0--》5.4--》MinGW 4.9 (32-bit)--》Qt 5.4 for Desktop (MinGW 4.9 32 bit)，可以打开 Qt 命令行，从这里就可以执行 windeployqt 工具。

集成开发环境 QtCreator 目前生成图形界面程序 exe 大致可以分为两类：
Qt Widgets Application 和 Qt Quick Application。
下面分别介绍这两类exe 的发布方式。

1、Qt Widgets Application可执行程序发布方式
首先用 QtCreator 新建一个 Qt Widgets Application 项目，直接用默认的 QMainWindow 程序就可以了，项目名字假定是 hellomw。
然后以 Release 方式编译生成 exe 程序：

生成的程序运行正常之后，找到项目的生成目录，比如项目源码路径：
C:\QtPros\hellomw\
它的项目生成目录是
C:\QtPros\build-hellomw-Desktop_Qt_5_4_0_MinGW_32bit-Release\
进入这个文件夹，在进入它的子文件夹 release 里面，找到 hellomw.exe ，
将这个exe 复制到一个新的单独的文件夹里用于发布，比如存到
D:\hellomw\ 文件夹里面。

然后从开始菜单打开 Qt 命令行，输入命令：
cd /d D:\hellomw
然后使用 windeployqt 工具命令：
windeployqt hellomw.exe

然后可以在 D:\hellomw 文件夹里看到 windeployqt 工具自动复制的插件文件夹
和 dll文件、qm文件。这时候得到的就完整的 exe 程序发布集合，依赖关系都解决好了。

把 D:\hellomw 文件夹打包就可以发布了，不用自己一个个找 dll 文件了。
D:\hellomw 文件夹里的qm文件是多国语言翻译文件，不需要可以删了，
其他的都保留。

2、Qt Quick Application发布方式
首先用 QtCreator 新建一个 Qt Quick Application 项目，直接用默认的项目模版，点击下一步生成项目，项目名字假定是 helloqml。
然后以 Release 方式编译生成 exe 程序：

然后找到项目的构建目录，比如项目源码目录 C:\QtPros\helloqml，
它的构建目录是：
C:\QtPros\build-helloqml-Desktop_Qt_5_4_0_MinGW_32bit-Release\
进入这个目录，再进入 release 子文件夹，找到 helloqml.exe ，
复制到一个新的单独的文件夹里面，比如 D:\helloqml\ 文件夹里面。

然后从开始菜单打开 Qt 命令行，进入D:\helloqml\文件夹：
cd /d D:\helloqml
然后使用 windeployqt 工具命令：
windeployqt helloqml.exe --qmldir C:\Qt\Qt5.4.0\5.4\mingw491_32\qml

注意不要跟烧包一样照抄上条命令，--qmldir 是指出 Qt 库里面的 qml 文件夹位置，
上面命令里 C:\Qt\Qt5.4.0 是 Qt 官方开发环境安装的文件夹，
C:\Qt\Qt5.4.0\5.4\mingw491_32 是Qt类库的目录（QTDIR），
因此使用的 --qmldir 后面写的是 C:\Qt\Qt5.4.0\5.4\mingw491_32\qml
读者Qt环境安装路径不一样，要根据实际情况修改！

然后可以看到 D:\helloqml 文件夹里有一大堆文件，就是 QtQuick程序需要的依赖文件。
将整个 D:\helloqml 文件夹打包就可以发布出去，在别的电脑上使用。