En esta página

Uso de bibliotecas de terceros

qmake te permite utilizar bibliotecas de terceros con Qt. Supongamos que conoces una biblioteca multiplataforma que acepta muestras de audio de maullidos de gato y los traduce a palabras en inglés. Esta biblioteca se llama CatWhisperer y cuenta con varios archivos que proporciona como parte de su biblioteca. Tu 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, es necesario indicar la ubicación y los nombres de las bibliotecas CatWhisperer. Opcionalmente, también puedes:

  • Indicar la ubicación del código fuente de CatWhisperer para no tener que escribir la ruta completa de cada archivo al incluirlos en tu propio código.
  • Elegir la ubicación en la que se creará el ejecutable MyQtApp.

La información anterior se proporciona en el archivo « .pro », para que « qmake » pueda analizarla y generar archivos «makefile». Los archivos «makefile» contienen toda la información que necesitan el compilador y el enlazador para generar el resultado, ya sea un ejecutable, otro archivo de biblioteca, etc. En las siguientes secciones se explica 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>

puedes indicar la ruta al directorio CatWhisperer include utilizando la variable INCLUDEPATH:

INCLUDEPATH += 3rdparty/CatWhisperer/include

Archivos de biblioteca

Para indicar a qmake dónde encontrar los archivos de biblioteca de CatWhisperer, utiliza la variable LIBS:

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

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

La segunda parte indica al enlazador qué bibliotecas debe enlazar. Disponemos de dos archivos de biblioteca diferentes para las 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

¡Y ya está! Ahora ya puedes utilizar la biblioteca CatWhisperer en tu proyecto. El archivo .pro final tiene este aspecto:

TARGET = MyQtApp

TEMPLATE = app

INCLUDEPATH += 3rdparty/CatWhisperer/include

SOURCES += src/main.cpp

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

Véase también Qt Creator: Añadir bibliotecas a proyectos qmake.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.