Skip to main content

版本控制策略

Modular Avatar 遵循 语义化版本控制(Semantic Versioning)。这意味着:

  • 当做了不兼容的更改后,主版本号将改变(例如 1.0.0 -> 2.0.0)。
  • 当做了向下兼容的新功能后,次版本号将改变(例如 1.0.0 -> 1.1.0)。举个例子,1.1.0 下制作的预制件可能不能在 1.0.0 下运行,但是 1.0.0 下制作的预制件可以在 1.1.0 下运行。
  • 当做了错误修复和细微更改并且不影响保存格式后,修订号将改变(例如 1.0.0 -> 1.0.1)。一般来说使用旧的修订版本不会有大问题,除非错误修复影响到了您的预制件。

总的来说,推荐使用同一个主版本(1.x.x)下最新版本的 Modular Avatar。

内部实现和传递引用

所有 internal 类名和方法名都不被视为稳定 API,随时可能发生变化,包括补丁版本更新(例如 1.0.0 -> 1.0.1)。特别是,NDMF 传递的限定名称(Qualified Name)也不被视为稳定 API,Modular Avatar 执行传递的顺序也不保证稳定。插件自身的限定名称(Qualified Name)nadena.dev.modular-avatar 则被视为稳定,并且不会发生变化。

如果您有依赖特定 Modular Avatar 传递的用例,请在 GitHub 上提交功能请求,并提供您的用例详细信息,我将考虑为这些传递依赖添加稳定的 API。