qt_add_plugin
Crea un destino de complemento Qt.
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.0.
Sinopsis
qt_add_plugin(target
[SHARED | STATIC]
[CLASS_NAME class_name]
[OUTPUT_TARGETS variable_name]
[MANUAL_FINALIZATION]
sources...
)La opción « MANUAL_FINALIZATION » y la posibilidad de establecer fuentes se introdujeron en Qt 6.5.
Si los comandos sin versión están desactivados, utiliza qt6_add_plugin() en su lugar. Admite el mismo conjunto de argumentos que este comando.
Descripción
Los objetivos de complementos de Qt tienen requisitos adicionales respecto a un objetivo de biblioteca de CMake normal. El comando « qt_add_plugin() » añade el manejo necesario para garantizar que se cumplan estos requisitos. Debe utilizarse en lugar del comando integrado de CMake « add_library() » al definir un objetivo de complemento de Qt.
Por defecto, el complemento se creará como una biblioteca « STATIC » si Qt se ha compilado de forma estática, o como una biblioteca « MODULE » en caso contrario. Se puede anular este valor por defecto indicando explícitamente la opción « STATIC » o « SHARED ».
Cualquier sources que se proporcione se pasará a la llamada interna a add_library().
Nota: Los complementosno estáticos están pensados para cargarse dinámicamente en tiempo de ejecución, no para vincularse en tiempo de compilación. CMake distingue entre estos dos casos proporcionando el tipo de biblioteca « MODULE » para las bibliotecas cargadas dinámicamente, y el tipo de biblioteca « SHARED » para las bibliotecas a las que se puede vincular directamente. Esta distinción es importante para algunas cadenas de herramientas (en particular, Visual Studio), debido a la forma en que se gestionan las exportaciones de símbolos. Es posible que no se pueda vincular a bibliotecas MODULE, y generar una biblioteca SHARED sin símbolos exportados puede provocar errores en la fase de compilación. Si se pasa la opción SHARED a qt_add_plugin(), se creará, por lo tanto, una biblioteca MODULE en lugar de una biblioteca SHARED.
Cada complemento de Qt tiene un nombre de clase. Por defecto, este será el mismo que el de target, pero se puede sobrescribir con la opción CLASS_NAME. El nombre de la clase se corresponde con el nombre de la clase de C++ que declara los metadatos del complemento. En el caso de los complementos estáticos, también es el nombre que se pasa a ` Q_IMPORT_PLUGIN`, que importa el complemento a una aplicación y garantiza que esté disponible en tiempo de ejecución.
Si el complemento se compila de forma estática, ` qt_add_plugin() ` puede definir objetivos internos adicionales. Estos facilitan la importación automática del complemento para cualquier ejecutable o biblioteca compartida que se vincule a él. Si el proyecto instala el complemento y pretende que esté disponible para que otros proyectos se vinculen a él, el proyecto también debería instalar estos objetivos internos. Los nombres de estos objetivos se pueden obtener especificando la opción « OUTPUT_TARGETS », seguida del nombre de una variable en la que se devolverá la lista de objetivos.
Finalización
Una vez creado un objetivo, pueden ser necesarios pasos adicionales de procesamiento o finalización. El procesamiento de finalización se implementa mediante el comando `qt_finalize_target() `.
Para obtener más detalles y conocer el significado de la opción « MANUAL_FINALIZATION », consulte la documentación sobre finalización de qt_add_library.
Véase también qt_finalize_target() y qt_add_executable().
© 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.