宿主边界
HyperCard SDK 的边界要一直守住:SDK 只负责拿数据渲染和提供编辑能力,业务系统负责业务判断。
SDK 不判断权限
比如“谁能看见某张图表的数据”,这不是 SDK 的事。
正确做法:
- 宿主业务服务判断权限。
- 宿主只把用户能看的数据传给组件。
- 组件按数据渲染。
SDK 不决定数据怎么请求
组件可以通过 __HYPERCARD__.libs.http 调业务接口,但接口本身、鉴权、缓存、错误处理都由宿主负责。
SDK 不内置属性面板
SDK 提供:
- 选中实例
- contract
CanvasHandledispatchupdateLayoutBox
宿主负责:
- 表单 UI
- 字段分组
- 校验提示
- 保存节奏
SDK 不内置组件库 UI
组件库可以是业务系统自己的产品能力。SDK 只要求拖到画布时能转成 PageInstance。
SDK 不绑定后端 schema
参考后端只是参考实现。真正业务项目可以用 Java、Go、Node、低代码平台自己的后端,只要最终能给 SDK 提供约定的数据结构。