Gwm H5 Components

海外前端组件库

版本管理规范

SemVer 规范的标准版本号采用 X.Y.Z 的格式，其中 X、Y 和 Z 为非负的整数，且禁止在数字前方补零。X 是主版本号、Y 是次版本号、而 Z 为修订号。每个元素必须以数值来递增。

• 主版本号(major)：当你做了不兼容的 API 修改
• 次版本号(minor)：当你做了向下兼容的功能性新增
• 修订号(patch)：当你做了向下兼容的问题修正

命令

• 升级主版本号: npm version major
• 升级次版本号: npm version minor
• 升级修订版本号: npm version patch

发布

切到项目目录下，登录你的 npm 账号

npm adduser 或者 npm login

你可能会遇到报错，注意检查你的 npm 源是否有问题，使用 taobao 的源会报错，切换回 npm 官方源

npm config set registry https://registry.npmjs.org/

最后执行发布

npm publish

本地调试

当我们开发一个组件库，大多数情况下我们会希望能够直接在业务项目中调试我们的组件（在组件项目中有任何变动可以直接在业务项目中看到效果，而不是发布到 npm 仓库中，然后在业务项目再更新 npm 包去查看）。

调试工具-yalc

yalc 将组件的包依赖提升至应用中，在全局添加组件依赖，在应用下新建文件拉取依赖，即使有共同的依赖也会从应用的 node_modules 去查找。使用 yalc 可以避免上述问题。

全局安装

npm i yalc -g

发布到本地

在组件库目录下，运行

yalc publish

在使用该组件库的项目中添加本地依赖。

yalc add 你项目的名字

可以在 package.json 中查看相关依赖，依赖发生了变化。

// add之前
"test": "^2.6.14",

// add之后
"test": "yalc:xxxxxx",

当组件库发生变更后

// 编译代码
npm run build

// 发布更新
yalc push

调试完成以后，在业务项目中执行清除命令

yalc remove --all

清除命令后，node_modules 中原本的依赖文件也会消失，所以要重新跑业务项目，需要重新安装相关依赖，npm install 或者执行依赖再安装一次

参考资料

• yalc