qt_import_plugins
Especifica un conjunto personalizado de complementos que se deben importar o excluir.
El comando se define 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 5.14.
Sinopsis
qt_import_plugins(target
[INCLUDE plugin ...]
[EXCLUDE plugin ...]
[INCLUDE_BY_TYPE plugin_type plugin ...]
[EXCLUDE_BY_TYPE plugin_type]
[NO_DEFAULT]
)Si los comandos sin versión están desactivados, utilice en su lugar qt6_import_plugins(). Admite el mismo conjunto de argumentos que este comando.
Descripción
Especifica un conjunto personalizado de complementos que se van a importar. Los argumentos opcionales: INCLUDE, EXCLUDE, INCLUDE_BY_TYPE y EXCLUDE_BY_TYPE, pueden utilizarse más de una vez.
INCLUDE– Se puede utilizar para especificar una lista de complementos que se van a importar.EXCLUDE– Se puede utilizar para especificar una lista de complementos que se deben excluir.INCLUDE_BY_TYPE– Se puede utilizar para anular la lista de complementos que se van a importar para un tipo de complemento concreto.EXCLUDE_BY_TYPE– Se puede utilizar para especificar un tipo de complemento que se debe excluir; en ese caso, no se importará ningún complemento de ese tipo.NO_DEFAULT– Evita que los complementos predeterminados se incluyan automáticamente (por ejemplo, el complemento predeterminado de la plataforma).
Qt proporciona tipos de complementos como imageformats, platforms y sqldrivers.
Complementos dinámicos
Si los complementos son bibliotecas dinámicas, la función controla su implementación. Mediante esta función, puedes excluir tipos específicos de complementos del empaquetado en un APK de Android, por ejemplo:
qt_add_executable(MyApp ...)
...
qt_import_plugins(MyApp EXCLUDE_BY_TYPE imageformats)En el fragmento de código anterior, todos los complementos del tipo imageformats se excluirán al implementar MyApp. El APK de Android resultante no contendrá ninguno de los complementos del tipo imageformats.
Si no se utiliza este comando, el objetivo implementa automáticamente todos los complementos que pertenecen a los módulos Qt a los que está vinculado el objetivo.
Complementos estáticos
Si no se utiliza el comando, el objetivo se vincula automáticamente a un conjunto adecuado de complementos estáticos predeterminados, para cada módulo Qt con el que esté vinculado el objetivo. Para obtener más información, consulta target_link_libraries.
Cada complemento incluye un archivo stub de C++ que inicializa automáticamente el complemento estático. Por consiguiente, a cualquier objetivo que se vincule con un complemento se le añade este archivo de C++ a su ` SOURCES`.
Ejemplos
qt_add_executable(myapp main.cpp)
target_link_libraries(myapp Qt6::Gui Qt6::Sql)
qt_import_plugins(myapp
INCLUDE Qt6::QCocoaIntegrationPlugin
EXCLUDE Qt6::QMinimalIntegrationPlugin
INCLUDE_BY_TYPE imageformats Qt6::QGifPlugin Qt6::QJpegPlugin
EXCLUDE_BY_TYPE sqldrivers
)En el fragmento de código anterior, ocurre lo siguiente con el ejecutable myapp:
- El `
Qt6::QCocoaIntegrationPlugin` se importa a `myapp`. - Se excluye la importación automática del complemento «
Qt6::QMinimalIntegrationPlugin» a «myapp». - La lista predeterminada de complementos de
imageformatsse anula para incluir únicamenteQt6::QGifPluginyQt6::QJpegPlugin. - Todos los complementos de
sqldriversquedan excluidos de la importación automática.
Véase también qt_import_qml_plugins().
© 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.