发布
推 tag 是唯一会发布的事情。 分支上的 push 只构建与测试(ci.yml),不发布。
为什么不再由”版本号变了”触发
旧流程在每次 push 时检查远端有没有 v<版本> 这个 tag,没有就发布一次。它有两个问题:
- 触发与发布无关:任何 push 都可能发布,只要那个 tag 还不存在;
- 失败不可重试:tag 由发布流程自己创建,一旦创建成功、而某个平台没传上去,下次运行会认为”已发布”而永久跳过。
怎么做一次发布
- 改
gradle.properties里的mod_version,并在CHANGELOG.md加一节(发布正文就取这个文件); - 提交并 push 到
master,等ci绿; -
打 tag 并推:
git tag -a v1.0.0-alpha.32 -m "1.0.0-alpha.32" git push origin v1.0.0-alpha.32 # 普通 git push 不会推 tag releaseworkflow 被触发:先跑assertReleaseTag(tag 必须等于v<mod_version>,不一致直接失败),再跑publishMods发到 Modrinth / CurseForge / GitHub。发布列表是核心 jar、核心 sources jar、demo jar 与 demo sources jar;demo 示例与入口注册表不在核心 jar 里。
发布门禁
这是 alpha 运行时组合变更:核心不再自动创建入口 Overlay。后端必须改为在创建根之后、挂页面之前调用 installEntryOverlays(root);不改的后端仍能启动,但会静默失去入口 Overlay 与 DebugOverlay。核心仓库不包含后端代码,因此这个 adoption 由后端发布流程验证(配置页、入口 Overlay、DebugOverlay 各开一次),不是核心构建能覆盖的。
失败了怎么办
重跑 workflow(Actions 页面 → Re-run jobs)。不要删 tag 重推:同一个版本重复上传到平台通常不友好,而重跑不会制造第二个版本。
只有”tag 打错了(指向错误的提交)”才需要删 tag 重来,那时也要先确认平台上没有那一版。