93 lines
2.3 KiB
C
93 lines
2.3 KiB
C
|
#pragma once
|
|||
|
|
|
|||
|
|
#include <types/base/types.h>
|
|||
|
|
#include <string>
|
|||
|
|
#include <vector>
|
|||
|
|
|
|||
|
|
namespace extra2d {
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 插件信息结构
|
|||
|
|
*/
|
|||
|
|
struct PluginInfo {
|
|||
|
|
std::string name; // 插件名称
|
|||
|
|
std::string version; // 版本号
|
|||
|
|
std::string author; // 作者
|
|||
|
|
std::string description; // 描述
|
|||
|
|
std::vector<std::string> dependencies; // 依赖的插件名称列表
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 插件接口 - 基于事件总线
|
|||
|
|
*
|
|||
|
|
* 插件是动态加载的扩展组件，可以在运行时加载/卸载
|
|||
|
|
* 插件通过事件总线与其他组件通信，零直接依赖
|
|||
|
|
*
|
|||
|
|
* 设计理念：
|
|||
|
|
* - 插件可以在运行时动态加载（动态库）或静态链接
|
|||
|
|
* - 插件之间可以声明依赖关系
|
|||
|
|
* - 插件通过事件总线发送和接收消息
|
|||
|
|
*/
|
|||
|
|
class IPlugin {
|
|||
|
|
public:
|
|||
|
|
virtual ~IPlugin() = default;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取插件信息
|
|||
|
|
* @return 插件信息结构
|
|||
|
|
*/
|
|||
|
|
virtual const PluginInfo& getInfo() const = 0;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 加载插件
|
|||
|
|
*
|
|||
|
|
* 在此注册事件监听器
|
|||
|
|
* 返回 false 表示加载失败
|
|||
|
|
*
|
|||
|
|
* @return 加载是否成功
|
|||
|
|
*/
|
|||
|
|
virtual bool load() { return true; }
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 卸载插件
|
|||
|
|
*
|
|||
|
|
* 在此执行清理工作
|
|||
|
|
* 事件监听器会自动注销（RAII）
|
|||
|
|
*/
|
|||
|
|
virtual void unload() {}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取依赖的插件列表
|
|||
|
|
* @return 依赖的插件名称列表
|
|||
|
|
*/
|
|||
|
|
virtual std::vector<std::string> getDependencies() const {
|
|||
|
|
return getInfo().dependencies;
|
|||
|
|
}
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
} // namespace extra2d
|
|||
|
|
|
|||
|
|
// ============================================================================
|
|||
|
|
// 插件导出宏（用于动态库插件）
|
|||
|
|
// ============================================================================
|
|||
|
|
|
|||
|
|
#ifdef _WIN32
|
|||
|
|
#define EXTRA2D_PLUGIN_EXPORT extern "C" __declspec(dllexport)
|
|||
|
|
#else
|
|||
|
|
#define EXTRA2D_PLUGIN_EXPORT extern "C" __attribute__((visibility("default")))
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 定义插件导出接口
|
|||
|
|
*
|
|||
|
|
* 在插件动态库中使用：
|
|||
|
|
* EXTRA2D_DEFINE_PLUGIN(MyPluginClass)
|
|||
|
|
*/
|
|||
|
|
#define EXTRA2D_DEFINE_PLUGIN(PluginClass) \
|
|||
|
|
EXTRA2D_PLUGIN_EXPORT extra2d::IPlugin* extra2d_create_plugin() { \
|
|||
|
|
return new PluginClass(); \
|
|||
|
|
} \
|
|||
|
|
EXTRA2D_PLUGIN_EXPORT void extra2d_destroy_plugin(extra2d::IPlugin* plugin) { \
|
|||
|
|
delete plugin; \
|
|||
|
|
}
|