麒麟系统开发笔记（八）：在国产麒麟系统上使用linuxdeployqt发布qt程序

前言

  在ubuntu上发布qt程序相对还好，使用脚本，但是在麒麟上发布的时候，因为银河麒麟等不同版本，使用脚本就不太兼容，同时为了实现直接点击应用可以启动应用的效果，使用linuxdeployqt发布qt程序。

 

补充

  在ubuntu上发布程序遇到xcb问题，当我们将其部署到另外同样环境但是未装qt的环境下，运行起来一部分是xcb文件，有一部分解决后可以正常运行启用，另一部分直接段错误，程序宕掉（提示，段核心错误，已转存什么的），使用linuxdeployqt能解决此问题，也就是使用脚本打包的升级版本。

 

linuxdeployqt

  Linux部署工具linuxdeployqt将应用程序作为输入，并通过将应用程序使用的资源（如库、图形和插件）复制到一个包中使其自包含。结果包可以作为AppDir或AppImage分发给用户，也可以放入交叉分发包中。它可以作为构建过程的一部分，在CMake、qmake和make等系统中部署用C、C++和其他编译语言编写的应用程序。当用于基于Qt的应用程序时，它可以绑定运行应用程序所需的Qt的特定最小子集。

源码下载地址

  gitcode地址：https://gitcode.net/mirrors/probonopd/linuxdeployqt

 

linuxdeployqt编译（麒麟系统，ubuntu）

步骤一：下载解压

  

步骤二：修改源码，去掉版本检查

  找到main.cpp源码，将这一段（在192行左右）注释掉：

gedit tools/linuxdeployqt/main.cpp

  
  （注意：这一步不做会导致打包输出错误信息，具体看“入坑一”）

步骤三：安装依赖第三方库

sudo apt-get install cmake
sudo apt-get install patchelf

步骤四：使用cmake配置

cmake CMakeList.txt

  

  因为安装了git与这个工程可能不对，我们直接使用源码修改大法，直接定位到代码给删掉：
  
  直接删掉目录下的缓存文件：CMakeCache.txt，然后继续：
  

步骤五：配置Qt的依赖环境

  麒麟系统本身自带了qt5，而我们使用了另外安装的qt5，所以依赖需要引入我们自己安装的qt5上。
  为了方便配置，也不影响系统我们装上cmake的gui版本：

sudo apt-get install cmake-gui

  

cmake-gui

  选择对应的路径，然后使用默认unix makefile方式配置：
  
  错误如下：
  
  添加环境变量路径：
  
  继续配置成功：
  

步骤六：生成generate

  

步骤七：编译make

  切入build目录，并且使用make命令即可：

make

  

步骤八：安装到系统目录

  没有make install这个，手动移动到/usr/local/bin

sudo mv linuxdeployqt /usr/local/bin/

  

步骤九：测试是否编译成功

  

 

linuxdeployqt打包流程

  新建一个工程
  
  然后找个空目录：
  
  开始打包：
  
  错误“QDir::exists: Empty or null file name”，需要调整打包命令：
  
  错误“qmake not fount on the PATH”，qmake要引入PATH”，qmake要引入PATH中：

export PATH=$PATH:/home/hdgx/Qt5.12.1/5.12.1/gcc_64/bin

  这里要将Qt引入环境，为了不影响系统，使用脚本引入，每次使用之前使用source env.sh引入即可。

#!/bin/sh
QT_DIR=/home/hdgx/Qt5.12.1/5.12.1/gcc_64
export PATH=${QT_DIR}/bin:$PATH
export LIB_PATH=${QT_DIR}/lib:$LIB_PATH
export PLUGIN_PATH=${QT_DIR}/plugins:$PLUGIN_PATH
export QML2_PATH=${QT_DIR}/qml:$QML2_PATH
export LD_LIBRARY_PATH=${QT_DIR}/lib:$LD_LIBRARY_PATH

echo $PATH
echo $LIB_PATH
echo $PLUGIN_PATH
echo $QML2_PATH
echo $LD_LIBRARY_PATH

   
  
  下次打包遵循此流程即可，继续打包：
  
  发现已经打包成功（ERROR：Could not parse verbose level忽略）：
  
  

 

入坑

入坑一：运行报错“ERROR：The host system is tool new.”

问题

  

原因

  源码中做了判断，不是源码编译问题，所以要修改源码。

解决

  找到main.cpp源码，将这一段（在第190行左右）注释掉：
  

gedit tools/linuxdeployqt/main.cpp

  
  然后重新make：