在 OHPMOpenHarmony Package Manager生态中三方库的版本号严格遵循语义化版本控制SemVer 2.0.0规范。这套规范旨在通过版本号直观地传达代码的变更类型与兼容性。以下是详细的版本管理规范1. 版本号标准格式标准的版本号格式为主版本号.次版本号.修订号即MAJOR.MINOR.PATCH且每一位均禁止在前面添加前导零如01.0.1或1.0.01均为无效格式。主版本号MAJOR当开发者进行了不能向下兼容的代码修改如删除了某个组件、修改了核心接口时必须递增主版本号同时将次版本号和修订号归零。次版本号MINOR当开发者新增了功能且保持向后兼容时必须递增次版本号同时将修订号归零。修订号PATCH当开发者仅进行了程序 Bug 或漏洞修复且保持向后兼容时须递增修订号。2. 预发布与构建信息可选扩展除了标准版本号还支持附加预发布标识和构建信息先行版本号PRERELEASE用于标识尚未稳定的预发布版本如测试版、候选版。格式为在标准版本号后加连字符如1.0.0-alpha、1.0.0-beta.10。当标准版本号相同时先行版本的优先级小于标准版本例如1.0.0-snapshot 1.0.0。构建信息BUILD用于记录编译或构建过程中的附加信息如时间戳。格式为在版本号后加加号如1.0.020250415。构建信息不影响版本比较时的优先级。3. 版本比较与解析规则逐级比较比较时优先比较主版本号其次次版本号最后修订号例如1.1.1 1.1.2 1.2.0 2.0.0。缺省字段处理当版本号存在缺省字段时缺失字段视为0例如1.2等价于1.2.01等价于1.0.0。开发初始阶段主版本号为零0.y.z的软件处于开发初始阶段API 不稳定视为非稳定版本。4. 依赖范围解析策略在配置依赖范围如1.0.0时包管理器会按以下逻辑拉取版本若仓库同时存在先行版本和标准版本优先安装符合范围的最新标准版本。若仓库中不存在符合范围的标准版本则会退而安装符合范围的最新先行版本。
在 OHPMOpenHarmony Package Manager生态中三方库的版本号严格遵循语义化版本控制SemVer 2.0.0规范。这套规范旨在通过版本号直观地传达代码的变更类型与兼容性。以下是详细的版本管理规范1. 版本号标准格式标准的版本号格式为主版本号.次版本号.修订号即MAJOR.MINOR.PATCH且每一位均禁止在前面添加前导零如01.0.1或1.0.01均为无效格式。主版本号MAJOR当开发者进行了不能向下兼容的代码修改如删除了某个组件、修改了核心接口时必须递增主版本号同时将次版本号和修订号归零。次版本号MINOR当开发者新增了功能且保持向后兼容时必须递增次版本号同时将修订号归零。修订号PATCH当开发者仅进行了程序 Bug 或漏洞修复且保持向后兼容时须递增修订号。2. 预发布与构建信息可选扩展除了标准版本号还支持附加预发布标识和构建信息先行版本号PRERELEASE用于标识尚未稳定的预发布版本如测试版、候选版。格式为在标准版本号后加连字符如1.0.0-alpha、1.0.0-beta.10。当标准版本号相同时先行版本的优先级小于标准版本例如1.0.0-snapshot 1.0.0。构建信息BUILD用于记录编译或构建过程中的附加信息如时间戳。格式为在版本号后加加号如1.0.020250415。构建信息不影响版本比较时的优先级。3. 版本比较与解析规则逐级比较比较时优先比较主版本号其次次版本号最后修订号例如1.1.1 1.1.2 1.2.0 2.0.0。缺省字段处理当版本号存在缺省字段时缺失字段视为0例如1.2等价于1.2.01等价于1.0.0。开发初始阶段主版本号为零0.y.z的软件处于开发初始阶段API 不稳定视为非稳定版本。4. 依赖范围解析策略在配置依赖范围如1.0.0时包管理器会按以下逻辑拉取版本若仓库同时存在先行版本和标准版本优先安装符合范围的最新标准版本。若仓库中不存在符合范围的标准版本则会退而安装符合范围的最新先行版本。
