Feathers:deprecation-policy

原文地址：http://wiki.starling-framework.org/feathers/deprecation-policy

Feathers的弃用方案

Feathers尚未有一个稳定的发布版本。直到稳定版本发布，APIs可能不经通告就被移除掉（会影响到多数开发人员的重要更改，就像removal of as3-signals in favor of Starling events，通常会在forums上通告）。在使用Feathers的时候，你要知道这只是原始或测试版的特性，同时你也有责任为它的发展而移植新的APIs进去。

1.0版之后，Feathers框架将会进入一个更稳定的状态。重要的API将不再经常改变，如果一个API被新的取代，那么新旧两个版本将会同时存在一段时间。旧的API会被明显地标志过时，并鼓励你尽快移植到新的API。

已经弃用的API将永远不会在Feathers中保留。目前，我计划保留一个弃用的API至少半年，或者在两个小幅修改的版本号上更新。但无论哪个都要用比较长的时间。

所以，如果我在1.1版本中弃用某些东西，它仍然和新的API同时存在于1.2版本中。它会在1.1和1.2版本中被清晰地标志为过时。在1.3版本中，只要1.1版本发布以来已经超过半年，那么弃用的API可能被移除掉。它将会在1.3版的发行说明上清晰地说明弃用的API已经被移除而且你必需移植到新的API。但如果当我发布1.3版本时还没到半年，我不会移除弃用的API直到下一个已经够半年时间的版本发布。

很多软件项目在弃用APIs上都站在过于保守的立场。那些APIs可能一直保留到下一个重大版本的更新，或者更长时间。我希望Feathers框架发展得更快，不让旧的版本成为累赘。我会避免在某一时刻完全破坏掉APIs，因为那会是每个人的痛，因此我才定下了“两个小幅修改版本或半年时间”这一规则。

接口

那些被移除的接口上的方法同样遵循上述定义的弃用规则。

有时候，新的方法可能需要添加到已存在的接口中。如果可能，新的接口会被包含进原始的接口以作扩展。但是，这样做并不会毫无意义，新的方法需要被添加到原始的接口上。很不幸的是，在这种情况下，升级到新版本会导致编译错误。为了轻缓地过渡到新的版本，新方法提供的默认实现将会尽可能接近地模仿旧方法的行为。请详细地查看发行说明。

重大版本

重大版本不会受以上的规则约束。如果有一个重大的Feathers框架发布将不会保证有弃用期。例如你从1.x升级到2.0。一些APIs可能不带警告地被移除或改名。

---

翻译者：陈文龙