compare_versions

简介

compare-versions 是一个用于比较版本号的库，提供了一种简单且可靠的方式来比较两个版本号的大小。此库支持多种版本号格式，如数字形式、语义化以及其它常见格式。通过使用 compare-versions，开发者可以轻松判断一个版本号是否大于、等于或小于另一个版本号，从而实现版本的有效管理和控制。

安装

ohpm install compare_versions

对于OpenHarmony ohpm环境配置的详细信息，请参阅OpenHarmony环境配置指南。

使用说明

import { compareVersions, compare, satisfies, validate, validateStrict } from "compare-versions";

compareVersions('11.1.1', '10.0.0'); //  1
compareVersions('10.0.0', '10.0.0'); //  0
compareVersions('10.0.0', '11.1.1'); // -1

compare('10.1.8', '10.0.4', '>');  // true
compare('10.0.1', '10.0.1', '=');  // true
compare('10.1.1', '10.2.2', '<');  // true
compare('10.1.1', '10.2.2', '<='); // true
compare('10.1.1', '10.2.2', '>='); // false

satisfies('10.0.1', '~10.0.0');  // true
satisfies('10.1.0', '~10.0.0');  // false
satisfies('10.1.2', '^10.0.0');  // true
satisfies('11.0.0', '^10.0.0');  // false
satisfies('10.1.8', '>10.0.4');  // true
satisfies('10.0.1', '=10.0.1');  // true
satisfies('10.1.1', '<10.2.2');  // true
satisfies('10.1.1', '<=10.2.2'); // true
satisfies('10.1.1', '>=10.2.2'); // false
satisfies('1.4.6', '1.2.7 || >=1.2.9 <2.0.0'); // true
satisfies('1.2.8', '1.2.7 || >=1.2.9 <2.0.0'); // false
satisfies('1.5.1', '1.2.3 - 2.3.4'); // true
satisfies('2.3.5', '1.2.3 - 2.3.4'); // false

validate('1.0.0-rc.1'); // true
validate('1.0-rc.1');   // false
validate('foo');        // false

validateStrict('11.0.0') // true

接口说明

方法名	入参	接口描述
compareVersions(versionA:string, versionB:string)	versionA：第一个版本号（字符串） versionB：第二个版本号（字符串）	比较两个版本号的大小。
compare(versionA:string, versionB:string,operator:string)	versionA:第一个版本号（字符串） versionB:第二个版本号（字符串） operator:比较运算符	比较两个版本号的大小关系.
satisfies(version:string, range:string)	version：待检查的版本号（字符串） range：版本范围（字符串，如 ^1.0.0 或 >=1.0.0 <2.0.0）	检查版本号是否满足指定的范围
validate(version:string)	version：待检查的版本号	验证版本号是否符合 SemVer 规范
validateStrict(version:string)	version：待检查的版本号	严格验证版本号是否符合 SemVer 规范，包括主版本号、次版本号、修订号以及可选的预发布标签和构建元数据。

约束与限制

在下述版本验证通过：

• DevEco Studio: NEXT Beta1-5.0.3.806, SDK: API12 Release(5.0.0.66)
• DevEco Studio: 4.1 Canary(4.1.3.213), SDK: API11 4.1.2.3

目录结构

|---- compare-versions
|     |---- entry  # 示例代码文件夹
|     |---- README.md     # 安装使用方法
|     |---- README_zh.md  # 安装使用方法

贡献代码

使用过程中发现任何问题都可以提交 Issue，当然，也非常欢迎提交 PR 。

开源协议

本项目遵循 MIT License。