Qt5.9程序打包发布的实现
(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库。
相关文章