Solve the problem of using linuxdeployqt to package Qt programs in Ubuntu

I wrote some Qt interface programs, but found it difficult to port them to other computers that do not have the Qt environment installed. After checking the information, I learned that there is a windowsdeployqt program on windows and a linuxdeployqt on linux that can help us package quickly.

1. Configure the Qt environment

First, we configure the Qt environment and add the following line to ~/.bashrc:

export PATH=/home/xl/Qt5.9.2/5.9.2/gcc_64/bin:$PATH
export LD_LIBRARY_PATH=/home/xl/Qt5.9.2/5.9.2/gcc_64/lib:$LD_LIBRARY_PATH
export QT_PLUGIN_PATH=/home/xl/Qt5.9.2/5.9.2/gcc_64/plugins:$QT_PLUGIN_PATH
export QML2_IMPORT_PATH=/home/xl/Qt5.9.2/5.9.2/gcc_64/qml:$QML2_IMPORT_PATH

The home/xl/Qt5.9.2/5.9.2/ directory should be modified according to the Qt path installed on your computer.

Then execute sourec ~/.bashrc to make the configuration take effect.

2. Compile linuxdeployqt

Project address: https://github.com/probonopd/linuxdeployqt.git.

Although the compiled package has been released, I am using Ubuntu 18 and the system version is too high, so I still choose to compile the code.

In order to avoid the problem that the compiled package detects that our system version is too high and does not continue to execute, we comment out the following code in tools/linuxdeployqt/main.cpp before compiling:

// openSUSE Leap 15.0 uses glibc 2.26 and is used on OBS
    /*if (strverscmp (glcv, "2.27") >= 0) { //Comment version check 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 (xenial), which is glibc 2.23.";
      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;
    }*/

Then you can use cmake and make to compile. The generated executable program is tools/linuxdeployqt/linuxdeployqt .

Finally, for ease of use, you can copy the generated executable program to the system's /usr/local/bin/ directory.

3. Packaging

Copy the Qt compiled program to a separate folder.

Then execute linuxdeployqt appname.

Generally, it will be completed smoothly. There will be an Apprun in the current directory. Just execute it directly.

But sometimes it is not so smooth, probably because the corresponding library is missing in the system. For example, the error I encountered was:

ERROR: Could not start patchelf.
ERROR: Make sure it is installed on your $PATH.
ERROR: Error reading rpath with patchelf "libQt5Widgets.so" : ""
ERROR: Error reading rpath with patchelf "libQt5Widgets.so" : ""

This error indicates that the required pathchelf tool is missing and can be solved by installing it directly:

sudo apt install patchelf

Then the following error occurred:

ERROR: ldd outputLine: "libjasper.so.1 => not found"
ERROR: for binary: "/home/xl/Qt5.9.2/5.9.2/gcc_64/plugins/imageformats/libqjp2.so"
ERROR: Please ensure that all libraries can be found by ldd. Aborting.

This shows that the libqjp2.so library is missing in our system. It's actually very strange. The local version can obviously be run, so why is this library file missing? But the solution is very simple, just install what is missing:

sudo add-apt-repository "deb http://security.ubuntu.com/ubuntu xenial-security main"
sudo apt update
sudo apt install libjasper1 libjasper-dev

After the installation is complete, it is packaged smoothly.

Summarize

The above is what I introduced to you about how to use linuxdeployqt to package Qt programs in Ubuntu. I hope it will be helpful to you. If you have any questions, please leave me a message and I will reply to you in time. I would also like to thank everyone for their support of the 123WORDPRESS.COM website!
If you find this article helpful, please feel free to reprint it and please indicate the source. Thank you!