Installation

Framework & IDE

Cette installation provoque le téléchargement de plusieures centaines de Mo (~200Mo) depuis internet ⇒ Soyez patients ! 😉.

Sur OpenSUSE

Depuis YaST, installer les différents constituants (packages) du framework Qt :

  • libqt5-creator

  • libqt5-qtbase-devel

  • libqt5-qtdoc

  • libqt5-qtserialport-devel

  • libqt5-qtserialport-examples

Sur Raspberry Pi OS

Depuis la ligne de commande :

Raspberry Pi OS version Buster
sudo apt-get update ; sudo apt-get install qt5-default qtcreator
Raspberry Pi OS version Bullseye
sudo apt-get update ; sudo apt-get install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools qtcreator

Module Qt MQTT

Sur Raspberry Pi OS

$ sudo apt-get install qtbase5-private-dev (1)
$ sudo apt-get install cmake
$ qmake --version (2)
QMake version 3.1
Using Qt version 5.11.3 in /usr/lib/arm-linux-gnueabihf
$ git clone https://code.qt.io/cgit/qt/qtmqtt.git --branch 5.11.2 (3)
$ cd qtmqtt (4)
$ qmake (4)
$ make (4)
$ sudo make install (4)
1 package indispensable pour avoir accès au fichier qobject_p.h requis lors de la compilation du module qtmqtt
2 récupère la version de Qt installée (ici 5.11.3)
3 clone les sources du module qtmqtt dans la version la plus proche de la version du framework Qt installé (se rendre par exemple sur https://code.qt.io/cgit/qt/qtmqtt.git/ pour lister les versions disponibles)
4 compile et installe le module

🕮 Sources :


Magré le signalement d’erreurs de dépendances lors de l’ouverture du fichier .pro du module qtmqtt, sa compilation depuis Qt Creator est également possible.

qtmqtt pro errors

Sur OpenSUSE

La procédure est sensiblement équivalente à celle pour Raspberry Pi OS. Seuls certains noms de packages et d’exécutables diffèrent.

Se rendre sur pkgs.org link pour une correspondance des noms de packages selon la distribution Linux utilisée.

$ sudo zypper install libqt5-qtbase-private-headers-devel (1)
$ sudo zypper install cmake
$ qmake-qt5 --version (2)
QMake version 3.1
Using Qt version 5.12.7 in /usr/lib64
$ git clone https://code.qt.io/cgit/qt/qtmqtt.git --branch 5.12.7 (3)
$ cd qtmqtt (4)
$ qmake-qt5 (4)
$ make (4)
$ sudo make install (4)
1 package indispensable pour avoir accès au fichier qobject_p.h requis lors de la compilation du module qtmqtt
2 récupère la version de Qt installée (ici 5.12.7)
3 clone les sources du module qtmqtt dans la version la plus proche de la version du framework Qt installé (se rendre par exemple sur https://code.qt.io/cgit/qt/qtmqtt.git/ pour lister les versions disponibles)
4 compile et installe le module

Sur Windows

  1. Installer les pré-requis :

    • git

    • perl

    Ces logiciels sont installables avec le gestionnaire de package chocolatey link :

    PS:1> choco install git
    [...]
    PS:2> choco install strawberryperl
    [...]
    PS:3> choco list --local-only
    Chocolatey v0.10.15
    [...]
    git 2.23.0
    git.install 2.23.0
    [...]
    strawberryperl 5.32.1.1
    [...]
  2. Lancer le terminal paramétré pour Qt

    qt console windows
  3. S’assurer que git et perl sont accessibles depuis le terminal Qt.

    Dans le cas contraire, ajouter leur chemin à la variable d’environnement PATH de Windows puis relancer le terminal Qt pour prendre en compte la modification.

  4. Cloner le dépôt contenant le module QtMqtt en utilisant git dans le répertoire de votre choix :

    C:\bin\Qt\5.14.2\mingw73_64> cd c:\Users\claud\Downloads
    
    C:\Users\claud\Downloads> git clone https://code.qt.io/cgit/qt/qtmqtt.git
    Cloning into 'qtmqtt'...
  5. Basculer sur la version du module QtMqtt en rapport avec le framework Qt installé sur la machine.

    Exemple : On voit dans le prompt du terminal Qt que c’est la version 5.14.2 de Qt qui est installé ⇒ on va basculer sur la version 5.14.2 (ou antérieure si non disponible) du module QtMqtt présent dans le dépôt git local.

    c:\Users\claud\Downloads\qtmqtt> git tag -l (1)
    [...]
    v5.14.0-beta3
    v5.14.0-rc1
    v5.14.0-rc2
    v5.14.1
    v5.14.2
    v5.15.0
    v5.15.0-alpha1
    [...]
    c:\Users\claud\Downloads\qtmqtt>git checkout tags/v5.14.2 (2)
    Note: switching to 'tags/v5.14.2'.
    [...]
    1 Liste les versions existantes dans le dépôt git
    2 Bascule sur la version spécifiée
  6. Lancer la génération du module QtMqtt

    c:\Users\claud\Downloads\qtmqtt>mingw32-make

    Si des erreurs de compilation se produisent, tenter de lancer les 2 commandes suivantes avant de relancer le processus de compilation avec mingw32-make :

    c:\Users\claud\Downloads\qtmqtt> qmake -r
    c:\Users\claud\Downloads\qtmqtt> qmake
  7. Installer le module dans Qt :

    c:\Users\claud\Downloads\qtmqtt>mingw32-make install
  8. S’assurer que le module compilé et ses fichiers d’entête sont présents dans le répertoire d’installation de Qt :

    • Qt5Mqtt.dllC:\bin\Qt\5.14.2\mingw73_64\bin\

    • qmqtt*.hC:\bin\Qt\5.14.2\mingw73_64\include\QtMqtt\

🞄  🞄  🞄