面向移动客户端的公共 API 版本化
· 10 分钟阅读
移动客户端无法每周发布；忽视这一点会打爆生产。
移动滞后是长期约束
应用商店与 MDM 意味着多代客户端并存。
最旧支持版本是一等消费者。
用契约承载版本
显式 API 纪元与每次请求的构建身份。
无度量废弃期不删字段。
- Publish a mobile compatibility matrix with minimum app versions per API epoch
- Treat breaking changes as contract events with sunset dates in responses
- Run shadow traffic from oldest supported app builds in CI
- Instrument version skew: which app builds hit deprecated fields
与发布和支持协同
下线与应用内升级配对。
CI 跑最旧 bundle 契约测试。
切断前测量偏斜
看板对比版本与纪元。
可预测的演进。
由 Berktug Berke Ates 于 2026年10月19日 发布。