了解 SDK 契约边界

公共契约源

SDK 定义 VISIONGO 应用之间的公共数据契约。C++ DTO 头文件由 JSON schema 生成，应用消费生成结果，不直接修改生成文件。

保持应用边界

应用通过公共契约与正式传输路径通信，不导入彼此私有源码目录、头文件或内部符号。

先变更契约

先修改契约源、重新生成绑定并完成兼容性检查，再更新生产者与消费者。新增字段优先使用 optional；破坏性变更需升级协议版本。

检查消费方

验证所有受影响的生产者和消费者，包括异常路径与旧版本对端。编译成功本身不能证明线上协议兼容。