Uso de bibliotecas de terceros

qmake le permite utilizar bibliotecas de terceros con Qt. Supongamos que conoce una biblioteca multiplataforma que acepta muestras de audio de los maullidos de un gato y las traduce a palabras en inglés. Esta biblioteca se llama CatWhisperer, y tiene varios archivos que proporciona como parte de su biblioteca. Su proyecto, MyQtApp, almacena estos archivos en una carpeta llamada 3rdparty:

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

Para utilizar la biblioteca CatWhisperer en MyQtApp, qmake necesita la ubicación y los nombres de las bibliotecas CatWhisperer. Opcionalmente, también puede

• Proporcionar la ubicación del código fuente de CatWhisperer para no tener que escribir la ruta completa de cada archivo cuando los incluya en su propio código.
• Elegir el destino en el que se creará el ejecutable MyQtApp.

La información anterior se proporciona en el archivo .pro, para que qmake pueda analizarla y producir makefiles. Los makefiles contienen toda la información que necesitan tu compilador y enlazador para producir la salida, ya sea un ejecutable, otro fichero de librería, etc. Las siguientes secciones explican la sintaxis con la que qmake espera que proporciones esta información.

Código fuente

Para poder escribir

#include <CatWhisperer.h>

en lugar de

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

puede proporcionar la ruta al directorio CatWhisperer include , utilizando la variable INCLUDEPATH:

INCLUDEPATH += 3rdparty/CatWhisperer/include

Archivos de biblioteca

Para que qmake sepa dónde encontrar los archivos de biblioteca de CatWhisperer, utilice la variable LIBS:

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

La primera parte de la expresión permite al enlazador saber en qué directorio debe buscar los archivos de biblioteca. Las comillas dobles sólo son necesarias cuando la ruta contiene espacios, por lo que podríamos haberlas omitido en este ejemplo.

La segunda parte indica al enlazador con qué bibliotecas debe enlazar. Tenemos dos ficheros de librerías diferentes para plataformas UNIX y Windows, respectivamente: libCatWhisperer.so y CatWhisperer.lib. No es necesario especificar la extensión .lib, ni el prefijo lib (en plataformas UNIX).

Directorio de destino

Por defecto, qmake crea el ejecutable en el mismo directorio que el archivo .pro. Podemos elegir nuestro propio directorio utilizando la variable DESTDIR:

DESTDIR = bin

¡Ya está! Ya puedes utilizar la librería CatWhisperer en tu proyecto. El archivo final .pro tiene este aspecto:

TARGET = MyQtApp

TEMPLATE = app

INCLUDEPATH += 3rdparty/CatWhisperer/include

SOURCES += src/main.cpp

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