插件版本管理
规范的版本管理让用户清楚升级是否安全,也是上架审核的关注点。
核心要点
语义化版本
遵循 主.次.补(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