发布周期
AdonisJS 是围绕以下内容构建的几个第一方包的集合 core of the framework,每当你听到我们提到 AdonisJS 版本时,假设我们正在谈论框架核心的版本。
像 @adonisjs/lucid
或 @adonisjs/mail
这样的每个包都有自己的独立版本,并且可以自由地拥有它们的发布周期。
语义化版本
我们严格遵循 语义版本控制,并在每次重大更改后升级主要版本。这意味着,今天的 AdonisJS 5 可以在几个月内迅速变成 AdonisJS 8。
- 我们将在发布 严重错误修复 时提升补丁版本(例如:5.2.0 到 5.2.1)。
- 次要版本包括 新功能 或 非关键错误修复。此外,我们还将在次要版本中弃用部分 API。(例如:5.2.0至5.3.0)
- 在发布突破性更改时,我们会升级主版本(例如:5.2.0 到 6.0.0)。
关于破坏性更改
随着AdonisJS的成熟,我们承担了更多的责任,不会时不时地引入破坏性更改,所有破坏性更改 都应该经历一个弃用和 RFC 阶段
在引入任何重大更改之前,我们将发布 RFC 讨论更改背后的动机。如果没有明显的阻力,我们将继续进行更改。
更改的初始阶段将在次要版本中弃用现有 API。在此更改后运行你的应用程序会收到许多警告,但不会中断并继续按原样工作。
在至少 4 周的降温阶段之后,我们将在下一个主要版本中移除不推荐使用的 API,并删除旧的的代码,对于确保框架代码库得到很好的维护而不是因为过去的变化而变得臃肿至关重要。
以下更改不受破坏性更改的影响。
- 未记录的 API 和内部数据结构 可以在任何版本中进行更改。因此,如果你依赖未记录的API或私有类成员,那么当我们更改或重组它们时,你只能靠自己。
- AdonisJS 的 Alpha 和下一个版本 可能会收到破坏性的更改,而不会出现重大的版本颠簸。这是因为我们希望根据我们在 Alpha 阶段的学习,快速迭代的创作自由。
发布周期
AdonisJS 的发布周期大致为 8 周,发布新特性或重大变更。然而,关键的错误修复和安全补丁通常会立即发布。
你可以查看我们的 Trello 路线图 和 下一个版本中有什么 了解即将发生的变化。
本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。