qt_import_plugins

Spécifie un ensemble personnalisé de plugins à importer ou à exclure.

La commande est définie dans le composant Core du paquetage Qt6, qui peut être chargé comme suit :

find_package(Qt6 REQUIRED COMPONENTS Core)

Cette commande a été introduite dans Qt 5.14.

Synopsis

qt_import_plugins(target
                  [INCLUDE plugin ...]
                  [EXCLUDE plugin ...]
                  [INCLUDE_BY_TYPE plugin_type plugin ...]
                  [EXCLUDE_BY_TYPE plugin_type]
                  [NO_DEFAULT]
)

Si les commandes sans version sont désactivées, utilisez qt6_import_plugins() à la place. Il prend en charge le même ensemble d'arguments que cette commande.

Description de la commande

Spécifie un ensemble personnalisé de plugins à importer. Les arguments optionnels : INCLUDE, EXCLUDE, INCLUDE_BY_TYPE, et EXCLUDE_BY_TYPE, peuvent être utilisés plusieurs fois.

• INCLUDE - peut être utilisé pour spécifier une liste de plugins à importer.
• EXCLUDE - peut être utilisé pour spécifier une liste de plugins à exclure.
• INCLUDE_BY_TYPE - peut être utilisé pour remplacer la liste des plugins à importer pour un certain type de plugin.
• EXCLUDE_BY_TYPE - peut être utilisé pour spécifier un type de plugin à exclure ; aucun plugin de ce type n'est alors importé.
• NO_DEFAULT - empêche les plugins par défaut d'être inclus automatiquement (par exemple, le plugin de plate-forme par défaut).

Qt fournit des types de greffons tels que imageformats, platforms, et sqldrivers.

Plugins dynamiques

Si les plugins sont des bibliothèques dynamiques, la fonction contrôle le déploiement du plugin. Grâce à cette fonction, vous pouvez exclure certains types de plugins de l'emballage d'un APK Android, par exemple :

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

Dans l'extrait ci-dessus, tous les plugins de type imageformats seront exclus lors du déploiement de MyApp. L'APK Android résultant ne contiendra aucun des plugins imageformats.

Si la commande n'est pas utilisée, la cible déploie automatiquement tous les plugins qui appartiennent aux modules Qt auxquels la cible est liée.

Plugins statiques

Si la commande n'est pas utilisée, la cible se lie automatiquement à un ensemble de plugins statiques par défaut, pour chaque module Qt auquel la cible est liée. Pour plus d'informations, voir target_link_libraries.

Chaque greffon est accompagné d'un fichier stub C++ qui initialise automatiquement le greffon statique. Par conséquent, toute cible liée à un greffon a ce fichier C++ ajouté à son site SOURCES.

Exemples

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
)

Dans l'extrait ci-dessus, ce qui suit se produit avec l'exécutable myapp:

• Le fichier Qt6::QCocoaIntegrationPlugin est importé dans myapp.
• Le plugin Qt6::QMinimalIntegrationPlugin est exclu de l'importation automatique dans myapp.
• La liste par défaut des plugins pour imageformats est remplacée pour inclure uniquement Qt6::QGifPlugin et Qt6::QJpegPlugin.
• Tous les plugins sqldrivers sont exclus de l'importation automatique.