生态桌面应用
协议规范
平台、事件、绘制和配置协议的当前版本、协商与兼容规则。
言台与言界把 ABI、事件、绘制和可读配置分别版本化:
| 协议 | 当前版本 | 数据路径 | 主版本规则 |
|---|---|---|---|
| 原生 ABI | 2 | 函数、资源、回调和原生值 | 必须精确匹配 |
| 平台协议 | 1.0 | 能力与平台原语 | 主版本不匹配拒绝 |
| 事件协议 | 1.1 | 一批言序典/列/基础值 | 主版本不匹配拒绝 |
| 绘制协议 | YXDR 1.1 | 小端版本化二进制完整帧 | 主版本不匹配拒绝 |
| 主题配置 | 1 | 言据优先、JSON 兼容 | 主版本不匹配拒绝 |
次版本兼容
- 典格式可以增加可选字段,旧消费者忽略未知字段;
- 事件协议可以增加名称,旧消费者忽略未知事件并继续处理批次;
- YXDR 可以增加操作码,旧后端按负载长度安全跳过;
- 新消费者不能假设旧生产者提供较新的可选字段;
- 不得复用已有字段或操作码表达另一种单位或语义。
安全上限
事件队列 4096;绘制帧 16 MiB、单命令 4 MiB、命令数 65536、状态栈 256;字体 64 MiB;图片单边 16384、解码分配 256 MiB。损坏长度、错误 UTF-8、非有限数字、非零填充和超限输入都返回稳定错误。
规范原文见事件协议、绘制协议与言据/JSON 决策。