En esta página

qt_add_library

Crea y libera una biblioteca.

El comando está definido en el componente « Core » del paquete « Qt6 », que se puede cargar de la siguiente manera:

find_package(Qt6 REQUIRED COMPONENTS Core)

Este comando se introdujo en Qt 6.2.

Sinopsis

qt_add_library(target
    [STATIC | SHARED | MODULE | INTERFACE | OBJECT]
    [MANUAL_FINALIZATION]
    sources...
)

Si los comandos sin versión están desactivados, utiliza en su lugar « qt6_add_library() ». Admite el mismo conjunto de argumentos que este comando.

Descripción

qt_add_library() es una envoltura del comando integrado de CMake « add_library() ». Realiza las siguientes tareas:

  • Crea un objetivo de CMake del tipo de biblioteca adecuado.
  • Se encarga de la finalización del objetivo de CMake.

Creación del objetivo

El tipo de biblioteca que se crea se puede especificar explícitamente con una de las palabras clave STATIC, SHARED, MODULE, INTERFACE o OBJECT, tal y como se haría con add_library(). Si no se especifica ninguna de estas palabras clave, el tipo de biblioteca que se cree dependerá de cómo se haya compilado Qt. Si Qt se ha compilado de forma estática, se creará una biblioteca estática. En caso contrario, se creará una biblioteca compartida. Tenga en cuenta que esto difiere del funcionamiento del comando « add_library() » de CMake, en el que la variable « BUILD_SHARED_LIBS » controla el tipo de biblioteca que se crea. Desde la versión 6.7, el comando « qt_add_library() » tiene en cuenta « BUILD_SHARED_LIBS » a la hora de decidir el tipo de biblioteca únicamente si la variable se establece explícitamente y QTP0003 se configura en « NEW ».

Cualquier sources que se facilite se pasará a la llamada interna a add_library().

Finalización

Una vez creado un objetivo, puede ser necesario realizar pasos adicionales de procesamiento o finalización. El procesamiento de finalización se lleva a cabo mediante el comando qt_finalize_target().

La finalización puede tener lugar como parte de esta llamada o aplazarse hasta un momento posterior a la ejecución de este comando (aunque debe seguir estando dentro del mismo ámbito de directorio). Cuando se utiliza CMake 3.19 o posterior, la finalización se aplaza automáticamente hasta el final del ámbito del directorio actual. Esto ofrece al autor de la llamada la oportunidad de modificar las propiedades del objetivo creado antes de que se finalice. Cuando se utilizan versiones de CMake anteriores a la 3.19, no se admite el aplazamiento automático. En ese caso, la finalización se lleva a cabo inmediatamente antes de que este comando devuelva un resultado.

Independientemente de la versión de CMake, se puede especificar la palabra clave « MANUAL_FINALIZATION » para indicar que llamarás explícitamente a `qt_finalize_target() ` tú mismo en un momento posterior. En general, ` MANUAL_FINALIZATION ` no debería ser necesario a menos que el proyecto tenga que ser compatible con CMake 3.18 o versiones anteriores.

Véase también qt_finalize_target(), qt_add_executable() y QTP0003.

© 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.