LMES补丁打包规范说明

概述

LMES 补丁打包工具用于生成补丁包，并自动写入版本、依赖和打包时间。本文说明打包步骤及版本规则。

---

版本号规范

版本格式

LMES补丁版本采用四段式版本号格式：

主版本.次版本.修订版本.补丁版本

示例： 2.7.1.6

版本号含义

段落	含义	示例
2.7.1 (前三段)	产品版本号，对应主程序的版本	2.7.1
6 (第四段)	补丁版本号，每次发布补丁时必须递增	6

版本号管理规则

1. 产品版本号(前三段)必须与主程序版本保持一致
2. 补丁版本号(第四段)从1开始，每次发布新补丁必须+1
3. 不允许跳号，必须按顺序递增

---

打包流程

1. 准备工作

打包前检查以下文件：

• LMES-Patch 目录结构完整，待发布文件已放入对应位置。
• 根目录包含 hotplugsprofile.json 和 LMES补丁说明.txt。
• CMS.HotPlug.Packer.exe 可用。

2. 版本输入

运行打包脚本时，需要输入完整的四段式版本号。

格式要求： 2.7.1.6

输入提示说明：

• 红色提示：显示版本号格式示例
• 黄色说明：显示版本号各部分的含义

3. 自动配置

脚本自动更新以下配置：

• 更新hotplugsprofile.json中的版本信息
• 设置补丁描述信息（包含打包时间戳）
• 配置依赖关系信息

4. 打包输出

• 生成.cmsplugs格式的补丁包文件
• 文件名格式： lmes-v{产品版本}-patch{补丁版本}.cmsplugs
• 示例： lmes-v2.7.1-patch6.cmsplugs

5. 更新机制

同一产品版本的补丁采用累积更新方式：

机制	说明
完整文件集合	新补丁包含该产品版本此前补丁的所有文件
同名文件覆盖	新文件覆盖已安装补丁中的同名文件
覆盖安装	无需先卸载旧补丁
累积更新	安装最新补丁即可包含该产品版本此前的补丁内容

---

配置文件说明

hotplugsprofile.json

hotplugsprofile.json 由打包脚本自动更新，无需手动修改。内容包括补丁标识、版本、描述及主程序依赖：

{
  "HotPlugs": [
    {
      "HotPlugId": "LMES-Patch",
      "HotPlugName": "LMES-Patch", 
      "Category": "LMES",
      "Version": "v2.7.1.6",
      "Description": "LMES补丁 (2024-12-19 14:30:45)",
      "Dependencies": [
        {
          "HotPlugId": "LMES",
          "Version": "v2.7.1"
        }
      ]
    }
  ]
}

字段说明

字段名	说明	生成方式
HotPlugId	补丁标识符，固定为"LMES-Patch"	自动生成
HotPlugName	补丁名称，固定为"LMES-Patch"	自动生成
Category	分类，固定为"LMES"	自动生成
Version	完整版本号，包含v前缀	自动更新
Description	补丁描述，自动附加打包时间戳	自动更新
Dependencies	依赖关系，指定对主程序的版本依赖	自动配置

---

时间戳规范

格式要求

所有补丁包描述信息中自动包含打包时间戳，格式为：

yyyy-MM-dd HH:mm:ss

示例

LMES补丁 (2024-12-19 14:30:45)

作用

时间戳记录补丁生成时间，用于区分同一天的多次打包和查找对应发布记录。

---

依赖关系管理

依赖配置

每个补丁包都会自动配置对主程序的版本依赖：

字段	值	说明
HotPlugId	"LMES"	主程序标识
Version	"v2.7.1"	产品版本号(前三段)

依赖检查

安装时核对依赖中的产品版本是否与主程序一致。

---

输出文件规范

文件命名

生成的补丁包文件遵循统一命名规范：

lmes-v{产品版本}-patch{补丁版本}.cmsplugs

文件示例

• lmes-v2.7.1-patch1.cmsplugs
• lmes-v2.7.1-patch2.cmsplugs
• lmes-v2.7.1-patch8.cmsplugs

文件位置

补丁包生成在当前目录下，与打包脚本同级

---

错误处理

版本号格式验证

• 版本号必须包含四段数字。
• 格式不正确时，脚本显示红色错误提示并退出。

输入验证

未输入版本号时，脚本显示红色警告并允许重新输入；连续未输入时自动退出。

---

开发建议

版本发布建议

发布时记录变更内容和发布时间，保留历史补丁包供版本回滚时使用。

打包前检查清单

• 产品版本与主程序一致，补丁号按顺序递增。
• LMES-Patch 目录完整，根目录包含 LMES补丁说明.txt。
• 修改文件已就绪，并包含该产品版本的历史补丁文件。
• 同名文件覆盖范围与本次变更一致。
• 已安排打包时间。

---

注意事项

编号	注意事项	详细说明
1	版本号一致性	产品版本号必须与主程序版本完全匹配
2	补丁递增	补丁版本号必须严格递增，不可重复或跳号
3	时间准确性	打包时间戳基于系统当前时间，确保系统时间准确
4	文件备份	建议保留重要补丁包的备份副本
5	命名规范	生成的补丁包文件名不可手动修改，保持自动化命名
6	全量更新原则	新补丁必须包含所有历史补丁的文件，确保完整性
7	同名文件覆盖	新补丁中的同名文件会覆盖旧补丁的同名文件，实现文件更新

---

文档版本：v1.0；原文更新日期：2025年09月30日；适用范围：LMES补丁打包工具。