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.

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

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

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

Пример

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 исключены из автоматического импорта.