Linux下使用linuxdeployqt发布Qt程序

Posted 2022-05-20 qq_735754647

安装linuxdeployqt

一.下载并安装linuxdeployqt

1.下载

方式一:若系统在ubuntu18.04以下，可以直接去 github下载编译好的linuxdeployqt-x86_64.AppImage 应用程序文件
方式二:若系统ubuntu18.04，则github上还未提供已经编译好的AppImage,需要下载[linuxdeployqt源码](GitHub - probonopd/linuxdeployqt: Makes Linux applications self-contained by copying in the libraries and plugins that the application uses, and optionally generates an AppImage. Can be used for Qt and other applications自己在系统上进行编译后方可使用。

去github直接下载编译好的 linuxdeployqt-continuous-x86_64.AppImage 应用程序文件。

2.安装

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

 chmod +x linuxdeployqt-continuous-x86_64.AppImage
 sudo mv linuxdeployqt-continuous-x86_64.AppImage linuxdeployqt
 sudo mv linuxdeployqt /usr/local/bin
 linuxdeployqt --version
#输出的版本信息
linuxdeployqt 8 (commit aeafcd2), build <local dev build> built on 2022-05-19 02:13:10 UTC

方式二源码编译安装

由于目前官网提供的编译好的包适用于Ubuntu16.04以下的版本，ubuntu18.04及以上版本需要自行编译安装。编译安装步骤如下：

方式二：编译源码。

sudo apt install git g++

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

sudo apt install patchelf

1）使用git克隆linuxdeployqt源代码，命令如下：

git clone https://github.com/probonopd/linuxdeployqt --depth=1

2)git完成后，进入linuxdeployqt文件夹

cd linuxdeployqt

#修改 tools/linuxdeployqt/main.cpp 源代码，注释掉源码中版本判断的语句。

gedit tools/linuxdeployqt/main.cpp

3)注释掉源代码种版本判断的代码，使其对ubuntu18.04及以上版本适用，使用gedit或者vim打开tools/linuxdeployqt/main.cpp脚本，将以下代码注释

        /*if (strverscmp (glcv, "2.28") >= 0) 
            qInfo() << "ERROR: The host system is too new.";
            qInfo() << "Please run on a system with a glibc version no newer than what comes with the oldest";
            qInfo() << "currently still-supported mainstream distribution (Ubuntu Bionic), which is glibc 2.27.";
            qInfo() << "This is so that the resulting bundle will work on most still-supported Linux distributions.";
            qInfo() << "For more information, please see";
            qInfo() << "https://github.com/probonopd/linuxdeployqt/issues/340";
            return 1;
        */

注释之后保存退出即可。之后在当前目录执行cmake、make命令。

2. 安装cmake

在Ubuntu上使用命令：

sudo apt install cmake

同样：CentOS使用:

sudo yum install cmake

修改之后保存。然后回到linuxdeployqt目录，使用cmake编译：

cmake CMakeLists.txt

编译完了之后，生成了makefile文件，再执行make完成之后

make

最后在tools/linuxdeployqt目录生成一个可执行文件：linuxdeployqt

cd tools/linuxdeployqt

Ubuntu上将linuxdeployqt文件拷贝到/usr/local/bin使用

在任何一个位置，使用./linuxdeployqt能正常使用，即安装成功了。

在目录tools/linuxdeployqt/linuxdeployqt下会生成一个linuxdeployqt的二进制文件，进入该目录，修改权限使其可执行如下:

sudo chmod 777 linuxdeployqt

同样为了方便直接使用，将该文件移动至/usr/local/bin目录下

sudo cp -p linuxdeployqt /usr/local/bin/

同样执行如下代码显示版本则表示安装成功。

sudo linuxdeployqt --version

三.配置 qt 的环境变量

终端输入vim ~/.bashrc    或者 gedit ~/.bashrc 命令，

vim ~/.bashrc

gedit ~/.bashrc

修改 .bashrc 文件，在文件末尾追加以下内容，因为我是root 命令安装QT的 其中/opt/Qt/5.14.2是我的Qt安装路径，直接安装的你们路径可能是/home大家要用自己的路径代替：

#add QT ENV
export PATH=/opt/Qt5.14.2/5.14.2/gcc_64/bin:$PATH
export LD_LIBRARY_PATH=/opt/Qt5.14.2/5.14.2//gcc_64/lib:$LD_LIBRARY_PATH
export QT_PLUGIN_PATH=/opt/Qt5.14.2/5.14.2/gcc_64/plugins:$QT_PLUGIN_PATH
export QML2_IMPORT_PATH=/opt/Qt5.14.2/5.14.2/gcc_64/qml:$QML2_IMPORT_PATH

export QT_DEBUG_PLUGINS=1

如果使用查看自己的qmake版本不对

qmake -v

将第一行改为自己安装路径（这是我的安装路径/opt/Qt5.14.2/）下的bin目录的路径，第二行改为Qt5.14.2目录的路径。如下：

sudo gedit /usr/lib/x86_64-linux-gnu/qt-default/qtchooser/default.conf

改为

/opt/Qt5.14.2/5.14.2/gcc_64/bin
/opt/Qt5.14.2/

 

qtchooser 的配置目录：

/usr/lib/x86_64-linux-gnu/qtchooser

qtchooser 的真实配置目录:

/usr/share/qtchooser

qtchooser 的用户配置目录:

~/.config/qtchooser/

由于我使用的是Ubuntu能直接上面命令修改 其他liunx系统可取真实配置目录下修改

你也可以用其他方式扩展一些环境变量。像 qmake、moc 以及其他的一些 Qt 工具所在的路径，都需要加到 PATH 里面。但容易损坏系统的一些环境不推荐使用。

具体的做法，打开 /etc/profile（对所有用户有效）：

sudo gedit /etc/profile

在该文件的最底下添加以下内容：

export PATH="/opt/Qt5.14.2/Tools/QtCreator/bin:$PATH"
export PATH="/opt/Qt5.14.2/5.14.2/gcc_64/bin:$PATH"

保存，重新加载配置：

source /etc/profile

四、打包应用程序

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

 linuxdeployqt untitled -appimage

执行上面命令出现提示信息，不用管，只是创建了一个需要你自己编辑的desktop文件：

ERROR: Desktop file missing, creating a default one (you will probably want to edit it)

到这一步，就把可执行文件的动态库等依赖文件都复制到该文件夹中了。

到这里会出现几个问题：

问题一：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文件无论复制到什么路径下都可以执行，且项目运行的当前路径为主目录（比如，工程中有数据库操作，那么生成的数据库文件就会在主目录，同理，工程依赖的资源文件，也要放在主目录）。

虽然 linuxdepoyqt 可以帮我们解决多数情况下库的依赖问题，但是也有的时候不能完整解决。这个时候就需要我们自己复制所依赖的库。
提供一个脚本，复制依赖库，复制以下代码，将其保存成为 pack.sh

#!/bin/sh
exe="untitled" #可执行文件名称
des=$PWD #依赖库被拷贝的最终位置
deplist=$(ldd $exe | awk  'if (match($3,"/")) printf("%s "),$3  ')

cp $deplist $des

另建一个与文件名称相同的.sh  如untitled.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 "$@" 

给这两个脚本加权限

chmod 777 xxxxx.sh

chmod 777 pack.sh
chmod 777 untitled.sh

创作打卡挑战赛 赢取流量/现金/CSDN周边激励大奖