Qt5 项目程序打包发布 详细教程

概述

当我们用QT写好了一个软件，要把你的程序分享出去的时候，不可能把编译的目录拷贝给别人去运行。编译好的程序应该是一个主程序，加一些资源文件，再加一些动态链接库，高大上一些的还可以做一个安装文件。

QT开发的程序发布的时候经常采用两种方式：

1. 静态编译：可生成单一的可执行文件
2. 动态编译：需同时附上需要的dll文件。

发布准备

设置程序图标

1. 主窗口图标：主要在程序运行时显示在主窗口左上角，或在任务栏上显示。

2. 运行程序图标：一般在桌面或文件夹中显示的缩略图标，可以点击后运行程序。

设置主窗口图标

（1）首先在绘图工具（例如Photoshop）中设计好图标，图标的分辨率最好大于3232。图标需要用ico或*png的文件。如果想偷懒一点，直接去 https://www.iconfont.cn/ 下载，大量好看免费的图标。

（2）将刚才的生成的图标文件放到yourProjectFolder/Resources/images目录下,或者任意一个程序可以找到的位置。最好将图标文件添加到qrc中统一管理。

（3）然后再主窗口中使用，代码如下，代码很简单，不过记住这句代码一定要放到 **Mainwindow **的构造函数里去，不然不会work。

/*setwindowicon*/
 setWindowIcon(QIcon(QStringLiteral(":/background/mainlogo")));	//括号写你自己实际路径就好

程序运行后的效果如下：

设置运行程序的图标

如果你是使用qmake生成makefile文件或使用QT Creator IDE，那么按下面三步实施：

（1）创建一个包含图标图像的ICO文件，并将其保存在资源文件目录下，例如命名为：myapp.ico；

（2）新建一个.rc 文件 新建文件–>C++–>source文件–>命名为 myapp.rc (不能掉了rc后缀)

​ 打开rc文件添加如下一行代码。

IDI_ICON1 ICON DISCARDABLE "myapp.ico"1

myapp.ico 是你的exe程序图标名。

​ 最后在pro文件添加一行代码

RC_FILE += myapp.rc

保存项目重新编译，exe图标和执行时window图标都将发生变化。

编译release版本程序

注意将运行程序编译方式设置成Release，因为debug版本的程序中包含了调试信息，可以用来调试。而真正要发布程序时，要使用release版本，这样可以减少发布程序的体积同时增加软件的安全。

上图演示在Qt Creator中的设置方式，选中IDE左边的侧边栏的项目，然后再构建设置中将构建配置设置为Release。

上图演示在VS2015中的设置方式，选中IDE右边的解决方案管理器中的项目，然后在IDE上边的工具栏中将构建配置设置为Release。

发布程序

Qt官方开发环境默认使用动态链接库方式，在发布生成的可执行程序时，我们需要复制一大堆动态库，如果自己去复制动态库，很可能丢三落四，导致程序在别的电脑里无法正常运行。 因此 Qt 官方开发环境里自带了一个部署工具来帮助开发者自动拷贝大部分的依赖库。在不同的平台使用方式也有所不同。

windows平台

Windows开发环境下 windeployqt 工具 (如果你已经将Qt的bin目录加入PATH环境,那么你可以直接在命令行使用windeployqt调用.)。

（1）将项目中的release文件中的可执行文件拷到一个新建的文件夹中，例如project.exe，

（2）用Qt自带的生成必备的dll文件的程序windeployqt，来把必要的动态库拷到该文件夹中。

打开命令行，输入

windeployqt  project.exe

这时候大部分的dll文件都自动拷贝过来了，但是 如果项目还用了一些其他的SDK，比如OpenCV，Chartdir51等等，就需要手动将所需dll拷贝过来 ，如果不知道还需要哪些软件，可以用Dependency Walker来查看缺少哪些dll文件。

拷贝完成后文件夹下的文件清单如下：

注意：如果发布的应用是Qt Quick Application应用，那么命令行需要加上QML的安装目录。命令中的D:\Qt\Qt5.5.1\qml是qml的安装目录,请换成你自己的qml安装目录!!!!!

windeployqt hello.exe--qmldir D:\Qt\Qt5.5.1\qml

linux平台

在X11平台下qt程序，首先准备好程序中需要使用的资源，库和插件...，比如你的可运行程序取名叫作panel，那把你的panel,那些libQt.so.4和libQt.so.4.6.0（链接和共享库都要）放在同一目录下(也可以不同,只要小小修改下shell文件).plugins就不多说了。

在程序的同目录下，新建一空文档，取名panel.sh (文件名与程序名同名,扩展名为sh,shell文件)。在panel.sh中原封不动的写入以下语句:

#!/bin/sh

appname=`basename $0 | sed s,/.sh$,,`

  dirname=`dirname$0`

  tmp="${dirname#?}"

  if ["${dirname%$tmp}" != "/" ]; then

   dirname=$PWD/$dirname

 fi

   LD_LIBRARY_PATH=$dirname

export LD_LIBRARY_PATH

   $dirname/$appname$*

保存文件，退出。在终端給文件+x属性: 切换到程序的目录，输入

chmod +x panel.sh

然后运行shell文件就行了（确保panel程序具备X属性）,它会自动更改环境变量,运行程序。

如果要调试shell文件,只需要在终端输入:

sh -x panel.sh

这样就 ok 了。

最后

现在你就可以把现在的文件夹压缩成一个压缩包，分享给你的朋友使用了！！