Qt5.9程序打包发布的实现

2022-11-13 08:11:51 程序 打包 发布

windows平台)Qt编译的程序如何在其他没有安装Qt的电脑上运行呢,本文将告诉你答案

编译工程

这里拿官方的一个例程作为目标工程,选择 Release 的方式编译工程,

编译完成后,程序自动运行(如下图),找到可执行文件的位置(可在项目构建目录中查找),

将可执行文件单独复制出来,放在一个空文件夹中,

此时该文件是无法运行的,如果这是一个C或c++程序,是可以直接运行的,除非你没有把Qt关键的库加到环境变量(如果要在其他没装Qt的机器上运行C/C++程序,则需要把那几个库一起打包,后面介绍)

运行windeployqt

windeployqt 是Qt自带的一个命令工具,位于Qt的编译器的bin目录下,比如我路径为:Qt5.9.0\5.9\mingw53_32\bin

这是一个命令工具,不能直接运行,需要先打开控制台(输入Win+R,接着输入cmd后回车),复制可执行文件所在路径名,在控制台输入cd /d + 可执行文件路径名(右键可粘贴),进入打包目录,

接着将 windeployqt.exe 的绝对路径复制到控制台,后面加上要打包的可执行文件,

回车运行,该工具会把可执行文件所有的依赖库(除了几个Qt核心库)都拷贝到可执行文件所在目录下,

此时打包文件夹出现了很多库文件和若干文件夹(里面也是库),

此时再次运行打包文件下的可执行文件,如果出现以下错误,极有可能是Qt核心库没有被添加到环境变量(当然,把所需要的库直接拷贝到打包文件夹下也是可行的,且这是打包的最后一步,详见下文),

添加完环境变量后,Qt程序已经可以成功运行:

添加必要的库

上面的可执行文件之所以可以直接运行,归功于 windeployqt.ext 生成的依赖库和全局变量中的部分库,但是打包文件夹中只有 wineployqt.exe 生成的库,所以要想让可执行文件能在其他没有安装Qt的电脑运行,我们还需要拷贝几个基本的库。

这些库在 Qt5.9.0\Tools\mingw530_32\bin 目录下(这里只是我电脑上的目录,仅供参考),一般情况下只需要拷贝下面3个库(保险起见,也可以把该目录下所有.dll文件都拷贝走)。

此时,即使去掉环境变量里的Qt相关库,打包好的文件依然可以运行(在其他电脑亦可运行,前提是系统相同)。

遇到的一个问题

之前我按照上面的方法打包一个在Qt上编译的可执行文件,但是出现 xxx.exe does not seem to be a Qt executable. 的报错,说这不是一个Qt可执行文件,我到网上找了很久都没找到解决办法,最后发现 windeployqt.exe 不能用在 C/C++ 的可执行文件上,或者说 C/C++ 可执行文件只需要上面3个基本库就能在其他机器上运行,根本用不到其他的Qt库。

相关文章