qt5_import_plugins

Резюме

qt5_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 6 команда также доступна под именем qt_import_plugins.

Примеры

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

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

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