跳到主要内容

版本规范

提示

TabooLib 的版本号使用一种符合语义化版本(SemVer)规范的格式。

https://semver.org/

插件开发者在开发插件时会选择基于某个特定的 TabooLib 版本,比如 6.0.06.0.16.1.0。这如同使用 GuavaApache 这些类库一般,TabooLib 的版本更新并不会影响插件本身,且一个服务端中也可以同时存在多个不同版本的 TabooLib。但是 TabooLib 版本的变化直接反映了特性的增删与修改,也反映了插件在更新 TabooLib 版本时的受影响程度。

主版本号(MAJOR)

主版本号(X.Y.Z)的变化代表了 TabooLib 的当前框架和整体设计版本,以及 API 发生破坏性的更新。这可能会直接导致基于老 TabooLib 版本的插件无法在新版本上工作。数年进行一次迭代。

次版本号(MINOR)

次版本号 (X.Y.Z) 的变化代表了新 API 和特性的出现,同时基于有相同主版本号的旧版 TabooLib 开发的插件可以直接提升 TabooLib 依赖版本。举个例子,某个基于 TabooLib 6.0.0 开发的插件可以直接升级版本到 6.0.16.1.0,但是不能反过来操作。

修订版本(PATCH)

修订版本 (X.Y.Z) 的变化代表了某个漏洞修复、优化、配置变更或某些细微的 API 新增。若修订号是一个单独的数字,则该版本是一个推荐版本。这个版本的变更除了重大漏洞修复外不会发生任何推送,且可能频繁发生。

提示

高一级的版本号变化时,低一级的版本号会被重置为 0。比如,从 6.0.X 升级到 6.1.X 时,修订版本会被重置为 0,变成 6.1.0

特殊版本

6.1 开始, TabooLib 启用一种独特的版本标识。

发行版

所有发布在 Github Releases 上的版本均可直接使用。

开发版

每次提交都会向 仓库 推送当前发行版的 -dev 版本,如 6.1.0 的开发版本为 6.1.0-dev

警告

开发版有独特的加载模式,不可直接用于生产环境(详见 本地测试)`