Difference between revisions of "彩云天气 API 的版本策略"

From Caiyun Wiki
Jump to: navigation, search
 
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,此时该版本退出服务行列