使用Vue CLI 3将基于element-ui二次封装的组件发布到npm

前言：以前在网上找的好多都是基于vue-cli 2.x的，而使用vue-cli 3的文章比较少，因此我在本身尝试的时候把几篇文章结合了一下，调出来了我想要的模式，也就是Vue CLI 3 + element-ui + 多个二次封装的组件。最终想要的是 element-ui 这种感受的，不少组件能够在不一样项目中复用。

安装依赖

首先用Vue CLI 3来初始化项目

yarn global add @vue/cli
vue create qiyun-el-ui
vue ui

安装element-ui

这里使用官方提供的的插件安装：
http://element.eleme.io/#/zh-...

https://github.com/ElementUI/...

在插件列表搜索element

在这里我选的手动导入，图中是所有导入

这样在项目中，就会新建一个plugins文件夹，里面有个element.js 文件，若是想手动引入，就在这里添加要依赖的组件，这里是为了调试组件：

import Vue from 'vue'
import { 
  Button, 
  Dialog 
} from 'element-ui'

Vue.use(Button)
Vue.use(Dialog)

因为咱们是基于element-ui的部分组件作的二次封装，因此最好仍是按需引入所依赖的组件比较好。

编写组件

在 src 的同级下面新建 packages 目录，在这里添加本身封装的要发布的组件。
例如，新建 qe-modal 文件夹，再接着新建 src 文件夹，里面新建 qe-modal.vue，在这里写组件的代码：

<template>
  <el-dialog
    :title="title"
    :visible="dialogVisible"
    @close="$emit('update:dialogVisible', false)"
    :width="width">
    <slot name="modal-body"></slot>

    <div slot="footer" class="dialog-footer">
      <slot name="modal-footer">
        <el-button @click="$emit('update:dialogVisible', false)" size="small">取 消</el-button>
        <el-button type="primary" @click="$emit('confirm')" size="small" :disabled="confirmDisable || beforeSendDisable">{{ beforeSendDisable? "处理中..." : "确 定" }}</el-button>
      </slot>
    </div>

  </el-dialog>
</template>

<script>
export default {
  name: 'qeModal',
  props: {
    dialogVisible: Boolean,
    title: String,
    width: {
      type: String,
      default: '580px'
    },
    beforeSendDisable: {
      type: Boolean,
      default: false
    },
    confirmDisable: {
      type: Boolean,
      default: false
    }
  }
}
</script>

在 qe-modal 根目录下新建 index.js ，里面注册单独的该组件，方便使用时能够单独引用：

import qeModal from './src/qe-modal'

qeModal.install = function(Vue) {
  Vue.component(qeModal.name, qeModal)
}

export default qeModal

这样一个组件就添加完成了，而后须要在 packages 的根目录下添加一个总的 index.js，这里是全局注册的地方，使用时能够全局引入，其实就跟 element-ui 的两种方式同样：

import qeModal from './qe-modal'

const components = [
  qeModal
]

const install = function(Vue) {
  components.forEach(component => {
    Vue.component(component.name, component);
  });
}

if (typeof window !== 'undefined' && window.Vue) {
  install(window.Vue);
}

export default {
  install,
  qeModal
}

后面再添加组件，在这里也要再注册一下，而element-ui 源码中是动态引入的，咱们的项目组件还没那么多，能够先一个个手动引入，若是后面数量多了，很差维护，能够参考 element-ui 的源码实现，我在这里作了一些简单的解释。

配置 npm

在 package.json 里面的 script 里面加一个 lib选项，方便每次构建：

"scripts": {
    // ...,
    "lib": "vue-cli-service build --target lib --name qiyun-el-ui --dest lib ./packages/index.js"
  },

其中 --name 后面是你最后想要生成文件的名字，并用 --dest lib 修改了构建的目录。
而后在 package.json 里面添加一些npm包发布的相关信息，好比做者、版本等：
其中最重要的是：

"main": "lib/qiyun-el-ui.common.js",

这里的路径要和上面构建出来的目录和文件名对应上。

里面的配置项，在网上找了个例子：

{
  "name": "maucash",
  "description": "maucash中经常使用组件抽取",
  "version": "1.0.2",
  "author": "kuangshp <kuangshp@126.com>",
  // 开源协议
  "license": "MIT",
  // 由于组件包是公用的，因此private为false
  "private": false,
  // 配置main结点，若是不配置，咱们在其余项目中就不用import XX from '包名'来引用了，只能以包名做为起点来指定相对的路径
  "main": "dist/maucash.js",
  "scripts": {
    "dev": "cross-env NODE_ENV=development webpack-dev-server --open --hot",
    "build": "cross-env NODE_ENV=production webpack --progress --hide-modules"
  },
  "dependencies": {
    "axios": "^0.18.0",
    "iview": "^2.14.1",
    "style-loader": "^0.23.1",
    "url-loader": "^1.1.2",
    "vue": "^2.5.11"
  },
  // 指定代码所在的仓库地址
  "repository": {
    "type": "git",
    "url": "git+git@git.wolaidai.com:maucash/maucash.git"
  },
  // 指定打包后,包中存在的文件夹
  "files": [
    "dist",
    "src"
  ],
  // 指定关键词
  "keywords": [
    "vue",
    "maucash",
    "code",
    "maucash code"
  ],
  // 项目官网的地址
  "homepage": "https://github.com/kuangshp/maucash",
  "browserslist": [
    "> 1%",
    "last 2 versions",
    "not ie <= 8"
  ],
  "devDependencies": {
    "babel-core": "^6.26.0",
    "babel-loader": "^7.1.2",
    "babel-plugin-transform-runtime": "^6.23.0",
    "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",
    "node-sass": "^4.5.3",
    "sass-loader": "^6.0.6",
    "vue-loader": "^13.0.5",
    "vue-template-compiler": "^2.4.4",
    "webpack": "^3.6.0",
    "webpack-dev-server": "^2.9.1"
  }
}

发布到npm

到这块后面的网上有不少更细致的教程，我就不在这里赘述了。下面给出两个文章的连接，供参考。

一、到npm上注册一个帐号

二、登陆
npm login

三、添加用户信息
npm adduser

四、发布到远程仓库(npm)上
npm publish

五、删除远程仓库的包
npx force-unpublish package-name '缘由描述'

参考：
https://juejin.im/post/5bc441...
Vue cli3 库模式搭建组件库并发布到 npm的流程_vue.js_脚本之家