从零开始封装React UI 组件库并发布到NPM

github 开源地址:zswui

github 说明文档:wiki

1.新建目录wui

(1)进入到 wui 目录 执行 npm init 命令初始化项目。更具提示信息填充将会生成的 package.json 文件。

(2)新建 webpack.config.js 打包文件。

(3)新建 README.md 项目说明文件。

(4)新建 .gitignore 项目忽略文件。

(5)安装webpack 用于编译 JavaScript 模块。

npm install webpack webpack-cli --save-dev

  

(6)安装 babel 相关的编译库,将javascript 代码转换成 浏览器兼容的代码。

npm install babel-loader @babel/core --save-dev 

  

(7)给 webpack.config.js 配置 babel-loader 解析信息,。

// module 表示模块信息
module: { rules: [ { test: /.js$/, exclude: /node_modules/, loader: "babel-loader" } ] }

  

(8)创建 .babelrc 文件

虽然已经配置好了 Babel ,但并没有让它真正生效。在项目的根目录中创建一个 .babelrc 文件并启用一些插件

首先,你可以使用转换 ES2015+ 的 env preset 。

npm install @babel/preset-env --save-dev

  

为了让 preset 生效,你需要像下面这样定义你的 .babelrc 文件

{
  "presets": ["@babel/preset-env"]
}

  

(8) 安装 编译 jsx 语法的库

npm install --save-dev @babel/preset-react

  修改.babelrc文件配置

{
    "presets": [
        "@babel/preset-env",
        "@babel/preset-react"
    ]
}

  

(9) 安装 html-webpack-plugin 插件,生成 html 文件.配置到 webpack.config.js 文件

npm install  html-webpack-plugin  --save-dev

  

(10) 安装 react 相关的包

npm i react react-dom --save-dev

  

(11) 安装 webpack-dev-server 作为本地开发环境

npm  i webpack-dev-server -g

  

(12) 在 package.json文件中添加自定义启动脚本

"scripts": {
    "start": "webpack --config webpack.config.js",
    "test": "npm run test"
}

  

 (13) 安装清理文件夹的插件

npm install clean-webpack-plugin --save-dev

  

(14) 安装提取 css 到一个文件的库

npm install --save-dev extract-text-webpack-plugin

  

(15) 安装支持 sass / less 文件的库

npm install --save-dev style-loader css-loader
npm install --save-dev less-loader less
npm install sass-loader node-sass webpack --save-dev
配置 webpack.config.js (14,15 步骤配合操作)

  





package.json 字段含义解释:
1.name 包名,如果有重名可以添加 scoped 前缀,例如(@winyh/wui)
2.verson 版本号,每次发布版本前需要递增修改版本号
3.description 包简介。
4.private 是否私有。一定要设置为 false
5.main 项目入口。
6.directorities 描述模块的结构,暂时可以忽略。
7.scripts 执行脚本,可以在这里添加自定义的执行脚本。
8.registory 仓库地址,设置代码所在仓库地址。
9.keywords 关键字,设置仓库的关键字,方便检索。
10.author 作者,可以输入作者名称。
11.license 许可协议。
12.bugs 提交地址。
13.homepage 项目主页。
14.devDependencies 开发环境依赖包记录。
 



发布:
1.修改package.json文件,添加 "private": false 设置当前组件库为非私有的。否则 npm publish 会报错。
2.修改 version 版本号,npm 发布版本时,会向上叠加(v0.0.1 -> v0.0.2)。发布前不修改版本号也会报错。
3.执行 npm login 登录 npm 账户(需要现在官网注册npm账号)。
4.执行 npm publish 发布最新版本。(发布成功后一般注册邮箱会收到发布版本的消息)
1.报错:
(1)Tapable.plugin is deprecated. Use new API on `.hooks` instead
原因:
extract-text-webpack-plugin目前版本不支持webpack4
解决办法:
npm install extract-text-webpack-plugin@next

2.报错:

  Can't resolve 'style-loader

   npm i style-loader --save-dev

 
原文地址:https://www.cnblogs.com/winyh/p/11822896.html