版本规范

Tip

TabooLib 的版本号使用一种符合语义化版本(SemVer)规范的格式。关于 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,但是不能反过来操作。

TabooLib 版本号的例子 common:6.0.0 and platform-bukkit:6.1.0.

修订版本(PATCH)

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

Note

次版本好变化时,修订号必然重置。

TabooLib 版本号的例子 common:6.0.1 and platform-bukkit:6.1.2-rc.

推荐版本

推荐版本是指那些通过质量测试的稳定版本,可以完美利用当前版本 TabooLib 的所有功能。

Warning

下列信息是给 TabooLib 开发者看的,开发者们应当使用推荐版本进行插件开发和测试。非推荐版本自身不稳定,使用这些版本等同于 “多少有毛病”。因此我们强烈推荐 TabooLib 开发者不要使用非推荐版本进行开发和测试。

候选(Release Candidate,RC)

所有推送到 GitHub 上的更新若不标注推荐版本,则代表候选版本,在经过进一步测试后它有可能会成为下一个推荐版本。候选版本也有可能不正常工作。

快照(SNAPSHOT)

带有 -SNAPSHOT 标签的版本代表了正在开发中的下一个版本的快照版本。比方说 6.0.1-SNAPSHOT 代表了正在开发中的 6.0.1 版本。再比如 6.1.0-SNAPSHOT 代表了正在开发下一个主要更新 6.1.0。快照版本中的新工具和特性随时可能被移除或发生变动。

测试(TEST)

带有 -test-{测试号} 标签的版本代表了正在开发中的下一个版本的内部测试版本。通常是用于内部人员分发测试的版本号,是极其不稳定的,甚至无法工作。可以在这个版本中看到即将开发完成的新的工具和特性。