找回密码
 会员注册
查看: 129|回复: 0

规范升级NPM包

[复制链接]

4

主题

0

回帖

13

积分

新手上路

积分
13
发表于 2024-10-13 12:07:50 | 显示全部楼层 |阅读模式
规范升级 NPM 包 159 规范升级 NPM 包前言在日常工作中,当组件跨项目使用时,我们往往会选择把组件抽成 npm 包。那么在 npm 开发以及发布的过程中有什么需要注意的事项吗?本文将从我自己的角度,来为大家介绍一下我认为的一些需要大家注意的点。版本号规则从日常的开发中我们可以看到,npm 包的版本号的格式都是 X.Y.Z。那么大家发布的 npm 包为什么都在遵循这个格式呢?这个格式其实是由 Gravatars 创办者兼 GitHub 共同创办者 [Tom Preston-Werner] http://tom.preston-werner.com/ 所建立。由 GitHub 起草的统一的版本号表示规则,称为 Semantic Versioning (语义化版本表示)。这些规范具体包含的内容大家可以参考[语义化版本 2.0.0]  https://semver.org/lang/zh-CN/ 本文只针对我们开发中容易忽略的地方做一些详述。X 代表主版本号,也叫做大版本号升级大版本时意味着这个包可能做了颠覆性的改动,和低版本的包已经无法兼容。每当主版本号递增时,次版本号和修订号必须归零。Y 代表次版本号,也叫做小版本号当做了向下兼容的功能性新增时,升级小版本号。每当次版本号递增时,修订号必须归零。Z 代表修订号当做了向下兼容的问题修正(bugfix)时, 升级修订号。常见版本格式/引用方式版本引用方式版本号匹配版本解释直接使用版本号2.3.12.3.1只可以匹配 2.3.1 这个版本,如果是比较重要的项目,建议用这种方式固定版本。^:不能修改版本号最左侧非零数字^2.3.1>= 2.3.1 & = 0.3.1 & = 0.01 & = 2.3.1 & = 2.0.0 & = 2.3.0 & = 2.0.0 &  | major | minor | patch | premajor | preminor | prepatch | prerelease | from-git]// newversion:指定更新的版本号// major:大版本并且不向下兼容时,使用 major// minor:有新功能且向下兼容时,使用 minor// patch:修复一些问题、优化等,使用 patch// 以 A:2.3.1 为例npm version premajor // 版本号会成为 3.0.0-0,即 3.0.0 的预发版本npm version preminor // 版本号为成为 2.4.0-0,即 2.4.0 的预发版本npm version prepatch // 版本号成为 2.3.2-0,即 2.3.2 的预发版本/*** 版本号会成为 2.3.2-0。* 执行此命令时,如果没有预发布版本号,则增加 Z,增加预发布号为 0* 如果有预发步号,增加预发步号*/npm version prerelease根据上边的 API 可以看到我们能通过 npm version 2.3.2-beta.1 将 A 的版本升为 2.3.2-beta.1 的形式,除此之外,在 npm 6.4.0 之后,我们也可以使用 --preid 参数来添加前缀:npm version prerelease --preid=beta此种方式需要注意,必须要 commit 本地的修改之后才可以执行。npm version 修改版本号,会默认执行 git add -> git commit -> git tag 操作,此时的版本号看起来有 beta,如下:但是这个 beta 是 git 仓库的 tag,并不是 npm 的 tag。如果不想默认给 git 添加 tag 的话,可以使用以下命令:npm --no-git-tag-version version xxx那么 npm version 执行时具体发生了什么呢?简要流程图如下执行完 npm version 2.3.2-beta.1 之后,如果直接使用 npm publish 来发布的话,发布出来的包的 tag 是 latest,但是我们其实是想发布一个测试包。如果其他人 npm i 下载时就会下载 version 为 2.3.2-beta.1 的包。只有使用 npm publish --tag XXX 才是给 npm 包上打了 tag 标签。执行以下命令就可以生成一个 tag 为 beta 的包:npm run build // 打包npm publish --tag beta // 发布 beta 包如果不小心直接使用 npm publish 发错了也没有关系,可以使用以下命令来添加 tag:npm dist-tag add  @2.3.2-beta.1 当需要删除多余的 tag 时:npm dist-tag rm   给大家提供一条指令完成 beta 版本的发布:"scripts": {    "publish:beta": npm version prerelease --preid=beta & npm run build & npm publish --tag=beta"  },代码开发完毕,提交之后,只需要 npm run publish:beta 就可以发布一个测试版本啦以上就是我本次分享的所有内容啦,如果有不足的地方,还望指正。参考文献语义化版本 2.0.0 (https://semver.org/lang/zh-CN/spec/v2.0.0.html)前端工程化(5):你所需要的 npm 知识储备都在这了(https://juejin.cn/post/6844903870578032647)npm version (https://docs.npmjs.com/cli/v6/commands/npm-version)看「前端团队」,
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 会员注册

本版积分规则

QQ|手机版|心飞设计-版权所有:微度网络信息技术服务中心 ( 鲁ICP备17032091号-12 )|网站地图

GMT+8, 2024-12-26 01:11 , Processed in 0.644275 second(s), 25 queries .

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表