Qt 程序打包发布总结
1. 概述
当咱们用QT写好了一个软件，要把你的程序分享出去的时候，不可能把编译的目录拷贝给别人去运行。编译好的程序应该是一个主程序，加一些资源文件，再加一些动态连接库，高大上一些的还能够作一个安装文件。html
QT开发的程序发布的时候常常采用两种方式：linux
l 静态编译，可生成单一的可执行文件。sql
l 动态编译，需同时附上须要的dll文件。shell
2. 发布准备
无论采用哪一种方式，首先咱们要把项目的发布作一些准备，例如：准备程序的图标，将项目编译成release等。
安全
2.1. 设置程序图标
应用程序的图标分两种：app
l 主窗口图标，主要在程序运行时显示在主窗口左上角，或在任务栏上显示。函数
l 运行程序图标，通常在桌面或文件夹中显示的缩略图标，能够点击后运行程序。工具
2.1.1. 设置主窗口图标
首先在绘图工具（例如Photoshop）中设计好图标，图标的分辨率最好大于32*32。图标须要用*ico或*png的文件。若是想偷懒一点，直接去这里（http://www.iconfinder.com/）下载，大量好看免费的图标。post
将刚才的生成的图标文件放到yourProjectFolder/Resources/images目录下,或者任意一个程序能够找到的位置。最好将图标文件添加到qrc中统一管理，qrc文件的格式以下：开发工具
<RCC>
<qresourceprefix="/background">
<filealias="mainlogo">christmas_stocking.png</file>
</qresource>
</RCC>
而后再主窗口中使用，代码以下，代码很简单，不过记住这句代码必定要放到Mainwindow的构造函数里去，否则不会work。
/*setwindowicon*/
setWindowIcon(QIcon(QStringLiteral(":/background/mainlogo")));
程序运行后的效果以下：
2.1.2. 设置运行程序的图标
设置运行程序的图标在各个平台是各不相同的，下面分别介绍。首先准备分辨率最好大于32*32的图标文件。图标须要用*ico的文件。
1) Windows平台
A）使用Visual Studio IDE开发工具
若是使用的是VisualStudio IDE开发工具，例如在VS2015中，项目上右击，添加，资源，选择icon，而后将以前准备的*ico图标文件导入，肯定以后项目中就会出现一个 projectname.rc 的文件。
B）使用QTCreator的IDE开发工具
若是你是使用qmake生成makefile文件或使用QT Creator IDE，那么按下面三步实施：
l 第一步：建立一个包含图标图像的ICO文件，并将其保存在资源文件目录下，例如命名为：myapp.ico；
l 第二步：建立一个.rc文件，包含以下内容：
IDI_ICON1 ICON DISCARDABLE "myapp.ico"
l 第三步：在工程文件myapp.pro文件中写入以下内容：
RC_FILE = myapp.rc
再次编译程序，便可达到效果，效果图以下：
2) Mac OS X平台
虽然许多程序能够建立图标文件（.icns），推荐的方法是使用由苹果公司提供的程序iconutil。Iconutil是一个命令行工具，它容许您导入多个不一样大小的图标（在不一样的上下文中使用），并能压缩文件。在您的项目目录中将全部一系列的图标保存在一个文件中。
若是您正使用qmake生成makefile文件，您只须要将一个单一的行添加到您的.pro工程文件。例如，若是您的图标文件的名称是myapp.icns，而且您的项目文件名称是myapp.pro，加入这一行到myapp.pro：
ICON = myapp.icns
这将确保qmake把你的图标放在适当的位置并为图标建立一个Info.plist条目。
若是你不使用qmake，你必须手动执行如下几点：
1) 为您的应用程序（使用PropertyListEditor，在Developer/Applications中能够找到）建立一个Info.plist文件。
2) 在Info.plist文件（一样，使用PropertyListEditor）关联您的.icns记录和CFBundleIconFile记录。
3) 将Info.plist文件复制到你的应用程序包的Contents目录。
4) 复制.icns文件到你的应用程序包的Contents/Resoures目录。
3) 通用的Linux平台
在本节中，咱们简要地介绍一下在两种常见的linux桌面环境：KDE和GNOME，为应用程序提供图标的相关问题 。为这两种桌面，用来描述应用程序图标的核心技术是相同的，也能够适用于其余，但具体到每个来说也有各自的细节。对使用这些Linux桌面系统的标准信息的主要来源是freedesktop.org。有关其余Linux桌面的信息，请参阅您感兴趣的桌面文档。
一般状况下，用户不直接使用可执行文件，而是经过点击桌面上的图标来启动应用程序。这些图标是包含带有关于它的图标信息的应用程序的描述表示的“桌面项” 文件。这两种桌面环境都可以在这些文件中检索信息，而且能够用它们来生成应用程序的快捷方式到桌面上，在开始菜单中，或者在面板上。
有关桌面项文件的更多信息，能够在Desktop EntrySpecification中找到。
虽然桌面项文件能够有效地封装应用程序的详细信息，咱们仍然须要将图标存储在每一个桌面环境中的常规位置。用于图标的一些位置在Icon ThemeSpecification中给出了。
虽然用于定位图标的路径依赖于在桌面上的使用和它的配置，下面全部这些目录结构应该遵循相同的模式：子目录都按照主题，图标大小和应用程序类型进行组织。 一般，应用程序图标被添加到高彩主题，所以方形的应用程序图标的大小为32像素，它将被存储在hicolor/32x32/apps目录的图标路径的下方。
一、 K桌面环境(KDE)
应用程序图标能够被全部用户或者一个单一的用户安装使用。当前登陆到他们的KDE桌面的用户能够经过使用kde-config发现这些位置，例如，经过在终端窗口中键入执行下列操做：
kde-config --pathicon
一般状况下，被输出到stdout的以冒号分隔的路径列表中包含了用户特定的图标路径和全系统的路径。下面这些目录中，能够根据在Icon ThemeSpecification中描述的约定来定位并安装图标。
若是您正在专门为KDE开发，你不妨利用KDE build system的优点来配置您的应用程序。这能够确保你的图标被安装在KDE的适当位置。
KDE的开发者网站是http://developer.kde.org/。
二、 GNOME
应用程序图标都存储在包含与体系结构无关文件的一个标准全系统目录下。这个位置能够经过使用gnome-config来肯定，例如，经过在一个终端窗口中键入如下命令：
gnome-config--datadir
输出在标准输出stdout的路径指的是包含一个名为pixmaps目录的位置;这个pixmaps目录中的目录结构中在Icon ThemeSpecification中进行了描述。
若是您正在专门为GNOME开发，你可能但愿使用一组标准的GNU Build Tools，在GTK+/GnomeApplication Development book的相关章节也做了说明。这能够确保你的图标被安装在为GNOME中的适当位置。
2.2. 编译release版本
注意将运行程序编译方式设置成Release，由于debug版本的程序中包含了调试信息，能够用来调试。而真正要发布程序时，要使用release版本，这样能够减小发布程序的体积同时增长软件的安全。
上图演示在Qt Creator中的设置方式，选中IDE左边的侧边栏的项目，而后再构建设置中将构建配置设置为Release。
上图演示在VS2015中的设置方式，选中IDE右边的解决方案管理器中的项目，而后在IDE上边的工具栏中将构建配置设置为Release。
3. 发布程序
安装QT SDK 后，默认采用的是动态连接库的编译方式，若是须要发布程序，须要在可执行的文件中添加必须的动态连接库，然而有些动态连接库文件很大，这并非咱们想要的结果。
最好的办法是提交一个静态连接的程序。可是安装的Qt是动态编译的，要生成静态的版本，就须要本身从新进行编译。
3.1. 静态编译
l 优势，发布简单，单一文件。
l 缺点，库文件很大，更新程序版本不方便。每次升级，都要从新分发全部的内容。
静态发布虽然不须要较多的dll，发布简单、方便，可是每每会牵扯到受权问题（详情请查看Qt LGPL受权），动态发布则能够避免。。。若是附带了Qt的dll，就至关于发布了Qt的dll，而這些库是属于Qt的，这足以保证使用者知道程序使用了LGPL版本的Qt。
1) Windows平台静态编译
静态编译首先须要将
mingw平台静态编译，在编译Qt的时候，有个configure.exe程序，
configure.exe-static -platform win32-g++
能够产生静态编译项目文件。而后，
mingw32-makesub-src
就能够编译出静态库。若是只是用来分发程序，也能够mingw32-makerelease sub-src只编译一个静态库。
VC2015平台，在编译Qt的时候，configure.exe-static-platform win32-msvc2015
而后nmakesub-src或者nmake release sub-src完成静态编译。
再而后，就是把你的程序从新用静态编译的Qt再编译一次。
你会获得一个很是大的可执行程序。推荐使用AspPack压缩一下。就能够发给用户了。
2) linux平台静态编译
一、下载源安装程序，如 qt-everywhere-opensource-src-5.5.1.tar.gz
二、解压到某一目录
三、cd 进入解压后的目录，命令：
./configure-static -release -qt-zlib -qt-gif -qt-libpng -qt-libmng -qt-libjpeg -nomakedemos -nomake examples -qt-sql-sqlite -prefix /usr/local/Trolltech/Qt-5.5.1_static
参数-static 指的是要采用静态编译Qt的方法
参数-release指的是只编译release版本的库
参数-qt-zlib -qt-gif-qt-libpng -qt-libmng -qt-libjpeg 是更好肯定Qt编译出的程序能在目前不知的系统下运行。
参数-nomake demos-nomake examples 指的是不编译demos和examples
参数-qt-sql-sqlite 若是没有这个参数，configure的时候，可能会提示sqlite 有问题而停止。
参数 -prefix/usr/local/Trolltech/Qt-5.5.1_static 指明静态编译的Qt安装的目录，命名Qt-5.5.1_static是为了区别动态编译安装的Qt，由于若是没有这个参数，安装时会覆盖以前动态编译安装的Qt（若是有的话）。
u 注: 若是出现错误：Basic XLibfunctionality test failed!
You might need to modify theinclude and library search paths by editing
QMAKE_INCDIR_X11 andQMAKE_LIBDIR_X11
解决办法：yum installlibX*
（若是是Ubuntu也可运行sudo apt-getinstall libx11-dev libxext-dev libxtst-dev)
四、没问题后
make
五、make没问题后再
sudo make install
六、增长（或改变）环境变量： （也能够不添加环境变量，使用绝对路径进行编译），在你home目录下你的的名字的目录中,在.profile文件中追加（或改变）以下环境变量：(为Qt设置一些特定的环境变量，这个很重要！.profile文件是隐藏的，可在你的名字目录下，按Ctrl+H显示全部文件查看到)
QTDIR=/usr/local/Trolltech/Qt-5.5.1_static/
PATH=$QTDIR/bin:$PATH
MANPATH=$QTDIR/doc/man:$MANPATH
LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
export QTDIR PATHMANPATH LD_LIBRARY_PATH
七、重启
八、在终端测试一下qmake
3) MAC OS X系统平台静态编译
在MAC OS X系统平台下静态编译QT应用仍是比较麻烦的，首先须要静态编译QT应用依赖的各个库，而后再进行链接生成运行文件，具体步骤参看连接：http://doc.qt.io/qt-5/osx-deployment.html。
3.2. 附加Dll文件
l 优势，更新方便，发布多个产品时，能够统一使用一个库。
l 缺点，文件多、杂。
Qt官方开发环境默认使用动态连接库方式，在发布生成的可执行程序时，咱们须要复制一大堆动态库，若是本身去复制动态库，极可能丢三落四，致使程序在别的电脑里没法正常运行。 所以 Qt 官方开发环境里自带了一个部署工具来帮助开发者自动拷贝大部分的依赖库。在不一样的平台使用方式也有所不一样。
1) Windows平台
Windows开发环境下windeployqt工具 (若是你已经将Qt的bin目录加入PATH环境,那么你能够直接在命令行使用windeployqt调用.)。首先，将项目中的release文件中的可执行文件拷到一个新建的文件夹中，例如project.exe，用Qt自带的生成必备的dll文件的程序windeployqt，来把必要的动态库拷到该文件夹中，打开命令行，输入windeployqtproject.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
接下来要高大上的朋友就能够用Enigma VirtualBox软件虚拟化工具将多个文件封装到应用程序主文件，从而制做成为单执行文件的绿色软件。
2) 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了。
若是须要把执行程序制做成DEB或RPM包的话请参考连接：
Deploying aQt5 Application Linux： https://wiki.qt.io/Deploying_a_Qt5_Application_Linux
3) MAC OS X系统平台
因为Qt的库并非OS X标配的，因此咱们要本身去复制库到app包里，才可让app在其余未安装Qt的电脑上运行。
比较幸运的是，Qt为咱们提供了macdeployqt工具，借助于此，在OS X上发布Qt写的程序几乎是全部平台中最简单的。
注：我电脑配置了Qt的bin环境，因此能够直接使用macdeployqt，若是没配置，能够用绝对路径去找。
1.发布widgets程序
a) 这个比较方便。选择Release模式，编译
b) 运行macdeployqt
对于个人工程，命令是：
macdeployqt /Users/Ocean/Desktop/build-untitled-Desktop_5_5_1_64bit-Release/untitled.app-dmg
而后回车，就打包好了。以后咱们会发现，app目录下多了一个dmg文件
此dmg文件，里面的app就是咱们发布的app了。把dmg拷贝给别人，别人就能够直接使用了。
l 注：若是直接拷贝app文件给别人，别人是没法直接运行的，会有权限问题（要用chmod给可执行文件加上x权限才能够运行）。而压缩过（zip或者dmg）后，拷贝给别人，别人是能够直接运行，没有权限问题。
l 注：-dmg的意思就是在拷贝好库后，生成一个dmg文件，能够不加这个参数。
2.发布quick2程序
这个相对麻烦一点
a) 选择Release模式，编译
b) 打开终端，先切换编译的目标目录下
对于个人工程，命令是：
cd /Users/Ocean/Desktop/build-untitled-Desktop_5_5_1_64bit-Release
c) 运行macdeployqt
对于个人工程，命令是：
macdeployqt untitled.app-qmldir=../untitled -dmg
而后回车，就打包好了。
l 注1：和widgets发布程序不一样，untitled.app 这个名字，要直接输入，不要写 ./untitled.app 或者是其余的 绝对/相对 路径，否则打包出来的文件没法使用！！会报错！！！
l 注2：-qmldir=../untitled的意思就是说在../untitled 目录下有qml文件，让macdeployqt去分析它们，把要用的库找过来。