Ubuntu18.04下使用linuxdeployqt对QT5项目打包，以及生成快捷方式

前言

此方法适用于对自己建立的QT项目进行打包，Ubuntu环境为18.04，使用QT Creator4.12.3 Based on Qt5.14.2。项目打包之后可以复制到其他电脑上运行，切具有快捷启动方式。

一.下载并安装linuxdeployqt

1.下载

方式一:若系统在ubuntu18.04以下，可以直接去 github下载编译好的linuxdeployqt-x86_64.AppImage 应用程序文件
方式二:若系统ubuntu18.04，则github上还未提供已经编译好的AppImage,需要下载[linuxdeployqt源码](https://github.com/probonopd/linuxdeployqt自己在系统上进行编译后方可使用。

2.安装

方式一:利用下载编译好的linuxdeployqt-x86_64.AppImage 应用程序文件。下载好之后，将其改名为linuxdeployqt，并chmod +x，然后复制到 /usr/local/bin/。然后命令行输入 linuxdelpoyqt –version，查看是否安装成功，若输出版本信息表示安装成功。

$ chmod +x linuxdeployqt-x86_64.AppImage
$ mv linuxdeployqt-x86_64.AppImage linuxdeployqt
$ mv linuxdeployqt /usr/local/bin
$ linuxdelpoyqt --version
#输出的版本信息
linuxdeployqt 5 (commit 37631e5), build 631 built on 2019-01-25 22:47:58 UTC

方式二：编译源码。
首先默认已经安装好了g++、git等工具，如果没有的话得先安装。还需要安装 patchelf 工具，命令如下：

sudo apt install patchelf

gitclone源码(建议一定要使用命令行，直接download的会编译失败)

git clone https://github.com/probonopd/linuxdeployqt.git
#进入linuxdeployqt文件夹，命令如下：
cd linuxdeployqt
#修改 tools/linuxdeployqt/main.cpp 源代码，注释掉源码中版本判断的语句。
gedit tools/linuxdeployqt/main.cpp

之后右键linuxdeployqt文件夹，使用QT Creator打开，配置工程后在release模式下进行编译，可以得到linuxdeployqt的二进制文件，路径为(tools/linuxdeployqt/linuxdeployqt)。

#进入二进制文件所在路径
cd ./tools/linuxdeployqt
#赋予可执行权限
sudo chmod a+x linuxdeployqt
#为了方便之后使用，可以将该可执行文件复制到 /usr/local/bin 目录下：
sudo cp linuxdeployqt /usr/local/bin/

二.安装appimagetool

linuxdeployqt命令要用到选项 -appImage，因此需要安装一下 appimagetool，下载和安装命令如下：

sudo wget -c "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage" -O /usr/local/bin/appimagetool
sudo chmod a+x /usr/local/bin/appimagetool

三.配置 qt 的环境变量

终端输入vim ~/.bashrc命令，修改 .bashrc 文件，在文件末尾追加以下内容，其中/opt/Qt/5.15.0是我的Qt安装路径，大家要用自己的路径代替：

#add QT ENV
export PATH=/opt/Qt/5.15.0/gcc_64/bin:$PATH
export LD_LIBRARY_PATH=/opt/Qt/5.15.0/gcc_64/lib:$LD_LIBRARY_PATH
export QT_PLUGIN_PATH=/opt/Qt/5.15.0/gcc_64/plugins:$QT_PLUGIN_PATH
export QML2_IMPORT_PATH=/opt/Qt/5.15.0/gcc_64/qml:$QML2_IMPORT_PATH

最后要source一下使 ~/.bashrc 这个shell文件立即生效，而不必注销并重新登录。

$ source ~/.bashrc

四.运行linuxdeployqt命令，进行打包

1.运行Qt生成release版本的可执行文件，勾选了“shadow build”，所以示例用的是"build-自己的工程名称-Desktop_Qt_5_15_0_GCC_64bit-Release"文件夹下的自己的工程名称可执行文件；
2.创建一个文件夹，名称最好是用可执行文件的名称，然后将自己的工程名称可执行文件复制到此文件夹下；
3.使用 linuxdeployqt 进行打包，一定要加上-appimage选项，命令如下：

$ linuxdeployqt  自己的工程名称  -appimage

到这里会出现几个问题：

问题一：lib*.so.1 => not found，类似此类的输出，说明该动态链接库找不到，可以进行如下操作。

#先查看二进制文件所依赖的动态库文件有哪些
$ldd #二进制文件的名称
#找到所依赖的库文件的路径，并添加到/etc/ld.so.conf
#例如.so库文件的路径在/usr/lib/x86_64-linux-gnu，就在/etc/ld.so.conf文件中加上/usr/lib/x86_64-linux-gnu，缺少哪个库就添加哪个库的路径
$sudo vim /etc/ld.so.conf
#保存配置文件后，使用下面的命令使其生效
$sudo /sbin/ldconfig

问题二：在问题一的基础上，还会提示缺少依赖库，但通过ldd查询却没有该依赖库，此时可以去考虑百度搜索该库的名称，看是否缺少该库对应的软件包。例如我提示的是libpq.so.5 notfound，通过搜索发现该依赖库属于postgresql，通过如下命令进行安装

$sudo apt install postgresql
#通过该命令取查找库文件的路径
$sudo find / -name libpq.so.5

最后像问题一中一样添加路径并使其生效。
问题三：在问题一中使配置生效的一步中，可能会提示类似“*libcudnn.so.5 不是符号连接”的问题，那么可以如下方式解决。重新建立链接并删除原链接。
首先找到usr/local/cuda-8.0/lib64/目录（libcudnn所在目录），搜索 libcudnn 然后发现两个文件libcudnn.so.5 和libcudnn.so.5.0.5 理论上只有一个libcudnn.so.5.0.5

#终端执行
$ln -sf /usr/local/cuda-8.0/lib64/libcudnn.so.5.0.5 /usr/local/cuda-8.0/lib64/libcudnn.so.5
#再进行
$sudo ldconfig

这时候会发现usr/local/cuda-8.0/lib64/目录下只有libcudnn.so.5.0.5 文件了，libcudnn.so.5消失了。这个问题就可以解决了。

五.打包后的处理

1.如果在执行完$ linuxdeployqt 自己的工程名称 -appimage命令以后，出现如下内容（还有提示图标或者其他库的问题的可以忽略，只要看到下面的输出，就说明成功了）：

Categories entry not found in desktop file
.desktop file is missing a Categories= key

此时会生成AppRun文件，./AppRun或者./自己工程的二进制文件都可以运行，如果项目运行用到了本地文件，也要放到二进制文件所在的目录里面才能保证项目的正常运行。

六.使其像应用程序一样可以启动

1.首先刚刚linuxdeployqt执行完之后，会生成default.desktop文件，使用vim对其进行编辑，内容如下

[Desktop Entry]
Version=app的版本
Name=app的名字
Comment= 说明信息 
Exec=app的执行路径，绝对路径
Icon=icon 路径，绝对路径
Terminal=false #是否在终端启动
Type=Application
Categories=Utility;Application;

之后赋予权限

chmod a+x default.desktop

这时就可以直接双击运行了（提示信任时，直接点击信任即可，这时会发现图标和名称也变了）。

注：这里自定义生成.desktop文件可以复制到/usr/share/applications中，这样应用程序中就可以有改程序；.desktop文件无论复制到什么路径下都可以执行，且项目运行的当前路径为主目录（比如，工程中有数据库操作，那么生成的数据库文件就会在主目录，同理，工程依赖的资源文件，也要放在主目录）。

上述内容参考：
1.在Linux下使用linuxdeployqt发布Qt程序
 2.ubuntu18.04通过linuxdeployqt打包Qt5.0项目
 3.ldd * -> not found
4.解决*.so不是符号连接
 5.加载共享库时出错

还可以尝试不使用linuxdeployqt
Qt实用技巧：ubuntu发布程序打包流程(解决插件xcb加载失败)