npm 版本添加 alpha 后缀

npm version to add alpha postfix

如何使用 npm 版本控制将 package.json 版本提升为包含 -alpha

运行 npm version <new version> 会改变 package.json 文件的版本,但是我想为版本添加 -alpha 后缀,但我无法这样做文档中没有说明,但 semver 本身支持它。

实际结果:

> npm version prerelease
> v0.2.1-1

预期结果:

> v0.2.1-alpha

虽然 -alpha 和 -beta 是常见的预发布标签,但它们不是由 SemVer 定义的。 -alpha.1、-alpha.2、-beta.1 等也很常见。该规范将预发布标签定义为一系列点分隔的字母数字或数字字符字段。 SemVer 规范在某些示例中使用了 alpha 和 beta,但规范并未定义它们。如果你不告诉它,NPM 无法知道你想使用什么标签。它显然默认为数字预发布标签,这是有道理的,因为 SemVer 允许(-1、-2、-3 提供所有必要的语义)。

NPM 文档很糟糕,幸运的是我从来没有使用过 NPM。参见 https://docs.npmjs.com/cli/version。特别是:

The newversion argument should be a valid semver string, a valid second argument to semver.inc (one of patch, minor, major, prepatch, preminor, premajor, prerelease), or from-git.

看提供的link(https://github.com/npm/node-semver#functions),好像是指增加指定版本字段。在 package.json 文件中的版本字符串中没有 alpha 标签的情况下,将缺少的数字预发布标签附加为 -1 很有意义。

我刚刚测试了这个理论:

> echo Test > test.txt
> npm init
This utility will walk you through creating a package.json file.
It only covers the most common items, and tries to guess sane defaults.

See `npm help json` for definitive documentation on these fields
and exactly what they do.

Use `npm install <pkg> --save` afterwards to install a package and
save it as a dependency in the package.json file.

Press ^C at any time to quit.
name: (packageTest)
version: (1.0.0) 0.1.0-alpha.0
description: Test package.
entry point: (index.js)
test command:
git repository:
keywords:
author:
license: (ISC)
About to write to D:\TMP\Joseph\packageTest\package.json:

{
  "name": "packageTest",
  "version": "0.1.0-alpha.0",
  "description": "Test package.",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC"
}


Is this ok? (yes)

> npm version prerelease
v0.1.0-alpha.1

> cat package.json
{
  "name": "packageTest",
  "version": "0.1.0-alpha.1",
  "description": "Test package.",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC"
}

符合预期。

您无法自动设置 0.2.1-alpha,但可以设置 0.2.1-alpha.0

npm 支持 --preid 选项来指定预发布的前缀。它可与 pre* 版本结合使用。

示例 1. 制作下一个主要版本的 alpha:

# 1.2.3 => 2.0.0-alpha.0
npm version premajor --preid alpha

示例 2. 将 alpha 转换为 beta:

# 2.0.0-alpha.0 => 2.0.0-beta.0
npm version prerelease --preid beta

创建预发布后,您可以使用 prerelease 参数递增数字。

# 2.0.0-beta.0 => 2.0.0-beta.1
npm version prerelease