Files
ShowenV2/plugin-sdk
showen d30c111c71 feat: M1.1 完成 + M1.2 启动 — 全量更新
M1.1 收尾:
- 24项 P0/P1/P2 bug 修复 (Rust 107 tests + Flutter 15 tests)
- Flutter App v0.3: cupertino_icons 修复, 单元测试, 调试面板, APK 52.6MB
- 示例插件完善: manifest.json + 请求/响应示范 + 7个测试
- API 文档重写 (以 routes.rs 为唯一权威)
- MILESTONES.md 更新至 100%

M1.2 启动:
- P0: 插件管理 API 闭环 (handle_manager_message Custom 分支 + broadcast_plugin_states)
- ServiceManager 集成测试 8/8 (tests/m1_2_service_manager.rs)
- M1.2 测试计划 (docs/M1.2_TEST_PLAN.md, 18个E2E场景)
- 动态插件系统: auto_rollback + version_manager GC + 路径穿越防护

总计: Rust 115/115 测试, Flutter 15/15 测试, 零 warning

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 18:12:42 +08:00
..

ShowenV2 Plugin SDK

插件开发者使用此 SDK 编写动态插件(.so 文件),运行时由主程序动态加载。

核心接口

  • ShowenPlugin trait: 插件作者实现的高级接口init / start / handle_message / stop
  • MessageSender: 封装 FFI SendCallback插件通过它向主程序发送消息
  • export_plugin!: 自动生成 extern "C" 胶水代码,导出 PluginVTable

类型

SDK 独立定义了与主程序 JSON 兼容的消息类型:

  • PluginInfo, Envelope, Destination, Message

用法

use showen_plugin_sdk::{export_plugin, ShowenPlugin, MessageSender, PluginInfo, Message};

struct MyPlugin { sender: Option<MessageSender> }

impl ShowenPlugin for MyPlugin {
    fn info(&self) -> PluginInfo { /* ... */ }
    fn init(&mut self, config_json: &str, sender: MessageSender) -> Result<(), String> { Ok(()) }
    fn start(&mut self) -> Result<(), String> { Ok(()) }
    fn handle_message(&mut self, msg_json: &str) -> Result<(), String> { Ok(()) }
    fn stop(&mut self) -> Result<(), String> { Ok(()) }
}

export_plugin!(MyPlugin, MyPlugin::new);

编译

cd plugin-sdk
cargo build

插件项目在 Cargo.toml 中依赖此 SDK

[dependencies]
showen-plugin-sdk = { path = "../plugin-sdk" }