发布一个npm包

前言

我这里是写了一个vue轮播图插件，因此我使用了vue的脚手架工具创建一个项目，当然你也可以选择自己搭建脚手架。

本例中我会使用vue脚手架创建一个项目，并发布到npm上面去。

通过脚手架创建项目

全局安装

首先，要创建项目，封装vue的插件用webpack-simple很合适，因此你需要全局安装@vue/cli-init插件：

yarn global add @vue/cli-init
//或者
npm install @vue/cli-init -g

使用vue init webpack-simple vue-test-plugin 初始化目录； vue-test-plugin是项目名称，也是新建项目的目录。

然后我使用全局安装失败了，那么我就使用局部安装把。

局部安装

新建D:/test test文件夹，局部安装@vue/cli-init插件：

yarn add @vue/cli-init
//或者
npm install @vue/cli-init

安装成功之后，使用命令初始化vue-test-plugin项目：

./node_modules/.bin/vue init webpack-simple vue-test-plugin

然后就一路enter直到项目创建完成。创建完成后的目录如下：

插件开发

在./src/目录下实现你自己的功能，我的功能实现完了之后如下：

./src/lib/banner.vue：是主功能文件

./src/lib/index.js：

import VueBanner from './banner.vue'
const plugin = {
  install: function(Vue) {
    Vue.component(VueBanner.name, VueBanner)
  }
}
// 这里的判断很重要
if (typeof window !== 'undefined' && window.Vue) {
    window.Vue.use(plugin)
}
export default plugin

我们在webpack配置的入口文件就是index.js，install是挂载组件的方法，有了它我们就可以在外部use一个插件了。

如果外部使用<script>引入的话window存在，window.Vue.use(plugin)就直接将插件挂在在全局了。

修改文件配置

package.json 文件

{
  "name": "vue-test-plugin",
  "description": "vue的插件测试",
  "version": "1.0.1",
  "author": "姓名 <xxx@xxx.com>",
  // 配置main结点，如果不配置，我们在其他项目中就不用import XX from '包名'来引用了，只能以包名作为起点来指定相对的路径
  "main":"dist/vue-test-plugin.js",
  //开源协议
  "license": "MIT",
  // 因为组件包是公用的，所以private为false
  "private": false,
  "scripts": {
    "dev": "cross-env NODE_ENV=development webpack-dev-server --open --hot",
    "build": "cross-env NODE_ENV=production webpack --progress --hide-modules"
  },
 // 指定代码所在的仓库地址
 "repository": {
 "type": "git",
 "url": "git+xxxxx"  //这里写github的git地址，格式为：'git+' + gitHubURL
 },
  "dependencies": {
    "vue": "^2.5.11"
  },
  "browserslist": [
    "> 1%",
    "last 2 versions",
    "not ie <= 8"
  ],
// 指定关键字
 "keywords": [
     "vue",
     "test-plugin"
 ],
  // 项目官网的url
 "homepage": "github地址下的readme.md文件地址",
  "devDependencies": {
    ...
  }
}

webpack.config.js 文件

  // entry: './src/main.js',
  entry: './src/lib/index.js',
  output: {
    path: path.resolve(__dirname, './dist'),
    publicPath: '/dist/',
    // filename: 'build.js'
    filename: '/vue-test-plugin.js',
    library: 'VueTestPlugin',
    libraryTarget: 'umd',
    umdNamedDefine: true
  },

由于不是所有使用组件的人都是通过 npm 安装使用 import 引入组件的，还有很多人是通过 <script>标签的方式直接引入的，所以我们要将 libraryTarget 改为 umd 格式，同时我们要配置文件入口和出。

.gitignore 文件

dist/  //删除此行

因为要用dist文件夹，所以在.gitignore文件中把dist/去掉。

index.html 文件

    <!-- <script src="/dist/build.js"></script> -->
    <script src="/dist/vue-test-plugin.js"></script>

打包

yarn build
//或者
npm run build

因为在import的时候，自动会加载packge.json文件中的main中的路径，我这里是：dist/vue-test-plugin.js，因此会去读取这个文件，所以需要打包。

发布npm

• 1.注册npm官网账号
• 2.切换到vue-test-plugin根目录下，添加npm账号：npm adduser
• 3.输入自己的npm用户名、密码、邮箱。
• 4.上传代码：npm publish

发布出现问题：npm ERR! publish Failed PUT 403

如果发布过程中出现此问题是因为使用了淘宝镜像，需要切换成原来的镜像，发布成功后，再切回来。

检查是否使用了淘宝镜像

npm config get registry

出现如下结果：

https://registry.npm.taobao.org/

如果出现如上结果，继续下一步

切换成原来的npm源

npm config set registry=http://registry.npmjs.org

继续npm publish发布npm包。

切回淘宝镜像

npm config set registry=https://registry.npm.taobao.org/