qt_add_plugin

创建 Qt 插件目标。

该命令在Qt6 软件包的Core 组件中定义，可以像这样加载：

find_package(Qt6 REQUIRED COMPONENTS Core)

该命令在 Qt 6.0 中引入。

简介

qt_add_plugin(target
              [SHARED | STATIC]
              [CLASS_NAME class_name]
              [OUTPUT_TARGETS variable_name]
              [MANUAL_FINALIZATION]
              sources...
)

MANUAL_FINALIZATION 选项和设置来源的功能在 Qt 6.5 中引入。

如果禁用了无版本命令，请使用qt6_add_plugin() 代替。它支持与本命令相同的参数集。

说明

Qt 插件目标比普通 CMake 库目标有更多要求。qt_add_plugin() 命令添加了必要的处理，以确保满足这些要求。在定义 Qt 插件目标时，应调用该命令而不是 CMake 内置的add_library() 命令。

默认情况下，如果 Qt 是静态构建的，插件将作为STATIC 库创建，否则将作为MODULE 库创建。您可以通过明确提供STATIC 或SHARED 选项来覆盖默认值。

所提供的任何sources 都将传递给add_library() 的内部调用。

每个 Qt 插件都有一个类名。默认情况下，该类名与target 相同，但可通过CLASS_NAME 选项进行重载。类名与声明插件元数据的 C++ 类名相对应。对于静态插件，它也是传递给Q_IMPORT_PLUGIN 的名称，后者将插件导入应用程序，并确保插件在运行时可用。

如果插件是静态构建的，qt_add_plugin() 可以定义额外的内部目标。这些目标可帮助链接到插件的任何可执行文件或共享库自动导入插件。如果项目安装了插件，并打算将其提供给其他项目链接，那么该项目也应安装这些内部目标。这些目标的名称可以通过提供OUTPUT_TARGETS 选项来获取，然后再提供返回目标列表的变量名称。

最终处理

创建目标后，可能需要进一步处理或最终确定步骤。最终处理由qt_finalize_target()命令执行。

有关详细信息和MANUAL_FINALIZATION 选项的含义，请参阅qt_add_library 的最终处理文档。