在windows下发布QT程序遇到问题及解决

布满荆棘的人生 2022-08-25 14:52 300阅读 0赞

首先解释一个关于程序的误区：之前我以为一个程序的资源文件啊什么的诸如之类的东西，需要和编译生成的exe文件放在一起（本人确实是个笨拙之人），其实并不是这样的，我们编译的程序，输出其实只有一个东西那就是exe,但是之前编写代码是所需要用到的图片放在固定文件夹里这些等等东西那里去了呢？原来编译器是把这些东西编译成二进制和代码等生成了一个exe，也就是一个进程（一个exe程序其实就是个大的进程，你可以在windows的任务管理器里进行查看）。而之前需要在代码中写明路径等等仅仅是为了编译器在编译程序时需要找到这个文件而已，即在程序搭建框架之初，你大大可以将资源文件夹等放在电脑的任何一个地方，也不影响。但是为了易于管理等原因，我们一般都放在和代码的主目录下。

好了，说了这么多，其实一个运行程序所需要的主要种类就只有一个，那就是二进制文件，被编译的本身就是二进制文件，它在什么样的的环境（.net/qt库/mfc这些框架环境）下进行编译的，额外需要一些这些库文件，同样是二进制文件，如在windows下，这些文件就是库文件中的DLL动态链接库。所以发布程序的过程就是将自己的exe文件（其他的输出文件一律不要）和外在需要环境的文件放在一起就可以放在任何其他windows机子上运行。

# 1、静态编译和动态编译 #

> 好像我说错了什么，确实是我错了，将才所说的这种其实是只是程序发布的一种方式，这种方式是由程序搭建框架时确定的，这种方式叫动态编译发布，还有一种叫静态编译发布。这两种方式是什么意思呢？
> 
> ## 什么叫库 ##
> 
> 要搞清楚两个东西需要明白什么叫**库**？了解了这个之后相信对程序的理解会更进一步。
> 
>         所谓库，就是程序库。一般是软件作者为了发布方便、替换方便或二次开发目的，而发布的一组可以单独与应用程序进行compile time或runtime链接的二进制可重定位目标码文件。通俗一点说，所谓一个库，就是一个文件，这个文件可以在编译时由编译器直接链接到可执行程序中，也可以在运行时由操作系统的runtime enviroment根据需要动态加载到内存中。一组库，就形成了一个发布包，当然，具体发布多少个库，完全由库提供商自己决定。
> 
> ## 什么是lib，什么是dll，什么是.a，什么是.so，什么是静态库，什么是动态库 ##
> 
>         所谓静态库，就是在静态编译时由编译器到指定目录寻找并且进行链接，一旦链接完成，最终的可执行程序中就包含了该库文件中的所有有用信息，包括代码段、数据段等。所谓动态库，就是在应用程序运行时，由操作系统根据应用程序的请求，动态到指定目录下寻找并装载入内存中，同时需要进行地址重定向。 win32平台下，静态库通常后缀为.lib，动态库为.dll linux平台下，静态库通常后缀为.a，动态库为.so 从本质上来说，由同一段程序编译出来的静态库和动态库，在功能上是没有区别的。不同之处仅仅在于其名字上，也就是“静态”和“动态”。由上面的介绍不难看出，相对于动态库，静态库的优点在于直接被链接进可执行程序中，之后，该可执行程序就不再依赖于运行环境的设置了（当然仍然会依赖于 CPU指令集和操作系统支持的可执行文件格式等硬性限制）。而动态库的优点在于，用户甚至可以在程序运行时随时替换该动态库，这就构成了动态插件系统的基础。具体使用静态库和动态库，由程序员根据需要自己决定。
> 
> **总结：**现在你应该对程序的运行所需要的东西有了一些了解吧。也就是说静态编译发布程序就只需要编译输出时的那个exe就行，他所需要的额外环境在编译时已经嵌入到程序中中去了，就类似于前面所说的图片等资源性文件，之所以叫静态就是因为嵌入之后固定在了程序中，不可改变。动态编译就不同，他所需要的额外环境在编译时并不编译这些东西，而只变异自己写的这些代码，自己的程序编译好了之后会留下调用这些额外环境，也就是说留下了入口地址，和名字。所以他们是在程序运行时对库进行动态的加载的，什么时候需要额外环境这些库，什么时候就加载，这就是动态的意义。

# 2、QT程序在windows下的发布 #

##       发布过程 ##

>        好了，假设你看了前面的内容，那么对于接下来的内容就很理解了，这里的发布程序其实并不局限于发布qt,在windows上发布其他程序其实也是一样的过程。由于发布有两种，而静态编译就是直接将自己编译好的exe程序可以单独的发布出去就行了，很简单，这里我们主要讲动态编译的发布，优缺点已经在上文指出。
> 
>  
> 
>     1  首先保证自己的程序在的构建方式是release版本不是debug版本，然后编译器里运行可以没问题（假设你用的是qt creater,版本的选择在编译器左侧按钮“项目”中进行设置，构建好之后按ctrl+f5或者点击编译器左下角的运行按钮）；
>     
>     2  然后新建一个你的程序目录，将自己在编译器输出的release目录下拷贝出自己的exe文件放入这个文件夹；
>     
>     3  最后一步就是从qt环境库中将所需要的dll文件拷贝至这个文件夹就行（此时可再用其他软件打包成一块或者生成安装包，这一步可以省略）；
> 
>   
> 此时你将整个文件拷贝至其他的未安装qt环境的机子上也可运行，相当于是一种自给自足的生存方式，自己带着自己所需要的东西，所以在任何地方就可以独立存在。
> 
> ## 详细方法 ##
> 
> 在本地可以运行程序时，先双击运行程序然后使用工具查看自己的这个程序使用到了哪些动态库。有两个工具，一个是Dependency Walker，一个是process explorer，这两个工具可以在百度或谷歌上直接搜出来下载，我建议用后一个，前一个反正是让我走了很多弯路，应为很多系统缺少的dll文件也会报错，我去网上下载了一大堆他这里面秒速的确实文件，最后还是没解决问题，我最后解决问题时没有使用到这里面所描述的缺失的哪些dll文件，照样可以让程序运行。
> 
> ![Center][]
> 
> 这个工具将告诉你如果程序缺失文件，那么这个文件要么是黄色的标记要么是红色的标记，使用方式就是打开软件，点击软件左上方第一个按钮打开文件将你的exe文件打开就可以看到dll关联。
> 
>  
> 
> 而第二个软件是我所推荐的，
> 
> ![Center 1][]
> 
>           他可以将dll分类，及可以查看它使用到了哪些qt环境中的dll文件，然后值拷贝过来即可，对于上一个软件所标记的缺失文件不用去理睬。这个软件的使用方式是，运行自己的程序，打开此软件，在上半部分里点击软件在下半部分即可显示所用到的dll文件，如果没有下方窗口，可右键上半部分自己的exe名，在弹出的右键菜单中打开。
> 
>          好了知道了程序所需要的dll文件将他们拷贝到exe文件中就行了吗，答案是错误的，程序还是运行不起来，我也是用了很久才搞清楚这个问题，原来是这些dll文件需要一种目录排版。
> 
> ##   问题及解决 ##
> 
>  接下来我来证实一下网上所说的集中问题的解决答案：
> 
>         问题描述：.运行exe失败，提示This application failed to start because**it could not find or load the Qt platform plugin “windows”** Reinstalling the       application may fix this problem.
> 
>          这个问题是我遇到的最大的问题，网上说了很多其他东西，经过试验其实都没有解决也没有成功，唯一成功的就是如下解决方法：
> 
>  
> 
>     a）在exe文件所在目录下新建一个文件夹 platforms , 将 qwindows.dll拷贝至此文件夹下-此目录是第二级目录 (在类似于这样的目录下D:\Qt\Qt5.2.0\5.2.0\Src\qtbase\plugins\platforms寻找，这个就是你安装qt的软件位置)
>     
>     b）如果软件使用到了图片也是类似处理：在exe文件所在目录新建文件夹imageformats, 然后去QT的安装/编译好的plugins下imageformats文件夹下拷贝相应的图片编码的dll和lib。例如在程序中用到的图片是jpg格式的，就copy qjpeg.dll ，类似的还有其他gif之类的,若嫌麻烦直接将整个目录copy过来即可（只是臃肿了点而已）。
> 
> 注意这里最关键的一步是dll文件路径架构问题，我是把文件结构架构清楚了，才运行程序成功的。架构如下，
> 
> ![Center 2][]
> 
>           非要这样子才行，如果直接丢入dll文件不行，要这样的文件目录结构才能发布成功。我想主要原因是，QCore5.dll这些文件也就是上图第2个项中的那些dll文件时qt官方出品的，他们调用其他的诸如qwindows.dll文件的目录是写死了的，也就是编译成dll文件的里面路径就是这么的吧，我只是猜测，仅供参考而已，哈哈。
> 
> 由于我确实是比较笨拙，对于以上的内容理解难免有很多不对的地方，也许很愚蠢，但是这是我自己通过摸索解决出来，希望多多鼓励和指教，愿共同进步。
> 
>  
> 
> 同时附上打包发布的一篇文章和视频。
> 
> 文章：[http://www.cr173.com/html/15231\_1.html][http_www.cr173.com_html_15231_1.html]
> 
> 视频：[http://download.csdn.net/detail/fanpei\_moukoy/7030757][http_download.csdn.net_detail_fanpei_moukoy_7030757]

[Center]: /images/20220824/7eca2837a17a4fc5b313b15b60d10b36.png
[Center 1]: /images/20220824/3d7d05bd1d234a0e8fe7257d7daf9b0e.png
[Center 2]: /images/20220824/c10b9ba28a8a490b8f2c9d84c3f027dd.png
[http_www.cr173.com_html_15231_1.html]: http://www.cr173.com/html/15231_1.html
[http_download.csdn.net_detail_fanpei_moukoy_7030757]: http://download.csdn.net/detail/fanpei_moukoy/7030757