你还没有撸一个包扔到npm上?

字节青霭探
• 阅读 2923
再不撸个包扔上去,以后起名字都是问题?。

这次帮助没有上传过npm包的同学了解一下流程,写一个简单的背景音乐控制插件。

开发流程

  • 使用 npm 初始化项目
  • 创建 __mocks__ 文件夹用于测试插件
  • 安装开发依赖(rollup、babel、eslint)
  • 使用 ES6 编写插件核心代码
  • 使用 rollup & babel 打包编译(UMD)
  • 发布到 npm

使用npm初始化项目

创建文件夹 x-music,这个名字被我用了,你们换个别的吧~
然后使用 npm init 指令会创建一个 package.json 文件在根目录下。

  $ npm init

package.json有俩点很重要

  • name: 你这个包的名字,由于现在重名较多,npm已经推荐使用 @codexu/** 这种形式,codexu 就是我的npm账户名,你可以看到 vue、babel 等等都开始使用这种方式了。
  • version: 每次向 npm publish 时会检测版本号,本次提交必须大于上次提交的版本号。

创建 __mocks__ 文件夹用于测试插件

谁也不能一次性写对代码是吧,__mocks__ 里创建个测试环境用于插件测试和调试。

这里我使用了我自己的脚手架工具 x-build ,当然你也可以用你习惯的脚手架或者手动撸几个文件和文件夹去测试你的插件。

如果你想使用 x-build,请使用以下命令安装(不使用直接跳过这段):

  $ npm install -g x-build-cli
  $ x-build create __mocks__ -q

-q 参数是快速生成模板,无需自定义。

安装开发依赖

  • 使用 rollup 作为打包工具,配置比 webpack 简单,而且打包出来的效果很好。
  • babel 可以让你使用 ES6 语法
  • eslint 还是很建议使用,毕竟你要写一款开源插件,别人可能会来阅读你的源码,规范点没差。
  "devDependencies": {
    "babel-cli": "^6.26.0",
    "babel-eslint": "^10.0.1",
    "babel-plugin-external-helpers": "^6.22.0",
    "babel-preset-env": "^1.6.0",
    "babel-preset-latest": "^6.24.1",
    "eslint": "^5.10.0",
    "rollup-plugin-babel": "^3.0.2",
    "rollup-plugin-node-resolve": "^3.0.0",
    "rollup-plugin-uglify": "^2.0.1",
    "uglify-es": "^3.1.3"
  }

安装最新版本我不能确保你会不会中途报错。

创建文件

  • .eslintrc.js
  • .babelrc
  • .npmignore
  • rollup.config.js
.eslintrc.js

eslint配置有很多,这里我使用了我比较习惯的方式 .eslintrc.js ,里面有中文注释,没怎么用过eslint的小伙伴可以进来看看。

.babelrc

这是 rollup 官方文档推荐的配置:

{
  "presets": [
    ["latest", {
      "es2015": {
        "modules": false
      }
    }]
  ],
  "plugins": ["external-helpers"]
}
.npmignore

这个文件可以把你不想到 npm 文件或文件夹屏蔽掉,随意发挥吧。

.DS_Store
.git
__mocks__
node_modules
rollup.config.js
import resolve from 'rollup-plugin-node-resolve';
import babel from 'rollup-plugin-babel';
import uglify from 'rollup-plugin-uglify';
import { minify } from 'uglify-es';

export default {
  input: './index.js',
  output: [{
    file: `./dist/x-music.min.js`,
    name: `XMusic`,
    format: 'umd'
  },{
    file: `./dist/x-music.es.min.js`,
    format: 'es'
  }],
  plugins: [
    resolve(),
    babel({
      exclude: 'node_modules/**'
    }),
    uglify({}, minify)
  ]
};

顺便修改一下package.json

"scripts": {
    "build": "rollup -c"
  },

这样使用 npm run build 就可以打包了。

使用 ES6 编写插件核心代码

这块并不是本文的核心,想看代码的可以看这里

发布到 npm

如果你还没有 npm 账户,请注册,然后在终端里输入指令:

  $ npm login

输入你的账户邮件和密码,然后通过指令:

  $ npm publish

就会被上传到 npm。

如果你希望别人也使用你的插件,最好在 README.md 中写好使用文档。


最后还是安利一下自己的项目【X-BUILD】,希望大家给几颗宝贵的star,让我简历好看点~

Github: https://github.com/codexu/

X-BUILD文档: https://codexu.github.io/

点赞
收藏
评论区
推荐文章
blmius blmius
4年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
美凌格栋栋酱 美凌格栋栋酱
7个月前
Oracle 分组与拼接字符串同时使用
SELECTT.,ROWNUMIDFROM(SELECTT.EMPLID,T.NAME,T.BU,T.REALDEPART,T.FORMATDATE,SUM(T.S0)S0,MAX(UPDATETIME)CREATETIME,LISTAGG(TOCHAR(
Karen110 Karen110
4年前
一篇文章带你了解JavaScript日期
日期对象允许您使用日期(年、月、日、小时、分钟、秒和毫秒)。一、JavaScript的日期格式一个JavaScript日期可以写为一个字符串:ThuFeb02201909:59:51GMT0800(中国标准时间)或者是一个数字:1486000791164写数字的日期,指定的毫秒数自1970年1月1日00:00:00到现在。1\.显示日期使用
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
Jacquelyn38 Jacquelyn38
4年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
Karen110 Karen110
4年前
​一篇文章总结一下Python库中关于时间的常见操作
前言本次来总结一下关于Python时间的相关操作,有一个有趣的问题。如果你的业务用不到时间相关的操作,你的业务基本上会一直用不到。但是如果你的业务一旦用到了时间操作,你就会发现,淦,到处都是时间操作。。。所以思来想去,还是总结一下吧,本次会采用类型注解方式。time包importtime时间戳从1970年1月1日00:00:00标准时区诞生到现在
Wesley13 Wesley13
3年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Wesley13 Wesley13
3年前
Java日期时间API系列36
  十二时辰,古代劳动人民把一昼夜划分成十二个时段,每一个时段叫一个时辰。二十四小时和十二时辰对照表:时辰时间24时制子时深夜11:00凌晨01:0023:0001:00丑时上午01:00上午03:0001:0003:00寅时上午03:00上午0
Wesley13 Wesley13
3年前
00:Java简单了解
浅谈Java之概述Java是SUN(StanfordUniversityNetwork),斯坦福大学网络公司)1995年推出的一门高级编程语言。Java是一种面向Internet的编程语言。随着Java技术在web方面的不断成熟,已经成为Web应用程序的首选开发语言。Java是简单易学,完全面向对象,安全可靠,与平台无关的编程语言。
Python进阶者 Python进阶者
1年前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这