用途
prepare-release 用于 Cesium for Unreal 的发布准备工作,在正式发版前审计变更日志、补全待发布内容,并生成发布准备相关的文件改动。
主要能力
- 根据输入的新版本号(X.Y.Z),确定默认发布日期:当前或下月的第一个工作日;若用户显式覆盖则按用户指定。若所选月份以周末开始,则使用第一个周一作为发布日期。
- 定位上一个发布标签,审查该标签之后的所有变更。
- 将每项变更与 CHANGES.md 对照,找出遗漏的变更日志条目;若存在缺失,在编辑前先提出补充建议。
- 将 CHANGES.md 中待发布章节的标题设置为新版本号与发布日期。
- 更新 CHANGES.md,使待发布章节完整反映上次发布以来的变更,并显式加入 cesium-native 更新说明。
- 在日志编辑完成后直接运行发布准备脚本;脚本负责更新 CesiumForUnreal.uplugin、package.json,并通过检出 main、拉取最新改动、暂存父仓库子模块引用的方式更新 extern/cesium-native。
- 脚本从最新标签推导 cesium-native 的发布版本。
使用方式
调用时提供输入:新 Cesium for Unreal 版本号(X.Y.Z);发布日期可按默认规则自动确定,也可显式覆盖。流程按上述步骤执行,提交前审查生成的 diff。
限制与约束
- 该工作流不处理 ion token。
- 不执行任何提交操作。
- 变更日志审查为强制步骤,缺失条目必须先提出再更新 CHANGES.md。
- 必须在发布章节中显式加入 cesium-native 更新说明。
- 日志编辑就绪后须直接运行发布准备脚本。