QT学习笔记(三):Qt软件打包发布(QT5.8 _msvc2013_64+Win10_64)
- 1.编译方式介绍:
- 2.动态编译方式打包发布QT程序:
- 方法一:手动复制
- 方法二:使用工具
- 问题&解决:
环境:QT5.8 _msvc2013_64+Win10_64 (MSVC 编译器)
1.编译方式介绍:
Qt开发的程序发布的时候经常采用两种方式:1)静态编译,可生成单一的可执行文件;2)动态编译,需同时附上需要的dll文件。
静态编译
静态编译,是指把相关的库也一并引入exe文件,这样程序的尺寸就会很大,不过程序发布就会变得简单很多。
优点: 发布简单,单一文件,在移植时如果空间足够,采用静态编译比较可靠
缺点: 库文件很大,更新程序版本不方便。每次升级,都要重新分发所有的内容。对QT而言,需要重新编译静态库(非常耗时),且插件的使用比较麻烦;
动态编译(Qt默认)
动态编译,是指相关的库,以dll动态链接库的形式引用。动态编译的exe程序比较小,因为相关的库都没有包含进来。所以程序发布的时候要把相关的库也一并发布出去。
一般使用动态编译动态链接Qt库,尤其代码规模比较大,需要多人协作开发时,不同模块按dll划分比较方便,采用静态链接是不现实的。
优点: 更新方便,发布多个产品时,可以统一使用一个库。
缺点: 文件多、杂。
Debug版本
Debug 通常称为调试版本,它包含调试信息,并且不作任何优化,便于程序员调试程序。
Release 版本
Release 称为发布版本,它往往是进行了各种优化,使得程序在代码大小和运行速度上都是最优的。一般来说,release版的可执行程序体积要比debug版小很多,而且由于剥离了许多调试信息及符号等,运行效率相对也高一些,因此一般采用release编译。
2.动态编译方式打包发布QT程序:
方法一:手动复制
采用Qt动态编译,release版本的程序。需要将相应的dll跟Qt可执行程序exe文件放在一个目录下:
所需的dll文件包括:
1)Qt模块库
Qt5Cored.dll
Qt5Guid.dll
Qt5Widgetsd.dll
2)ICU依赖库
icudt51.dll
icuin51.dll
icuuc51.dll
3)EGL依赖库
libEGLd.dll
libGLESv2d.dll
4)插件库(Qt安装目录下即可找到D:\Software\Qt\Qt5.1.0\5.1.0\msvc2010\plugins\platforms)
图片支持库:imageformats
音频、视频支持库:mediaservice
平台支持库:platforms
等等…
注意:查找对应的插件文件夹,粘贴到安装目录(一定要保持目录结构,例如“platforms/***.dll”),详细结构见打包发布准备的文件组织结构。
5)VS运行时库msvcrt,如:
msvcp120.dll
msvcr120.dll
( 注意:发布程序的时候注意版本(Debug/Release)
如果是Debug版本的则是.前面带d的(Qt5Cored.dll、Qt5Guid.dll、Qt5Widgetsd.dll)
如果是Release版本的则是.前面不带d的(Qt5Core.dll、Qt5Gui.dll、Qt5Widgets.dll))
6)程序中引用的第三方库,如QWT,openCV,第三方库的dll文件如qwt.dll、opencv_world300.dll。
**PS:
①.将exe文件在另一台电脑上运行时,若缺少运行所必需的dll文件,会报错——缺少dll文件。
②.C Runtime库:
问题比较多的是VC的运行时库 msvcrt。使用VC编译的C或C++程序,都需要相关的C runtime库才能运行。本文采用的是VS2013编译器,对应的就是MSVCR120。进入Microsoft.VC120.CRT 目录:
${VS Install Dir}\VC\redist\x64\Microsoft.VC120.CRT
就能找到C runtime库(msvcp120.dll,msvcr120.dll,vccorlib120.dll)。
从vc2005开始微软加入了manifest机制控制运行时库的加载,如果用户机器上未安装过msvcrt的distribution pack,程序就不能运行。简单的处理方法是把C runtime库一并包含进去,即将Microsoft.VC120.CRT 目录下的文件(msvcp120.dll,msvcr120.dll,vccorlib120.dll)放到exe相同的目录即可。应用程序如果找不到系统安装的msvcrt,就会加载自带的库文件。
③.Qt库
编译Qt后,将Qt生成路径(…\build-untitled-Desktop_Qt_5_4_1_MSVC2013_OpenGL_64bit-Release\release)中的exe程序放到新建的package中,Qt程序中使用到的(在.pro文件中添加的)QtCore,QtGUI,xml,sql,multimedia等相关的动态库和调用它的exe一起放在同一个目录中。
④.Qt的图片解码库比如:jpeg、gif解码等是以插件形式存在的,要包含imageformats文件夹中的dll文件,还有windows平台相关的platforms,windows中的语音相关的audio等文件夹中包含的dll文件。
对于采用动态编译的Qt可执行程序,如果不确定该程序使用了哪些必要的dll,可以使用工具查看该Qt可执行程序使用了哪些dll,见下:
方法二:使用工具
1、 通过工具,查找程序运行依赖的dll文件
最简单的方式是用Qt自带的生成必备dll文件的 windepolyqt.exe工具 (D:\Qt\Qt5.8.0\5.8\msvc2013_64\bin 目录下):windepolyqt xxx.exe
Qt for Windows - Deployment 官方文档:
https://doc.qt.io/qt-5/windows-deployment.html#application-dependencies
使用方法:将Qt的bin目录加入PATH环境,就可以直接在命令行使用windeployqt调用。将生成的xxx.exe可执行文件复制到一个空的文件夹里,进入这个文件夹 ,运行windeployqt xxx.exe,则该执行文件需要的大部分依赖文件都自动拷贝到这个文件夹里了。
2、第三方的SDK库添加
如果还使用了其他的第三方的SDK,如QWT,OpenCV等,就需要手动将所需dll拷贝过来,如果不知道还需要哪些dll文件,可以用**Dependency Walker (depends.exe)**和 微软的进程查看器 Process Explorer(procexp.exe) 来查看程序运行时还缺少哪些dll。
3、 QT程序打包发布,用户打包程序,变成(桌面)安装包,可使用工具,如 NSIS,开源工具Inno Setup进行打包。
参考博客:
NSIS 官网下载
https://nsis.sourceforge.io/Download
Qt之NSIS打包 :(NIS Edit+NSIS 方式)
https://blog.csdn.net/xuhui_liu/article/details/71721556
Inno setup 打包教程:
https://jingyan.baidu.com/article/295430f1232df70c7e0050fe.html
https://blog.csdn.net/ruifangcui7758/article/details/6662646
https://blog.csdn.net/hebbely/article/details/78168071
Qt 软件发布与打包:
https://blog.51cto.com/2678482/1616826
其他打包方式:
https://blog.csdn.net/qq_34719188/article/details/79947764
这样之后,就得到了一个在其它没有安装Qt和VS的电脑上也可以运行的Qt程序安装包了。
问题&解决:
完成上述第1步是及:从命令行模式进入该文件夹执行语句 windeployqt xxxx.exe 时提示错误,无法找到“Visual Studio安装目录,未设置VCINSTALLDIR ”,如图:
C:\Users\Leon\Desktop\新建文件夹> windeployqt HelloWorld.exe
C:\Users\Leon\Desktop\Warning: Cannot find Visual Studio installation directory, VCINSTALLDIR is not set.
解决方法:
直接用 “VS2013 开发人员命令提示” 命令行去,执行刚才的 windeployqt HelloWorld.exe,会将 “vcredist_x64.exe”(vc x64 运行最少环境)程序放入当前目录。
1)先cd 进执行程序(HelloWorld.exe)所在目录,再次运行 windeployqt HelloWorld.exe:
D:\Microsoft Visual Studio 12.0>C:
C:\>cd C:\Users\Leon\Desktop\新建文件夹
windeployqt HelloWorld.exe
结果:
2)可能还是会漏掉一些包,要多在其他电脑上进行测试,运行时会提示缺少某个dll,想办法找到该dll,这个dll你自己的电脑上一般都会有,全局搜下,复制粘贴到exe所在目录下