Npm 发布 Vue 组件教程

1 前 言

平时咱们在开发的时候常用 npm 安装各类组件。

今天咱们就来尝试下制做一个本身的组件发布到 npm 上。

这里我以本身刚发布的一个 Vue 组件来介绍。感兴趣的能够来下载玩玩。

k-progress

安 装

npm install -S k-progress

使 用

// main.js
import 'k-progress';
import 'k-progress/dist/k-progress.css';
复制代码

2 开 发

2.1 新建项目

新建一个 Vue ，熟悉的能够直接略过哈。

这里我使用的是 @vue/cli。

npm install -g @vue/cli
# OR
yarn global add @vue/cli
复制代码

执行该命令，可检查是否安装成功。

vue --version

我常用 vue ui 来新建项目，这个命令会生成一个可视化操做页面，特别方便。

个人项目用到了 scss，新建的时候勾选上。

至此项目新建完成。

2.2 开发功能

默认新建的项目有个 HelloWorld.vue 的例子，咱们能够在这个页面，引用咱们的组件来检测开发效果。

在 src/components 中，咱们新建一个 progress.vue，该文件名称随意。

具体的插件功能在此页面编写。

在同级目录下新建一个 index.scss 文件用来保存插件使用的样式文件。

在同级目录下新建一个 index.js 文件来注册 Vue 组件。

这里以我为例。

import Vue from 'vue';
import kProgress from './progress.vue';
import './index.scss';

const Components = {
    kProgress
};

Object.keys(Components).forEach(name => {
    Vue.component(name, Components[name]);
});

export default Components;
复制代码

同时咱们能够在 HelloWorld.vue 文件中来调用咱们的组件查看效果。

3 构 建

构建主要是对 package.json 文件进行更改。以个人为例。

"name": "k-progress",
"version": "1.0.0",
"main": "./dist/k-progress.common.js",
"files": [
    "dist"
],
"private": false,
"scripts": {
    "serve": "vue-cli-service serve",
    "build": "vue-cli-service build",
    "package": "vue-cli-service build --target lib --k-progress main ./src/components/index.js"
},
复制代码

• name : 插件名称；
• version : 版本号，每次 npm publish 都须要进行更改；
• main : 插件的主文件路径；
• files : 发布保留的文件；
• private : 这里要改为 false ;
• scripts : 执行命令；

执行 yarn package 进行构建命令，不熟悉 yarn 的能够执行 npm run package，不过真心推荐 yarn。

4 发 布

4.1 注册帐号

NPM

4.2 登 录

在本身的项目中，执行 npm login，会提示让你输入 npm 帐号密码。

能够经过 npm whoami 来检查本身是否登陆成功。

4.3 发 布

npm publish

这里列出可能出现的 2 个错误。

1. "private": true 会报错
2. version ：publish 过一次后，相同版本的没法再次发布

5 后 记

感谢支持。

若不足之处，欢迎你们指出，共勉。

若是以为不错，记得 点赞，谢谢你们 ʚ💖ɞ

欢迎关注。

• GitHub
• 掘 金
• 简 书