qt_import_plugins

Указывает настраиваемый набор плагинов для импорта при статической сборке Qt.

Команда определена в компоненте Core пакета Qt6. Загрузите пакет с помощью:

find_package(Qt6 COMPONENTS Core REQUIRED)

Краткое описание

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

Если команды без версии отключены, используйте qt6_import_plugins() вместо этого. Она поддерживает тот же набор аргументов, что и эта команда.

Описание

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

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

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

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

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

Примеры

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 Qt::QGifPlugin Qt::QJpegPlugin
    EXCLUDE_BY_TYPE sqldrivers
)

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

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

См. также qt_import_qml_plugins().