qt_import_plugins

Legt eine benutzerdefinierte Auswahl an Plugins fest, die importiert oder ausgeschlossen werden sollen.

Der Befehl ist in der Komponente „ Core “ des Pakets „ Qt6 “ definiert, das wie folgt geladen werden kann:

find_package(Qt6 REQUIRED COMPONENTS Core)

Dieser Befehl wurde in Qt 5.14 eingeführt.

Übersicht

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

Wenn versionslose Befehle deaktiviert sind, verwenden Sie stattdessen „ qt6_import_plugins() “. Dieser Befehl unterstützt dieselben Argumente wie der vorliegende Befehl.

Beschreibung

Legt eine benutzerdefinierte Liste von zu importierenden Plugins fest. Die optionalen Argumente: ` INCLUDE`, ` EXCLUDE`, ` INCLUDE_BY_TYPE` und ` EXCLUDE_BY_TYPE` können mehrfach verwendet werden.

• INCLUDE – kann verwendet werden, um eine Liste der zu importierenden Plugins anzugeben.
• EXCLUDE – kann verwendet werden, um eine Liste der auszuschließenden Plugins anzugeben.
• INCLUDE_BY_TYPE – kann verwendet werden, um die Liste der zu importierenden Plugins für einen bestimmten Plugin-Typ zu überschreiben.
• EXCLUDE_BY_TYPE – kann verwendet werden, um einen auszuschließenden Plugin-Typ anzugeben; in diesem Fall werden keine Plugins dieses Typs importiert.
• NO_DEFAULT – Verhindert, dass die Standard-Plugins automatisch einbezogen werden (zum Beispiel das Standard-Plattform-Plugin).

Qt stellt Plugin-Typen wie „ imageformats “, „ platforms “ und „ sqldrivers “ zur Verfügung.

Dynamische Plugins

Wenn es sich bei den Plugins um dynamische Bibliotheken handelt, steuert die Funktion die Bereitstellung der Plugins. Mit dieser Funktion können Sie bestimmte Plugin-Typen vom Packen in eine Android-APK ausschließen, zum Beispiel:

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

Im obigen Codeausschnitt werden alle Plugins vom Typ „ imageformats “ bei der Bereitstellung von „ MyApp “ ausgeschlossen. Die resultierende Android-APK enthält keine der Plugins vom Typ „ imageformats “.

Wird der Befehl nicht verwendet, stellt das Ziel automatisch alle Plugins bereit, die zu den Qt-Modulen gehören, gegen die das Ziel verknüpft ist.

Statische Plugins

Wird der Befehl nicht verwendet, verknüpft das Ziel automatisch einen sinnvollen Satz an statischen Standard-Plugins für jedes Qt-Modul, mit dem das Ziel verknüpft ist. Weitere Informationen finden Sie unter target_link_libraries.

Jedes Plugin verfügt über eine C++-Stub-Datei, die das statische Plugin automatisch initialisiert. Folglich wird bei jedem Ziel, das mit einem Plugin verknüpft ist, diese C++-Datei zu seiner ` SOURCES` hinzugefügt.

Beispiele

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
)

Im obigen Codeausschnitt geschieht Folgendes mit der ausführbaren Datei „ myapp “:

• Die Datei „ Qt6::QCocoaIntegrationPlugin “ wird in „myapp“ importiert.
• Das Plugin „ Qt6::QMinimalIntegrationPlugin “ wird vom automatischen Import in „myapp“ ausgeschlossen.
• Die Standardliste der Plugins für „ imageformats “ wird überschrieben, sodass nur „ Qt6::QGifPlugin “ und „ Qt6::QJpegPlugin “ enthalten sind.
• Alle „ sqldrivers “-Plugins werden vom automatischen Import ausgeschlossen.