本页用最短路径带你把 SDK 自带的 DemoPlugin 编译并加载进工具箱。
1. 前置条件
| 依赖 | 版本 | 说明 |
|---|---|---|
| Qt | 6.11.1（套件 6.11.1/mingw_64） | 必须与宿主完全一致 |
| 编译器 | MinGW-w64 GCC 13.1（x64, SEH） | 禁止 MSVC |
| CMake | >= 3.20 | 构建脚本 |
| Ninja | 任意较新版本 | 官方推荐生成器 |
2. SDK 目录结构
7AA7-Plugin-SDK/
include/ include
I7AA7PluginMeta.h +
I7AA7Plugin.h
I7AA7HostApi.h API
7AA7PluginMacros.h +
demo/ Demo
DemoPlugin.h
DemoPlugin.cpp
DemoPlugin.json
docs/
CMakeLists.txt Demo 3. 编译 Demo
在 SDK 根目录执行：
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release `
-DCMAKE_PREFIX_PATH="E:/Qt/6.11.1/mingw_64"
cmake --build build产物为 build/DemoPlugin.dll。
4. 加载与验证
重要：正式版客户端开启强制签名，本地未签名的 DLL 直接放进plugins/会被拒绝（SignatureInvalid）。联调请走插件工坊测试通道，或等待「开发者模式」开关（见编译规范第五章）。
加载成功后：
- 打开「系统 → 插件管理」，确认插件显示为已启用；
- 进入「功能分类 → 插件中心」，点击本插件的二级菜单，检查界面是否正常挂载；
- 若加载失败，点「查看日志」查看 PluginManager 写入的诊断日志，对照插件接口的错误码表定位原因。
5. 下一步
- 用你自己的类名、
pluginId、界面替换 Demo； - 阅读插件接口实现四个核心方法；
- 通过HostApi 参考接入配置、文件与网络能力；
- 上架前对照安全红线与签名与分发。