创建自己的library类库包并使用webpack4.x打包发布到npm
我们在开发过程中,可能经常要使用第三方类库,比如jquery、lodash等。我们通过npm,下载安装完之后,就可以使用了,简单方便。我们自己可以创建一个类库,然后供其他人这样安装使用吗?当然是可以的。
下面我们就来说说。
1. 创建自己的类库 index.js import numRef from './ref.json' const numberWord = () => { const numToWord = (num) => { let returnValue = _.reduce(numRef, (accum, ref) => { return ref.num === num ? ref.word : accum }, '') return returnValue === '' ? '请输入0-10中的某个整数' : returnValue } const wordToNum = (word) => { let resultValue = _.reduce(numRef, (accum, ref) => { return ref.word === word || word.toLowerCase() === ref.word.toLowerCase() ? ref.num : accum }, -1) return resultValue === -1 ? '请输入0-10中正确的单词...' : resultValue } return { numToWord, wordToNum } } export default numberWord()此类库有两个方法,数字和单词互转。
这里可以直接使用lodash中的方法,是因为我们在webpack配置中使用了webpack.ProvidePlugin插件,使其再被需要的时候才require进来.
2. webpack4构建打包 使用babel编译js语法安装babel环境
npm i @babel/core @babel/preset-env @babel/polyfill @babel/plugin-transform-runtime -D创建文件.babelrc,设置转码的规则和插件
{ "presets": [ ["@babel/preset-env", { "useBuiltIns": "usage", "modules": false }] ], "plugins": [ [ "@babel/plugin-transform-runtime", { "corejs": false, "helpers": false, "regenerator": false, "useESModules": false } ] ], "comments": false } 增加webpack配置文件webpack.config.js: let path = require('path') let webpack = require('webpack') module.exports = { entry: './src/index.js', output: { path: path.resolve(__dirname, 'dist'), filename: 'webpack-number-word.js', library: 'numberWord', // 指定类库名,主要用于直接引用的方式(比如使用script 标签) libraryExport: "default", // 对外暴露default属性,就可以直接调用default里的属性 globalObject: 'this', // 定义全局变量,兼容node和浏览器运行,避免出现"window is not defined"的情况 libraryTarget: 'umd' // 定义打包方式Universal Module Definition,同时支持在CommonJS、AMD和全局变量使用 }, mode: "production", // 告诉webpack使用production模式的内置优化, module: { rules: [{ test: /\.js$/, include: [ path.resolve(__dirname, 'src') ], exclude: /(node_modules|bower_components)/, loader: "babel-loader", }] }, plugins: [ new webpack.ProvidePlugin({ // ProvidePlugin 可以将模块作为一个变量,被webpack在其他每个模块中引用。只有你需要使用此变量的时候,这个模块才会被 require 进来。 _: ['lodash'] }) ], externals: { // 从输出的bundle中排除依赖 lodash: { // 可以在各模块系统(Commonjs/Commonjs2/AMD)中通过'lodash'访问,但在全局变量形式下用'_'访问 commonjs: 'lodash', commonjs2: 'lodash', amd: 'lodash', root: '_' // 指向全局变量 } } }其中,使用了loader工具babel-loader,对src中的js文件加载
npm i babel-loader -D 使用webpack打包先安装webpack 和它的cli
npm i webpack webpack-cli -D之后,执行命令,静候佳况
npm run build按以上流程,自动在根目录下生成了dist文件夹,并出现了一个webpack-number-word.js文件。
我以上的介绍的都是些简单的使用。webpack还有很多可以优化的内容,以后继续探讨。
至此,我们自己的类库包webpack-number-word已经出来了,接下来就是要上传至NPM了。
3. 上传至NPM你可以上传任何具有package.json文件的文件夹至NPM。几个主要命令:
npm adduser npm login npm version <update_type> npm publish上传之前,需要登陆。
如果没有账号,需要先注册npm账号,并验证邮箱。
然后在终端使用命令npm login,输入注册时候的账户、密码、邮箱,来登陆。(也可以直接使用命令npm adduser来注册并登陆。)
上传前期工作做好,确定自己的类库可以发布之后,使用npm publish来发布上传包。成功之后,就可以在npmjs网站找到你刚上传的包了。
更新以后,如果需要上传更新包的内容,流程是
需要先更新版本号,
npm version <update_type>
之后webpack构建
npm run build
上传
npm publish
需要更新版本编号,可以直接手动在package.json中更改version字段。当然,也可以使用命令
npm version [<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease [--preid=<prerelease-id>] | from-git]
此命令,会在git commit中生成一条记录,并标记tag。
解释下以下三种:patch、minor、major。
目前node版本大都是使用语义化版本(semver)作为一个标准。