NPM 版本会在每次重大更改时更新主版本号吗?
NPM Versions update major number on every breaking change?
假设我的 npm 包 1.0.0 公开公开了一个名为 foo
的函数,供用户在许多其他函数和特性中使用。
然后我删除了 foo
功能,这将对所有使用此功能的用户造成影响。
NPM 说:
Changes which break backwards compatibility: Major release, increment the first number, e.g. 2.0.0
我很困惑这到底是什么意思。
如果我们为用户破坏了一个更改,即使只是一个小的更改,例如删除一个功能,是否应该始终更新主编号?
目前,每当我可能破坏公开暴露的功能时,我都会更新主编号。我看到带有小主要版本的 npm 包,并认为我这样做是不正确的,因为我正在非常快地更新我自己的包主版本号。
每个 API 更改(例如从库中删除端点、函数,或更改 endpoint/function 的行为)可能会影响客户端,应更新 MAJOR 编号。 MINOR 和 PATCH 告诉客户 library/API 对于一个 MAJOR 版本是稳定的。
Given a version number MAJOR.MINOR.PATCH, increment the:
- MAJOR version when you make incompatible API changes,
- MINOR version when you add functionality in a backwards-compatible manner, and
- PATCH version when you make backwards-compatible bug fixes.
您可以在 http://semver.org/
阅读更多内容
假设我的 npm 包 1.0.0 公开公开了一个名为 foo
的函数,供用户在许多其他函数和特性中使用。
然后我删除了 foo
功能,这将对所有使用此功能的用户造成影响。
NPM 说:
Changes which break backwards compatibility: Major release, increment the first number, e.g. 2.0.0
我很困惑这到底是什么意思。 如果我们为用户破坏了一个更改,即使只是一个小的更改,例如删除一个功能,是否应该始终更新主编号?
目前,每当我可能破坏公开暴露的功能时,我都会更新主编号。我看到带有小主要版本的 npm 包,并认为我这样做是不正确的,因为我正在非常快地更新我自己的包主版本号。
每个 API 更改(例如从库中删除端点、函数,或更改 endpoint/function 的行为)可能会影响客户端,应更新 MAJOR 编号。 MINOR 和 PATCH 告诉客户 library/API 对于一个 MAJOR 版本是稳定的。
Given a version number MAJOR.MINOR.PATCH, increment the:
- MAJOR version when you make incompatible API changes,
- MINOR version when you add functionality in a backwards-compatible manner, and
- PATCH version when you make backwards-compatible bug fixes.
您可以在 http://semver.org/
阅读更多内容