api
core
查看 Markdown初始化 Kasumi 桥接、查询宿主能力并执行底层命令调用。
初始化 Kasumi 桥接、查询宿主能力并执行底层命令调用。
core 负责桥接生命周期与统一调用,不负责具体文件、窗口或系统能力。
业务模块应优先使用 KSM.fs、KSM.dialog 等领域入口;只有在领域封装尚未覆盖
已注册命令时,才使用 KSM.invoke()。
实现入口是 frontend/src/bridge/ksm.ts,请求总线位于
frontend/src/bridge/bus.ts。
| 方法 | 说明 |
|---|---|
| initialize | 创建桥接并安装传输层 |
| dispose | 销毁桥接并拒绝未完成请求 |
| ping | 验证前后端通路 |
| capabilities | 查询当前平台命令和权限 |
| invoke | 按协议命令名调用宿主 |
推荐顺序是初始化、查询能力、按业务需要监听事件、在页面卸载时销毁:
KSM.initialize();
try {
const capabilities = await KSM.capabilities();
console.info(capabilities.platform);
} finally {
KSM.dispose();
}initialize() 不会自动调用 ping() 或 capabilities()。重复初始化会先销毁旧总线,
所以初始化后应重新查询能力,并重新建立业务事件监听。
| 规范入口 | 等价入口 |
|---|---|
KSM.initialize(transport?) | KSM.init(transport?) |
KSM.dispose() | KSM.shutdown() |
KSM.capabilities() | KSM.get() |
别名不增加新的协议命令,方法页只在规范入口说明参数和边界。
initialize() 前调用模块方法会抛出不带错误码的普通 Error。dispose() 只销毁前端桥接,不关闭原生应用。capabilities() 有缓存,权限变化后不会自动失效。invoke() 不会为未知命令做本地契约校验,未知命令由宿主返回错误。
评论