a2ui 0.9项目升级1.0,需要同时修改消息协议、catalog定义和客户端渲染器,不能只把版本字符串替换为1.0。先选择已经支持1.0的渲染器,再按官方迁移表调整字段,最后用创建界面、更新数据及用户操作的完整流程验证。

A2UI 0.9项目升级1.0的迁移方法
更新消息版本及MIME类型
流式JSON消息的version字段改为1.0,传输层MIME类型由application/json+a2ui改为application/a2ui+json。createSurface中的theme字段已移除,初始components、dataModel及metadata.extensions可直接放在创建消息中;不要继续依赖旧theme结构。

A2UI 0.9项目升级1.0的迁移方法
调整Catalog和组件元字段
Catalog定义需要明确protocolVersion为1.0,省略时按旧0.9处理。函数定义改为按函数名组织的对象。组件上的catalogId、metadata、accessibility和checks等协议混入字段改为@catalogId、@metadata、@accessibility和@checks,组件自身的id与component保持原名,不能将业务属性全部机械加上@。
按调用方向检查交互
检查客户端事件、双向函数调用及对应结果或错误返回。一个界面使用多个Catalog时,按组件的归属提供@catalogId,并确认客户端注册了相应实现。旧0.9消息与1.0消息不能未经适配混发。
完成后用同一业务数据检查界面创建、组件更新、数据绑定、按钮事件和错误处理。Jetpack Compose和Lynx等尚未支持1.0的实现,应保留对应旧协议路径,等待匹配版本后再迁移该客户端。











