NPM版本会在每次重大更改时更新主要编号?

时间:2017-03-18 17:59:51

标签: node.js npm semantic-versioning

假设我的1.0.0的npm包公开了一个名为foo的函数,供用户在许多其他函数和功能中使用。

然后删除foo函数,该函数将为使用此函数的所有用户中断。

NPM说:

  

破坏向后兼容性的更改:主要版本,增加第一个数字,例如2.0.0

我很清楚这意味着什么。 主要号码是否应该更新,如果我们为用户打破一个变化,即使它只是一个小的变化,如删除一个函数?

目前,每当我打破公开曝光的功能时,我都会更新主号码。我看到npm包的主要版本很小,并认为我这样做是不正确的,因为我正在快速更新我自己的软件包主编号。

1 个答案:

答案 0 :(得分:2)

可能影响客户端的每个API更改(例如,删除端点,lib中的功能或更改端点/功能的行为)都应更新MAJOR编号。 MINOR和PATCH告诉客户端库/ API对于一个MAJOR版本是稳定的。

  

给定版本号MAJOR.MINOR.PATCH,增加:

     
      
  • 当您进行不兼容的API更改时的MAJOR版本,
  •   
  • 以向后兼容的方式添加功能时的MINOR版本,
  •   
  • 当您进行向后兼容的错误修复时的PATCH版本。
  •   

您可以在http://semver.org/

了解更多信息