生态桌面应用

协议规范

平台、事件、绘制和配置协议的当前版本、协商与兼容规则。

言台与言界把 ABI、事件、绘制和可读配置分别版本化:

协议当前版本数据路径主版本规则
原生 ABI2函数、资源、回调和原生值必须精确匹配
平台协议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 决策