前言
此方法适用于对自己建立的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加载失败)
网友评论