# 面向移动客户端的公共 API 版本化

移动客户端无法每周发布；忽视这一点会打爆生产。

Published: 2026-10-19

## 移动滞后是长期约束

应用商店与 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 契约测试。

## 切断前测量偏斜

看板对比版本与纪元。

可预测的演进。