当前位置：首页 > news >正文

Qt程序 Windows打包

news 来源：原创 2025/8/25 9:08:51

目的

运行Qt的程序，遇上如下问题：
在这里插入图片描述
显然是少很多Qt库，那就把Qt库放到这里，Qt提供这一个命令windeployqt.exe.

windeployqt

windeployqt是Qt框架提供的一个工具，主要用于自动打包Windows平台上的Qt应用程序及其依赖项，确保程序在其他电脑上能够正常运行。它通过查找并复制所需的库和资源到应用程序目录中，简化了发布过程。

定义与用途

windeployqt.exe是Qt自带的命令行工具，专门用于创建Windows应用程序的发布包。它的核心功能是自动检测并复制应用程序运行所需的动态链接库（DLL）、插件、翻译文件等资源到指定目录。这样，即使在没有安装Qt环境的电脑上，应用程序也能正常运行，避免了因缺少依赖项而导致的错误。

工作原理

windeployqt的工作原理基于环境变量PATH和Qt的配置信息。它会扫描应用程序的可执行文件，分析其依赖的Qt库和其他资源文件，然后从系统路径或Qt安装目录中查找这些文件，并将其复制到应用程序所在的目录。此外，它还会处理Qt插件、翻译文件等附加资源，确保应用程序功能完整。

情况

首先打开Qt的命令行工具，在windows菜单里面：
在这里插入图片描述

文件夹成了这个样子，多了很多文件夹与dll文件：
在这里插入图片描述

再双击restart.exe就不报错了，就可以正常运行了：
在这里插入图片描述

总结

官方说明

Windows部署工具旨在自动化创建可部署文件夹的过程，该文件夹包含从该文件夹运行应用程序所需的Qt相关依赖项（库、QML导入、插件和翻译）。
(这一句很关键，说明了windeployqt的作用)
它为Windows运行时创建一个沙箱，或为Windows桌面应用程序创建一个安装树，这些应用程序可以很容易地捆绑到安装包中。
该工具可以在QTDIR/bin/windeployqt中找到。它接受.exe文件或包含.exe文件的目录作为参数，并扫描可执行文件的依赖关系。如果目录传递了–qmldir参数，windelloyqt将使用qmlimportscanner工具扫描目录内的QML文件，以查找QML导入依赖关系。然后将识别的依赖项复制到可执行文件的目录中。Qt5Core.dll中的硬编码本地路径也被替换为相对路径。
对于Windows桌面应用程序，默认情况下，编译器所需的运行时文件也会复制到可部署文件夹中（除非指定了选项–no编译器运行时）。对于使用Microsoft Visual C++的发布版本，这些版本由Visual C++可再分发包组成，这些包旨在由目标计算机上的应用程序安装程序进行递归安装。否则，将使用编译器运行时的共享库。
该应用程序可能需要额外的第三方库（例如数据库库），而windeployqt不考虑这些库。

最后说明

windeployqt.exe就把exe程序的依赖的qt库放到exe的所在文件夹里,如图所示：
在这里插入图片描述

目的

windeployqt

定义与用途

工作原理

情况

总结

官方说明

最后说明

相关文章：