qt_import_plugins

Синопсис

qt_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, могут использоваться более одного раза.

Эта команда CMake была добавлена в Qt 5.14.

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

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

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

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

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

Эта команда была добавлена в Qt 5.15. Вы можете использовать qt5_import_plugins в более старых версиях Qt.

Примеры

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

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

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