npm发布vue插件

185 阅读3分钟

☀️一起养成写作习惯!这是我参与「掘金日新计划 · 4 月更文挑战」的第6天,点击查看活动详情

☀️ 在日常的开发中,我们常会需要用到几个项目公用一个模块的需求,比如几个同类型的项目中,我需要用到同一个弹框,那么我首先需要将这个弹框做成一个组件,接下来呢?我是直接将写好的组件CV到每个项目中使用吗?在之前的开发中,我都是这么直接复制粘贴到每个项目的。

这样做的后果是什么呢:

  • 每个模块都不是完美的,那么就会有更改的时候,每一次更改都需要将所以项目中的代码更新一遍,这样我们复制了多少份代码就要改变多少次,非常的麻烦,那么有没有一个只需要更改一次,所以项目中的同一个模块都能得到更改呢?
  • 那就是npm包,我们可以通过上传到私有npm服务器,不断迭代npm包来更新管理所有项目的依赖。

☀️什么是npm

NPM的全称是Node Package Manager,是一个NodeJS包管理和分发工具,已经成为了非官方的发布Node模块(包)的标准。npm是JavaScript运行时环境Node.js的默认包管理器。

2020年3月17日,Github宣布收购npm,GitHub现在已经保证npm将永远免费,截至2020年3月17日,npm为大约1200万开发人员提供了130万个软件包,这些开发人员每月下载这些软件包达750亿次。

☀️注册一个npm账号

想要发布一个npm的包,首先第一步需要注册一个npm的账号以便后续发包使用

☀️对项目初始化

安装好脚手架vue-cli,打开终端输入命令

$ npm install --global vue-cli #全局安装

这里封装vue的插件用webpack-simple,webpack-simple类似于webpack。笔者这边也跟随这参考文章用该工具,接着在终端进入需要创建项目的目录下,输入命令

$ vue init webpack-simple project-name #project-name为项目名,在这我的项目名为vue-mytoast

image.png

最终初始化了我们的项目,src目录下创建一个lib文件夹,里面存放需要开发的插件文件

image.png

在lib文件夹下创建一个toast.vue文件,使用如下的代码,并且创建一个toast.js文件使用install方法将组件挂载到原型上

<template>
  <div class="vue-toast-wraper" v-show="isShowToast">
    {{toastMsg}}
  </div>
</template>

<script>
    export default {
        name: "vueToast",
        data() {
          return {
            toastMsg: "登陆成功",
            isShowToast:true
          }
        },
      mounted() {
          if (this.isShowToast) {
            setTimeout(() => {
               this.isShowToast = false;
            },2500);
          }
      }
    }
</script>

<style scoped>
  .vue-toast-wraper{
    background: rgba(0, 0, 0, 0.6);
    color: #fff;
    font-size: 17px;
    padding: 10px;
    border-radius:12px;
    display: -webkit-box;
    -webkit-box-pack: center;
    -webkit-box-align: center;
    position: fixed;
    top: 50%;
    left: 50%;
    z-index: 2000;
    -webkit-transform: translateY(-50%);
    transform: translateY(-50%);
    -webkit-transform: translateX(-50%);
    transform: translateX(-50%);
  }
</style>
import Toast from './toast.vue'
const vueToast = {
  install(Vue, options) {
    Vue.component(Toast.name, Toast) //Toast.name 组件的name属性,也就是后面使用的组件名字
    // 类似通过  this.$xxx方式调用插件,其实只是挂载到原型上而已
    //Vue.prototype.$xxx //最终可以在任何地方通过 this.$XXX调用
  }
}
//global情况下自动安装
if (typeof  window !== 'undefined' && window.Vue) {
  window.Vue.use(vueToast)
}

export default vueToast

☀️创建文件并引入

总共创建了俩个文件,一个是vue一个是js,创建完成之后我们可以在main.js中引入进行查看当成组件显示的效果。
在main.js中全局引入,引入的方式和平时用全局组件的引入方法没有什么不同,其实本质上就是当做一个全局组件来使用,当用成npm包封装成一个独立的组件发布,那么其他引用该包的项目都能当成一个组件来使用它。

image.png

当在浏览器上显示组件已经成功的时候那么久可以了。

image.png

☀️配置发布文件

首先对package.json文件进行修改,这里说明几个参数: 1.private 该包是否为私有,私有的包只能自己使用,别人无法引用到

{
  "name": "vue-mytoast",
  "description": "vue弹窗提示插件",
  "version": "1.0.0",
  "author": "lwz",
  "license": "MIT",   //开源协议
  "private": false,  //(改) 因为组件包是公用的,所以privatefalse
  "scripts": {
    "dev": "cross-env NODE_ENV=development webpack-dev-server --open --hot",
    "build": "cross-env NODE_ENV=production webpack --progress --hide-modules"
  },
  "main": "dist/toast.js",  //(改) 

  "dependencies": {
    "vue": "^2.5.11"
  },
  "browserslist": [
    "> 1%",
    "last 2 versions",
    "not ie <= 8"
  ],
  "keywords": [     //(改) 指定关键字
    "vue",
    "toast"
  ],
  "devDependencies": {
    "babel-core": "^6.26.0",
    "babel-loader": "^7.1.2",
    "babel-preset-env": "^1.6.0",
    "babel-preset-stage-3": "^6.24.1",
    "cross-env": "^5.0.5",
    "css-loader": "^0.28.7",
    "file-loader": "^1.1.4",
    "vue-loader": "^13.0.5",
    "vue-template-compiler": "^2.4.4",
    "webpack": "^3.6.0",
    "webpack-dev-server": "^2.9.1"
  }
}

以下配置我们配置文件的出口和入口,修改webpack.config.js文件。
为了方便其他人通过script标签的方式引入,我们将libraryTarget改为umd模式,这样就可以有俩种引入组件的方法,一种是通过npm进行install安装,另一种就是同script进行直接引入。

var path = require('path')
var webpack = require('webpack')

// 执行环境
const NODE_ENV = process.env.NODE_ENV

module.exports = {
  // entry: './src/main.js',
  // 根据不同的执行环境配置不同的入口
  entry: NODE_ENV == 'development' ? './src/main.js' : './src/lib/toast.js',
  output: {
    //修改打包出口,在最外级目录打包出一个 index.js 文件,我们 import 默认会指向这个文件
    path: path.resolve(__dirname, './dist'),
    publicPath: '/dist/',
    // filename: 'build.js'
    filename: "toast.js", //指定最终打包成dist文件夹下的文件名
    library: "vueToast",  // 指定的就是你使用require时的模块名
    libraryTarget: "umd", //libraryTarget会生成不同umd的代码,可以只是commonjs标准的,也可以是指amd标准的,也可以只是通过script标签引入的
    umdNamedDefine: true  //会对 UMD 的构建过程中的 AMD 模块进行命名。否则就使用匿名的 define
  },
  module: {
    rules: [
      {
        test: /.css$/,
        use: [
          'vue-style-loader',
          'css-loader'
        ],
      },      {
        test: /.vue$/,
        loader: 'vue-loader',
        options: {
          loaders: {
          }
          // other vue-loader options go here
        }
      },
      {
        test: /.js$/,
        loader: 'babel-loader',
        exclude: /node_modules/
      },
      {
        test: /.(png|jpg|gif|svg)$/,
        loader: 'file-loader',
        options: {
          name: '[name].[ext]?[hash]'
        }
      }
    ]
  },
  resolve: {
    alias: {
      'vue$': 'vue/dist/vue.esm.js'
    },
    extensions: ['*', '.js', '.vue', '.json']
  },
  devServer: {
    historyApiFallback: true,
    noInfo: true,
    overlay: true
  },
  performance: {
    hints: false
  },
  devtool: '#eval-source-map'
}

if (process.env.NODE_ENV === 'production') {
  module.exports.devtool = '#source-map'
  // http://vue-loader.vuejs.org/en/workflow/production.html
  module.exports.plugins = (module.exports.plugins || []).concat([
    new webpack.DefinePlugin({
      'process.env': {
        NODE_ENV: '"production"'
      }
    }),
    new webpack.optimize.UglifyJsPlugin({
      sourceMap: true,
      compress: {
        warnings: false
      }
    }),
    new webpack.LoaderOptionsPlugin({
      minimize: true
    })
  ])
}

之后还要修改.gitignore 文件和index.js文件

.DS_Store
node_modules/
# dist/
npm-debug.log
yarn-error.log

# Editor directories and files
.idea
*.suo
*.ntvs*
*.njsproj
*.sln
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>vue-mytoast</title>
  </head>
  <body>
    <div id="app"></div>
    <!--<script src="/dist/build.js"></script>-->
    <script src="/dist/toast.js"></script>
  </body>
</html>

☀️打包过程

$ npm run build 
$ npm pack 

打包完会生成一个tgz的文件可以在本地当成测试包用,之后再发布

npm adduser

image.png 这里需要注册完npm账号输入账号密码,one-time需要在邮箱收到验证码

$ npm publish

登陆成功后进行 npm publish发布,到这里我们的第一个包就已经发布完成了,其他的人可以通过我们设置的包名进行install下载然后引入
本文参考了以下文章,跟着他一步一步完成了配置www.jianshu.com/p/b98d09609… 后续我们可以另开一个项目,然后通过npm install +包名 的方法直接下载到node_modules中,我们就已经把整个包都下载下来了,目录都是一样的

image.png 跟使用element等组件是一样的直接install后引入

image.png

image.png 在页面直接引用,就可以看到效果啦。

☀️欢迎讨论,喜欢的话点个赞再走吧。