Skip to content

插件版本管理 ​

规范的版本管理让用户清楚升级是否安全,也是上架审核的关注点。

核心要点 ​

语义化版本 ​

遵循 主.次.补(MAJOR.MINOR.PATCH):

  • MAJOR:不兼容的 API 变更(破坏用户配置或数据)
  • MINOR:向下兼容的新功能
  • PATCH:向下兼容的缺陷修复
json
{ "version": "1.2.0" }

与 Obsidian 版本联动 ​

  • versions.json 记录每个插件版本对应的 minAppVersion:
json
{ "1.2.0": "1.4.0", "1.1.0": "1.1.0" }
  • 升级 Obsidian 大版本(如 1.13)后,若用到新 API,需同步抬高 minAppVersion
  • 用 CI/CD 在发版时自动更新 versions.json

注意事项 ​

  • 每次发版必须递增 version,否则商店不刷新
  • 破坏性变更务必在 versions.json 锁定旧版可用的 minAppVersion

相关阅读 ​