若该文为原创文章，未经允许不得转载

原博主博客地址：https://blog.csdn.net/qq21497936

原博主博客导航：https://blog.csdn.net/qq21497936/article/details/102478062

本文章博客地址：https://blog.csdn.net/qq21497936/article/details/85396652

各位读者，知识无穷而人力有穷，要么改需求，要么找专业人士，要么自己研究若该文为原创文章，未经允许不得转载

红胖子(红模仿)的博文大全：开发技术集合（包含Qt实用技术、树莓派、三维、OpenCV、OpenGL、ffmpeg、OSG、单片机、软硬结合等等）持续更新中…（点击传送门）

OpenCV开发专栏（点击传送门）

前言

      做跨平台开发经常遇见程序打包，打包不可怕，可怕的是明明打包完了，却在裸机上运行出现插件错误，明明拷入插件库为啥还是会加载xcb失败呢(当前场景仅测试ubuntu)？下面根据需求完成打包流程。

需求

      发布qt应用程序，解压后直接可以运行。

打包流程

步骤一：基础依赖库打包（创建打包脚本）

      在开发机上生成需要发布的应用，如下图：

      创建copyLibs.sh脚本，拷贝下列脚本内容，该脚本是用于拷贝应用所依赖的库至当前文件夹：

#!/bin/sh 
# 发布程序的名称（参数1，执行脚本时输入）
exe=$1
# 修改输出可执行文件路径（当前路径）
destDir=`pwd`
# ldd将所有依赖库生成字符串组(#注意if后的空格只有一个）
dependenLibsList=$(ldd $exe | awk '{if (match($3,"/")){ printf("%s "),$3 } }') 
# 将字符串组里面的库拷贝到目标文件夹
cp $dependenLibsList $destDir

      指令如下：

gedit copyLibs.sh

      将上述脚本拷贝进去后保存，如下图：

      然后执行：

chmod +x copyLibs.sh
./copyLibs.sh

      如下图：

步骤二：运行脚本（创建运行脚本）

      创建运行脚本，在目标机上运行的时候，需要将qt的环境变量加入，方便找寻依赖库的路径等等，创建运行脚本，脚本名必须是”应用名.sh”，执行如下指令：

      在myApp.sh输入以下脚本：

#!/bin/sh 
# 获取应用名称(如应用名称为app，那么脚本为app.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 "$@"

      myApp.sh截图如下：

      读者可以直接运行，可以得出开发机运行成功。

步骤三：补充插件

      运行到目标机（虚拟机裸ubuntu16.04 amd64）上，运行如下图，需要补充插件文件夹：

      以上这种情况是需要拷贝到平台插件文件夹到应用目录下，所有发布程序都需要拷贝platforms文件夹，主要是拷贝发布的平台所对应的插件，如下图：

      可以全部拷贝，省事，或者只拷贝xcb(ubuntu只用到这个)。

      笔者这里拷贝整个文件夹，将其他的都删掉，只剩libqxcb.so，运行仍然是加载插件xcb失败。

      其实这个时候插件是存在了，也加载到了，为什么加载失败呢，是因为xcb插件本身依赖一些库，而这些库在ldd里面并没有体现出来(应用中没有用到)。

步骤四：运行调试插件（重点解决xcb加载失败）

      这里调试时，有一个技巧，打开插件调试配置：

export QT_DEBUG_PLUGINS=1

      然后再运行应用脚本，可查看插件加载过程，如下图：

      缺少libQt5XcbQpa.so.5，将该库拷贝到应用目录下，这里注意qt库只有libQt5XcbQpa.so.5.9.3是实体，如libQt5XcbQpa.so，libQt5XcbQpa.so.5，libQt5XcbQpa.so.5.9都是连接文件，拷贝时特别注意，别只拷贝了连接，那是不会有作用的，具体如下图：

      在开发机上，库的路径在Qt安装目录下，如下图：

      此时，我们直接拷贝libQt5XcbQpa.so.5.9.3到应用目录下，并改名为libQt5XcbQpa.so.5即可，继续运行脚本，如下图：

      所以，按照上述方法继续拷贝libQt5Dbus.so.5库，然后运行脚本，即可运行成功！！！

步骤五：优化步骤一的基础依赖库打包脚本

      读者可以将xcb平台libQt5XcbQpa.so.5和libQt5Dbus.so.5通过脚本写入copyLibs.sh，从而运行一个脚本即可，省略步骤四（主要是偶尔用到，经常忘记导致有点麻烦  =_= ）。

      添加什么脚本进去，欢迎读者自行补充，欢迎提交评论，笔者就不做了。

运行包

      将打包流程最后的包打成一个tar，放到目标机上解压后，直接运行脚本即可，也可以达成deb或者其他ubuntu可运行的软件安装包，具体方法请读者自行百度，笔者暂时没这方面的需求。

注意ubuntu18.04的兼容问题（2020年3月6日）

今天遇到读者求助，说按照本文章方法，在ubuntu18.04无法打包，经过笔者晚上几个小时的问题定位，确实发现ubuntu18在系统方面做了一些变化，首先是运行脚本不能用了，其次是库开启QT_DEBUIG_PLUGINS=1后，提示也变了（读者卡了几天），笔者晚上花了大两个小时去定位。

对于上面所提到的，笔者也打过播放器的包，其他库的应用包，也是在ubutnu18.04却没有此类兼容性的问题，脚本也可用，具体要去对比为什么，笔者不在去研究，但笔者保证按照本文章方法，绝大情况是可行的。

若其他读者遇到类似的问题，那么具体的问题需要具体分析，解决不了可以求助博主，毕竟时间就是钱，本博客不会再更新兼容新的系统。

原博主博客地址：https://blog.csdn.net/qq21497936

原博主博客导航：https://blog.csdn.net/qq21497936/article/details/102478062

本文章博客地址：https://blog.csdn.net/qq21497936/article/details/85396652