1.基本操作
安装
代码语言:javascript复制npm i -g rollup
打包成文件
代码语言:javascript复制rollup src/main.js -o bundle.js -f cjs
等价于
代码语言:javascript复制rollup src/main.js -f cjs > bundle.js
需要注意的是参数 -f
是 --output.format
的缩写,用来指定 bundle
的类型,有以下选项:
amd:amd规范
cjs:CommonJS规范
es:es规范
iife:立即执行函数
umd:umd规范(语法糖)
2.使用配置文件
默认文件名称为 rollup.config.js
,
基本使用
代码语言:javascript复制export default{
input: "src/main.js",
output: {
file: "bundle.js",
format: "cjs"
}
}
打包:
代码语言:javascript复制rollup -c
等价于
代码语言:javascript复制rollup --config
使用插件
通过在配置文件中使用 plugins
字段添加插件。
如:
- 使用
rollup-plugin-json
插件来处理json文件 - 使用
rollup-plugin-node-resolve
插件来处理外部模块(rollup默认无法处理外部模块,也就是说无法解析打包从npm上下载使用的包,使用这个插件可以帮助我们使用) - 使用
rollup-plugin-commonjs
来处理导入的commonjs模块的包(rollup默认只支持ES6模块的包) - 使用
rollup-plugin-babel
来支持babel
import json from 'rollup-plugin-json'
import resove from 'rollup-plugin-node-resolve'
import babel from 'rollup-plugin-babel'
export default {
input: 'src/main.js',
output: {
file: 'bundle.js',
format: 'umd',
name: 'roll',
},
plugins: [
json(),
resove(),
babel({
exclude: 'node_modules/**'
})
]
}
处理外部引用
有时候一些外部引用的库我们并不想一并打包在我们的库中,如:lodash、react,可以在配置文件中使用 external
字段来告诉rollup不要将这些库打包
export default {
// ...
external: ['lodash']
}
3.使用JavaScript API
rollup提供了JavaScript接口以便于通过Node.js来使用。
rollup.rollup
此函数范湖一个Promise,解析一个bundle对象,此对象带有不同的属性与方法,官网示例:
rollup.watch
检测磁盘上单个模块改变时,重新构建bundle,使用命令行时带上 --watch
参数,这个函数会在内部使用。
4.使用实例分析
dayjs
首先我们需要知道的是dayjs需要打包的文件有dayjs核心库、dayjs的plugins、dayjs的本地化文件三类文件。
从 package.json
文件中看到dayjs的build script实际上执行的build文件夹下的的 index.js
文件。
在 build
文件夹下有 index.js
文件和 rollup.config.js
两个文件,很显然,这个 rollup.config.js
文件就是rollup的配置文件。
这个配置文件如下:
代码语言:javascript复制const babel = require('rollup-plugin-babel')
const uglify = require('rollup-plugin-uglify')
module.exports = (config) => {
const { input, fileName, name } = config
return {
input: {
input,
external: [
'dayjs'
],
plugins: [
babel({
exclude: 'node_modules/**'
}),
uglify()
]
},
output: {
file: fileName,
format: 'umd',
name: name || 'dayjs',
globals: {
dayjs: 'dayjs'
}
}
}
}
这里导出的是一个接受config参数的函数,可以想到这个函数是会在 index.js
中使用的,并且从解构赋值中可以知道config参数允许外部自定义input、输出的文件名fileName、umd使用的模块名。
这里使用了 rollup-plugin-babel
来配合使用babel,使用 rollup-plugin-uglify
插件来压缩js文件。
接下来看下 index.js
文件内容:
const rollup = require('rollup')
const configFactory = require('./rollup.config')
const fs = require('fs')
const util = require('util')
const path = require('path')
const { promisify } = util
const promisifyReadDir = promisify(fs.readdir)
const formatName = n => n.replace(/.js/, '').replace('-', '_')
async function build(option) {
const bundle = await rollup.rollup(option.input)
await bundle.write(option.output)
}
(async () => {
try {
const locales = await promisifyReadDir(path.join(__dirname, '../src/locale'))
locales.forEach((l) => {
build(configFactory({
input: `./src/locale/${l}`,
fileName: `./locale/${l}`,
name: `dayjs_locale_${formatName(l)}`
}))
})
const plugins = await promisifyReadDir(path.join(__dirname, '../src/plugin'))
plugins.forEach((l) => {
build(configFactory({
input: `./src/plugin/${l}`,
fileName: `./plugin/${l}`,
name: `dayjs_plugin_${formatName(l)}`
}))
})
build(configFactory({
input: './src/index.js',
fileName: './dayjs.min.js'
}))
} catch (e) {
console.error(e) // eslint-disable-line no-console
}
})()
可以看到作者将打包功能专门抽出来作为一个 build
函数,之后读取plugin、locale文件夹中的文件然后每个文件单独打包,之后打包核心模块文件dayjs文件,在这里使用 JavaScript API
的作用非常明显就是实现了一个命令打包多个文件。
hyperapp
hyperapp的目的只有一个就是打包src/index.js文件,因此功能也不要太强大,所以作者直接使用命令行即可。
5.完整参数配置
rollup完整参数可以在官网查询https://rollupjs.org/guide/zh#big-list-of-options