跳到主要内容

ohpm version

管理模块版本。

命令格式​

ohpm version [options] [<newversion> | major | minor | patch]

功能描述​

在模块目录中运行此命令以获取或升级版本号，同时将数据回写入 oh-package.json5 中。

参数说明​

无参数​

当无参数使用ohpm version命令时，则会将当前模块的版本号打印至标准输出中。

newversion​

newversion 参数应为一个合法的语义化版本，命令会将当前模块版本改写为 newversion 并打印在标准输出中。

major​

当参数为 major 时，有以下几种情况：

  • 若无先行版本号，则将主版本号递增 1，其他位置为 0；
  • 若存在先行版本号：
    • 当次版本号、修订号都为 0 时，则主版本号不变，而将先行版本号删掉。即 1.0.0-beta.1 升级为 1.0.0；
    • 当次版本号、修订号任意一个不为 0 时，则将主版本号递增1，其他位置为 0，并删除先行版本号。即 1.0.1-beta.1 升级为 2.0.0。

minor​

当参数为 minor 时，固定主版本号，变化次版本号与修订号，有以下几种情况：

  • 若无先行版本号，则将次版本号递增 1，修订号置为 0；
  • 若存在先行版本号:
    • 当修订号为 0 时，则次版本号不变，而将先行版本号删除。即 1.1.0-beta.1 升级为 1.1.0;
    • 当修订号不为 0 时，则将次版本号递增 1，修订号置为 0，同时删除先行版本号，即 1.1.1-beta.1 升级为 1.2.0。

patch​

当参数为 patch 时，固定主版本号与次版本号，变化修订号，有以下几种情况：

  • 若无先行版本号，则修订号递增 1。即 1.0.0 升级为 1.0.1；
  • 若存在先行版本号，则仅删除先行版本号。即 1.0.0-beta.1 升级为 1.0.0。

Options​

prefix​

  • 默认值：""
  • 类型： string

可以在 version 命令后面配置 --prefix <string> 参数，用来指定包的根目录，该目录下必须存在 oh-package.json5 文件。

parameterFile​

  • 默认值：无
  • 类型： string
  • 别名：pf

可以在 version 命令后面配置 --pf <string> 或者 --parameterFile <string> 参数，用来指定参数化配置文件地址。使用该命令前需保证项目级别的oh-package.json5中已配置parameterFile参数。

log_level​

  • 默认值：无
  • 类型： String

从ohpm 6.0.2.636版本开始，可以在 version 命令后配置--log_level <string>参数，指定执行当前命令的日志级别（info、debug、warn、error），如果未指定该值则日志级别为.ohpmrc中配置的log_level的级别。

debug​

  • 默认值：false
  • 类型： Boolean

从ohpm 6.0.2.636版本开始，可以在命令后配置--debug参数，指定执行当前命令的日志级别为debug，该配置仅在当前命令行生效，不修改.ohpmrc中的日志级别，如果未指定该值则日志级别为.ohpmrc中配置的log_level的级别。

示例​

当前模块为 entry，版本号为 1.0.0，在当前模块的根目录执行：

ohpm version

结果示例：

接着执行：

ohpm version 1.0.1-beta.1

结果示例：

接着执行：

ohpm version major

结果示例：