qt_import_plugins

Especifica un conjunto personalizado de plugins para importar o excluir.

El comando está definido en el componente Core del paquete Qt6, que puede cargarse así:

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 versionless están deshabilitados, utilice qt6_import_plugins() en su lugar. Admite el mismo conjunto de argumentos que este comando.

Descripción

Especifica un conjunto personalizado de plugins para importar. Los argumentos opcionales: INCLUDE, EXCLUDE, INCLUDE_BY_TYPE, y EXCLUDE_BY_TYPE, pueden utilizarse más de una vez.

• INCLUDE - puede utilizarse para especificar una lista de plugins a importar.
• EXCLUDE - puede usarse para especificar una lista de plugins a excluir.
• INCLUDE_BY_TYPE - puede utilizarse para anular la lista de plugins a importar para un determinado tipo de plugin.
• EXCLUDE_BY_TYPE - puede usarse para especificar un tipo de plugin a excluir; entonces no se importarán plugins de ese tipo.
• NO_DEFAULT - evitar que los plugins por defecto se incluyan automáticamente (por ejemplo, el plugin por defecto de la plataforma).

Qt proporciona tipos de plugins como imageformats, platforms, y sqldrivers.

Plugins dinámicos

Si los plugins son bibliotecas dinámicas, la función controla el despliegue del plugin. Usando esta función, puedes excluir tipos específicos de plugins de ser empaquetados en un APK de Android, por ejemplo:

qt_add_executable(MyApp ...)
...
qt_import_plugins(MyApp EXCLUDE_BY_TYPE imageformats)

En el fragmento anterior, todos los plugins que tengan el tipo imageformats se excluirán al desplegar MyApp. El APK de Android resultante no contendrá ninguno de los plugins imageformats.

Si no se utiliza el comando, el objetivo despliega automáticamente todos los plugins que pertenecen a los módulos Qt con los que está enlazado el objetivo.

Plugins estáticos

Si no se usa el comando, el objetivo se enlaza automáticamente con un conjunto razonable de plugins estáticos por defecto, para cada módulo Qt con el que se enlaza el objetivo. Para más información, ver target_link_libraries.

Cada plugin viene con un archivo C++ stub que inicializa automáticamente el plugin estático. En consecuencia, cualquier objetivo que se enlace con un plugin tiene este archivo C++ añadido 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 anterior, ocurre lo siguiente con el ejecutable myapp:

• El Qt6::QCocoaIntegrationPlugin se importa en myapp.
• El plugin Qt6::QMinimalIntegrationPlugin es excluido de ser importado automáticamente en myapp.
• La lista por defecto de plugins para imageformats se anula para incluir sólo Qt6::QGifPlugin y Qt6::QJpegPlugin.
• Todos los plugins sqldrivers quedan excluidos de la importación automática.