Utilisation de bibliothèques tierces

qmake vous permet d'utiliser des bibliothèques tierces avec Qt. Supposons que vous connaissiez une bibliothèque multiplateforme qui accepte des échantillons audio des miaulements d'un chat et les traduit en mots anglais. Cette bibliothèque s'appelle CatWhisperer, et possède plusieurs fichiers qu'elle fournit dans le cadre de sa bibliothèque. Votre projet, MyQtApp, stocke ces fichiers dans un dossier nommé 3rdparty:

• MyQtApp/
  • MyQtApp.pro
  • src/
    • main.cpp
  • 3rdparty/
    • CatWhisperer
      • include/
        • CatWhisperer.h
      • lib/
        • libCatWhisperer.so
        • CatWhisperer.lib
      • bin/
        • CatWhisperer.dll

Pour utiliser la bibliothèque CatWhisperer dans MyQtApp, qmake a besoin de l'emplacement et des noms des bibliothèques CatWhisperer. En option, vous pouvez également

• Fournir l'emplacement du code source de CatWhisperer afin que vous n'ayez pas à saisir le chemin complet de chaque fichier lorsque vous les incluez dans votre propre code.
• Choisir la destination dans laquelle l'exécutable MyQtApp sera créé.

Les informations ci-dessus sont fournies dans le fichier .pro, afin que qmake puisse les analyser et produire des Makefiles. Les Makefiles contiennent toutes les informations nécessaires à votre compilateur et à votre éditeur de liens pour produire un résultat, qu'il s'agisse d'un exécutable, d'un autre fichier de bibliothèque, etc. Les sections suivantes expliquent la syntaxe avec laquelle qmake s'attend à ce que vous fournissiez ces informations.

Code source

Pour pouvoir écrire

#include <CatWhisperer.h>

au lieu de

#include <3rdparty/CatWhisperer/include/CatWhisperer.h>

vous pouvez fournir le chemin d'accès au répertoire CatWhisperer include , en utilisant la variable INCLUDEPATH:

INCLUDEPATH += 3rdparty/CatWhisperer/include

Fichiers de bibliothèque

Pour indiquer à qmake où trouver les fichiers de la bibliothèque CatWhisperer, utilisez la variable LIBS:

LIBS += -L"3rdparty/CatWhisperer/lib" -lCatWhisperer

La première partie de l'expression indique à l'éditeur de liens dans quel répertoire il doit chercher les fichiers de la bibliothèque. Les guillemets doubles ne sont nécessaires que lorsque le chemin d'accès contient des espaces, nous aurions donc pu les omettre dans cet exemple.

La deuxième partie indique à l'éditeur de liens les bibliothèques avec lesquelles il doit effectuer l'édition de liens. Nous avons deux fichiers de bibliothèque différents pour les plates-formes UNIX et Windows, respectivement : libCatWhisperer.so et CatWhisperer.lib. Il n'est pas nécessaire de spécifier l'extension .lib, ni le préfixe lib (sur les plates-formes UNIX).

Répertoire de destination

Par défaut, qmake crée l'exécutable dans le même répertoire que le fichier .pro. Nous pouvons choisir notre propre répertoire en utilisant la variable DESTDIR:

DESTDIR = bin

Voilà, c'est fait ! Vous pouvez maintenant utiliser la bibliothèque CatWhisperer dans votre projet. Le fichier .pro final ressemble à ceci :

TARGET = MyQtApp

TEMPLATE = app

INCLUDEPATH += 3rdparty/CatWhisperer/include

SOURCES += src/main.cpp

LIBS += -L"3rdparty/CatWhisperer/lib" -lCatWhisperer