Difference between revisions of "彩云天气 API 的版本策略"
| Line 1: | Line 1: | ||
彩云天气 API 的版本支持 [https://semver.org/spec/v2.0.0.html Semantic Versioning 2.0.0]。 | 彩云天气 API 的版本支持 [https://semver.org/spec/v2.0.0.html Semantic Versioning 2.0.0]。 | ||
| + | 一个版本的生命周期支持 alpha、beta、current、deprecated、unsupported 的状态变化。 | ||
[[Image:API Revision Lifecycle.jpeg|thumb|right|版本的生命周期]] | [[Image:API Revision Lifecycle.jpeg|thumb|right|版本的生命周期]] | ||
| + | |||
| + | ==示例== | ||
| + | |||
| + | v2.3 在开发阶段会有如下两个阶段 | ||
| + | |||
| + | * 版本号 v2.3-alpha，状态 alpha，此时该版本的特性和变更没有最终确定 | ||
| + | * 版本号 v2.3-beta，状态 beta，此时该版本的特性和变更最终确定，但仍需经过充分测试以达到稳定状态 | ||
| + | |||
| + | 正式上线后， | ||
| + | |||
| + | * 版本号 v2.3，状态 current，此时该版本为当前稳定版本，历史版本退出进入 deprecated 状态 | ||
| + | |||
| + | 当更新的版本 v2.4 上线后， | ||
| + | |||
| + | * 版本号 v2.3，状态 deprecated，此时该版本为不建议使用的状态 | ||
| + | |||
| + | 当该版本确定不再维护后 | ||
| + | |||
| + | * 版本号 v2.3，状态 unsupported，此时该版本退出服务行列 | ||
Latest revision as of 13:21, 12 October 2018
彩云天气 API 的版本支持 Semantic Versioning 2.0.0。
一个版本的生命周期支持 alpha、beta、current、deprecated、unsupported 的状态变化。
示例
v2.3 在开发阶段会有如下两个阶段
- 版本号 v2.3-alpha，状态 alpha，此时该版本的特性和变更没有最终确定
- 版本号 v2.3-beta，状态 beta，此时该版本的特性和变更最终确定，但仍需经过充分测试以达到稳定状态
正式上线后，
- 版本号 v2.3，状态 current，此时该版本为当前稳定版本，历史版本退出进入 deprecated 状态
当更新的版本 v2.4 上线后，
- 版本号 v2.3，状态 deprecated，此时该版本为不建议使用的状态
当该版本确定不再维护后
- 版本号 v2.3，状态 unsupported，此时该版本退出服务行列
