qt_import_plugins

Синопсис

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

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

Описание

Указывает настраиваемый набор плагинов для импорта. Дополнительные аргументы: INCLUDE, EXCLUDE, INCLUDE_BY_TYPE, и EXCLUDE_BY_TYPE, могут использоваться более одного раза.

• INCLUDE — можно использовать для указания списка плагинов для импорта.
• EXCLUDE — можно использовать для указания списка плагинов для исключения.
• INCLUDE_BY_TYPE — можно использовать для переопределения списка плагинов для импорта для определенного типа плагина.
• EXCLUDE_BY_TYPE — можно использовать для указания типа плагина для исключения; тогда плагины этого типа не импортируются.

Qt предоставляет типы плагинов, такие как imageformats, platforms, и sqldrivers.

Если команда не используется, целевой объект автоматически подключается к разумному набору плагинов по умолчанию для каждого модуля Qt, к которому привязан целевой объект. Дополнительную информацию см. в target_link_libraries.

Каждый плагин поставляется с файлом заглушки C++, который автоматически инициализирует плагин. Следовательно, любой целевой объект, который подключается к плагину, имеет этот файл C++ в своей SOURCES.

Примечание: Эта команда импортирует плагины только из статических сборок Qt. При сборке с разделяемой библиотекой она ничего не делает.

Примеры

add_executable(myapp main.cpp)
target_link_libraries(myapp Qt5::Gui Qt5::Sql)
qt_import_plugins(myapp
    INCLUDE Qt5::QCocoaIntegrationPlugin
    EXCLUDE Qt5::QMinimalIntegrationPlugin
    INCLUDE_BY_TYPE imageformats Qt5::QGifPlugin Qt5::QJpegPlugin
    EXCLUDE_BY_TYPE sqldrivers
)

В приведенном фрагменте кода с исполняемым файлом myapp происходит следующее:

• Плагин Qt6::QCocoaIntegrationPlugin импортируется в myapp.
• Плагин Qt6::QMinimalIntegrationPlugin исключается из автоматического импорта в myapp.
• Список плагинов по умолчанию для imageformats переопределяется так, чтобы включать только Qt6::QGifPlugin и Qt6::QJpegPlugin.
• Все плагины sqldrivers исключаются из автоматического импорта.