qt_import_plugins

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

La commande est définie dans le composant « Core » du paquet « 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 plutôt qt6_import_plugins(). Elle prend en charge le même ensemble d'arguments que cette commande.

Description

Spécifie un ensemble personnalisé de plugins à importer. Les arguments facultatifs : 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 ; dans ce cas, aucun plugin de ce type n’est importé.
• NO_DEFAULT – empêche l’inclusion automatique des plugins par défaut (par exemple, le plugin de plateforme par défaut).

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

Plug-ins dynamiques

Si les plugins sont des bibliothèques dynamiques, cette fonction contrôle leur déploiement. Elle permet d’exclure certains types de plugins du package APK Android, par exemple :

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

Dans l'extrait de code 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 de type imageformats.

Si cette commande n’est pas utilisée, la cible déploie automatiquement tous les plugins appartenant aux modules Qt auxquels elle est liée.

Plug-ins statiques

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

Chaque plugin est fourni avec un fichier stub C++ qui initialise automatiquement le plugin statique. Par conséquent, toute cible liée à un plugin voit ce fichier C++ ajouté à son fichier ` 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 de code ci-dessus, voici ce qui se produit avec l’ myapp de l’exécutable :

• L’ 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 n'inclure que Qt6::QGifPlugin et Qt6::QJpegPlugin.
• Tous les plugins d'sqldrivers sont exclus de l'importation automatique.