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

From CaiyunWiki
Jump to: navigation, search
 
(3 intermediate revisions by the same user not shown)
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]。
  
<graphviz renderer="dot" caption="Revision Status Transition" format="png">
+
一个版本的生命周期支持 alpha、beta、current、deprecated、unsupported 的状态变化。
 +
[[Image:API Revision Lifecycle.jpeg|thumb|right|版本的生命周期]]
  
digraph status {
+
==示例==
  
  alpha -> beta [label=finalize];
+
v2.3 在开发阶段会有如下两个阶段
  beta -> current [label=test];
 
  current -> deprecated [label=deprecate];
 
  deprecated -> unsupported [label=discard];
 
  
}
+
* 版本号 v2.3-alpha,状态 alpha,此时该版本的特性和变更没有最终确定
 +
* 版本号 v2.3-beta,状态 beta,此时该版本的特性和变更最终确定,但仍需经过充分测试以达到稳定状态
  
</graphviz>
+
正式上线后,
 +
 
 +
* 版本号 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,此时该版本退出服务行列