Verwendung von Bibliotheken von Drittanbietern

Mit qmake können Sie Bibliotheken von Drittanbietern mit Qt verwenden. Angenommen, Sie kennen eine plattformübergreifende Bibliothek, die Audio-Samples von Katzenmiauen akzeptiert und diese in englische Wörter übersetzt. Diese Bibliothek heißt „ CatWhisperer “ und umfasst mehrere Dateien, die als Teil der Bibliothek bereitgestellt werden. Ihr Projekt „ MyQtApp “ speichert diese Dateien in einem Ordner namens „ 3rdparty “:

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

Um die Bibliothek „ CatWhisperer “ in „ MyQtApp “ zu verwenden, benötigt „ qmake “ den Speicherort und die Namen der „ CatWhisperer “-Bibliotheken. Optional können Sie außerdem:

• Den Speicherort des CatWhisperer -Quellcodes angeben, damit Sie nicht den vollständigen Pfad zu jeder Datei eingeben müssen, wenn Sie diese in Ihren eigenen Code einbinden.
• das Zielverzeichnis auswählen, in dem die ausführbare Datei „ MyQtApp “ erstellt werden soll.

Die oben genannten Informationen werden in der Datei „ .pro “ bereitgestellt, damit „ qmake “ diese auswerten und Makefiles erstellen kann. Makefiles enthalten alle Informationen, die Ihr Compiler und Linker benötigen, um die Ausgabe zu erzeugen, sei es eine ausführbare Datei, eine weitere Bibliotheksdatei usw. In den folgenden Abschnitten wird die Syntax erläutert, in der „ qmake “ diese Informationen von Ihnen erwartet.

Quellcode

Um

#include <CatWhisperer.h>

anstelle von

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

, können Sie den Pfad zum Verzeichnis „ CatWhisperer “ von include mithilfe der Variablen INCLUDEPATH angeben:

INCLUDEPATH += 3rdparty/CatWhisperer/include

Bibliotheksdateien

Um dem „ qmake “ mitzuteilen, wo er die CatWhisperer -Bibliotheksdateien finden kann, verwenden Sie die Variable LIBS:

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

Der erste Teil des Ausdrucks teilt dem Linker mit, in welchem Verzeichnis er nach den Bibliotheksdateien suchen soll. Die doppelten Anführungszeichen sind nur erforderlich, wenn der Pfad Leerzeichen enthält; in diesem Beispiel hätten wir sie also weglassen können.

Der zweite Teil teilt dem Linker mit, welche Bibliotheken eingebunden werden sollen. Wir haben zwei verschiedene Bibliotheksdateien für UNIX-Plattformen bzw. Windows: „ libCatWhisperer.so “ und „ CatWhisperer.lib “. Es ist nicht erforderlich, die Erweiterung „ .lib “ oder das Präfix „ lib “ (auf UNIX-Plattformen) anzugeben.

Zielverzeichnis

Standardmäßig erstellt „ qmake “ die ausführbare Datei im selben Verzeichnis wie die Datei „ .pro “. Mit der Variablen „DESTDIR“ können wir ein eigenes Verzeichnis festlegen:

DESTDIR = bin

Das war’s schon! Sie können nun die Bibliothek „ CatWhisperer “ in Ihrem Projekt verwenden. Die endgültige „ .pro “-Datei sieht wie folgt aus:

TARGET = MyQtApp

TEMPLATE = app

INCLUDEPATH += 3rdparty/CatWhisperer/include

SOURCES += src/main.cpp

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