[SOLVED] Problems with setting paths to libs and plugins in Qt app's executable file

  • Hello,

    I would like to run my Qt application (let's call it "MyApp") on Ubuntu without Qt installed by putting folders with all necessary Qt libs and plugins in the same directory with the executable file. My app's directory looks like this:

    ├── lib
    ├── plugins
    ├── qml
    └── MyApp*

    While testing the app, I was using a simple bash script to change variables with paths and run the executable file with these new values. The script was like this:

    export LD_LIBRARY_PATH=`pwd`/lib
    export QT_PLUGIN_PATH=`pwd`/plugins
    export QML2_IMPORT_PATH=`pwd`/qml

    With the script I was able to run the app on Ubuntu without Qt, but now I would like to do this directly from the executable file, without any scripts. So, I've added to recourses of my app a qt.conf file:


    I've build the app with this file included and when I tried to run it on Ubuntu WITH Qt installed I've got an error:

    This application failed to start because it could not find or load the Qt platform plugin "xcb".
    Reinstalling the application may fix this problem.

    So, I've put the new executable file to the folder with lib, plugins and qml subdirectories and tried to run it from there - everything was working good just as I expected. But when I try to run this executable file with all necessary subdirs on Ubuntu WITHOUT Qt, I was still getting the error message about xcb plugin. I've also tried putting qt.conf in the same folder with executable, but it haven't helped me.

    So, why Qt app sees libs and plugin by paths from qt.conf on Ubuntu with Qt, but doesn't do it on Ubuntu without it? Thanks in advance for your answers!

  • Hi, the reason your Qt app is able to load the "xcb" plugin on a PC with Qt installed, is that there is a hardwired path to the plugins (written by the installer) in your libQt5Core.so.5.5.0 file.
    There are 7 different ways for Qt to load the plugins (I've written more about it here but in almost all cases the libqxcb.so file needs to be in a subdirectory called platforms for Qt to be happy. You can change the name/place of the directory above it, as you do in your qt.conf file, but the name "platforms" is pretty hardwired :-)

  • @hskoglund Thank your for your answer. The problem is that I already have libqxcb.so in a folder called "platforms" (path is "MyApp/plugins/platforms/"). Here is full information about all subdirs:

    ├── lib
    │   ├── libicudata.so.54
    │   ├── libicui18n.so.54
    │   ├── libicuuc.so.54
    │   ├── libqgsttools_p.so.1
    │   ├── libQt5Core.so.5
    │   ├── libQt5DBus.so.5
    │   ├── libQt5Gui.so.5
    │   ├── libQt5Multimedia.so.5
    │   ├── libQt5MultimediaWidgets.so.5
    │   ├── libQt5Network.so.5
    │   ├── libQt5Qml.so.5
    │   ├── libQt5Quick.so.5
    │   ├── libQt5Widgets.so.5
    │   └── libQt5XcbQpa.so.5
    ├── plugins
    │   ├── imageformats
    │   │   └── libqjpeg.so
    │   ├── mediaservice
    │   │   └── libgstmediaplayer.so
    │   ├── platforms
    │   │   ├── libqlinuxfb.so
    │   │   ├── libqminimal.so
    │   │   ├── libqoffscreen.so
    │   │   └── libqxcb.so
    │   └── xcbglintegrations
    │       └── libqxcb-glx-integration.so
    ├── qml
    │   ├── QtQuick
    │   │   └── Window.2
    │   │       ├── libwindowplugin.so
    │   │       ├── plugins.qmltypes
    │   │       └── qmldir
    │   └── QtQuick.2
    │       ├── libqtquick2plugin.so
    │       ├── plugins.qmltypes
    │       └── qmldir
    └── MyApp

    I've also made some experiments with this bash run script:

    export LD_LIBRARY_PATH=`pwd`/lib
    export QT_PLUGIN_PATH=`pwd`/plugins
    export QML2_IMPORT_PATH=`pwd`/qml

    I was trying to run MyApp executable file built including qt.conf with this script and everything was running well. Then I started deleting different lines from the script to discover, which subdir executable cannot find. So, I received "xml" error only when I deleted this line:

    export LD_LIBRARY_PATH=`pwd`/lib

    And executable was running well with script, containing only this lines:

    export LD_LIBRARY_PATH=`pwd`/lib

    So without the run script executable can successfully load plugins and qml subdirs. It only cannot load libs from lib subdir without script's "help". How can I solve this problem?

  • Moderators

    Hi @Eyeless,

    Using a bash script, qt.conf, and custom subfolders seems a bit overcomplicated. Why not follow the tutorial in @hskoglund's blog? using RPATH only requires one extra line in your .pro file.

  • Indeed RPATH is exactly what the doctor ordered!
    So in your case, to test, you could type:
    chrpath -r \$ORIGIN/lib VeniceClassicRadioPlayer

    Note: my blog is not yet updated for Qt 5.5. At least 2 errors: the path setting hardwired into Qt5Core.so is now called qt_prfxpath e.g. "qt_prfxpath=/home/henry/Qt/5.5/gcc_64" and my "grapefruit" stunt doesn't work anymore, i.e. in 5.5 Qt pays attention to the chrpath setting in libqxcb.so.

    Edit: forgot, as JKSH suggests, try adding a line to your .pro file, like this:
    QMAKE_LFLAGS += -Wl,-rpath,"'$$ORIGIN/lib'"

  • @JKSH, @hskoglund, thank you very much! Using both qt.conf file and "QMAKE_LFLAGS += -Wl,--rpath=\$$ORIGIN/lib" line in my app's .pro file helped me.