跳到主要内容

版本规范

提示

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

https://semver.org/

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

主版本号(MAJOR)​

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

次版本号(MINOR)​

次版本号 (X.Y.Z) 的变化代表了新 API 和特性的出现,同时基于有相同主版本号的旧版 TabooLib 开发的插件可以直接提升 TabooLib 依赖版本。举个例子,某个基于 TabooLib 6.0.0 开发的插件可以直接升级版本到 6.0.1 或 6.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。

警告

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