cae_solver 插件模板(VDE 微内核 SDK 模板包)
纯 C ABI 最小 cae_solver 插件:CAE 求解器(
VdeCaeSolverPlugin:solve(host, model_data, model_size, params_json, result_json))。不加入 VDE 默认构建,独立 CMake 工程。
目录
| 文件 | 说明 |
|---|---|
cae_solver.cpp |
插件实现(vde_plugin_query / vde_plugin_init / vde_plugin_shutdown + 扩展点结构) |
vde-plugin.json |
清单:id/version/kind/abi/entry/capabilities(部署时与 DLL 同目录) |
CMakeLists.txt |
独立构建脚本(只依赖 include/vde/plugin/vde_plugin_api.h) |
README.md |
本文件 |
构建
cmake -S plugins/templates/cae_solver -B build/template_cae_solver \
-G Ninja -DCMAKE_BUILD_TYPE=Release \
-DVDE_SDK_DIR=<VDE 源码根目录或安装前缀>
cmake --build build/template_cae_solver
# 产物:build/template_cae_solver/plugin/{vde_template_cae.dll, vde-plugin.json}
VDE_SDK_DIR 指向 VDE 源码根或安装前缀(需有 include/vde/plugin/vde_plugin_api.h);不传时按模板在源码树中的相对位置自动推断。
自检(vde_plugin_tool)
<VDE>/build/.../vde_plugin_tool --check build/template_cae_solver/plugin
<VDE>/build/.../vde_plugin_tool --list build/template_cae_solver/plugin
--check 校验清单必填字段、kind/ABI 与插件 vde_plugin_query 一致性、ABI 与宿主兼容性、
artifacts SHA-256;--list 应识别本插件。
部署与加载
- 把
plugin/目录整体拷到宿主插件搜索路径(如<VDE 构建>/plugins/或安装前缀的lib/vde/plugins/com.example.vde.cae/); - 宿主
PluginManager:
auto& pm = vde::plugin::PluginManager::instance();
std::string error;
pm.add_search_path("<plugin-parent-dir>");
pm.scan_search_paths();
pm.load("com.example.vde.cae", &error);
// `pm.cae_solvers()` 查询、`pm.solve_cae(solver_id, model_data, size, params_json, &result)` 调用;
- 也可把模板拷进自己的插件工程,修改
id/entry/solver_id或strategy_id与实现逻辑。
实现要点
- 宿主服务:
body_from_serialized/body_query/body_bbox/body_destroy(模型经 VDE 序列化数据传入); - 输出缓冲区用
host->alloc分配,宿主free_buffer释放;失败返回负错误码 +host->set_error,不跨 C ABI 抛异常; vde_plugin_init按VdePluginRegistration.struct_size判断扩展点字段是否存在(旧宿主不识别时返回VDE_PLUGIN_ERR_UNSUPPORTED);- ABI 版本:
VDE_PLUGIN_ABI_MAJOR.MINOR = 1.3(manifestabi.minor=3); - 模板只演示契约,请把
solve/invoke替换为真实算法(真实实现可自行使用 JSON 库,但不得链接 VDE 内核库)。
下一步
- 用宿主
PluginManager加载/调用/卸载回归,检查失败隔离; - 在真实模型/草图上验证输入输出 JSON 约定;
- 如需签名/artifacts:清单声明
artifacts[{path,sha256}],--check会校验哈希。