Rollup —— 适合框架和类库使用的模块打包器

522 阅读7分钟

目录

  • Rollup概述
    • Rollup vs Webpack
  • 快速上手
  • 配置文件
  • 插件
    • rollup-plugin-json
    • rollup-plugin-node-resolve(加载npm模块)
    • rollup-plugin-commonjs
  • Code Splitting(代码拆分)
    • Dynamic Imports(动态导入)
  • 多入口打包
    • amd输出格式要注意什么?
  • 指令参数参考大全

这篇文章目前旨在简单了解Rollup是什么并且如何上手操作,之后会再进行深入分析。

Rollup概述

Rollup仅仅是一款JavaScript 模块打包器,也称为ESM打包器,并没有像webpack那样有很多其他额外的功能,它可以将项目中散落的细小模块打包成整块的代码,可以让他们更好的运行在浏览器环境 or Node.js环境 ,目前Vue2.0源码使用的打包器就是Rollup

Rollup vs Webpack

RollupWebpack作用类似,但是Rollup更为小巧,webpack可以在前端开发中完成前端工程化的绝大多数功能,而Rollup仅仅是一款ESM打包器,并没有其他额外的功能。

Rollup中并不支持类似HMR这种高级特性。但是Rollup诞生的目的并不是要与webpack全面竞争,其初衷只是提供一个高效的ES Modules的打包器,充分利用ESM的各项特性构建出结构比较扁平,性能比较出众的类库。

快速上手

  1. 下载模板 Rollup-firstdemo-temp

  2. 安装模块npm i rollup -g

  3. 在命令行中执行rollup ./src/index.js --format iife --file dist/bundle.js可以看到在输出目录中有了一个文件夹,里面的文件输出的文件很干净整洁,并且没有引用的模块并没有打包进去(自带Tree-shaking

  • --format —— 指定输出文件打包格式,例如:iife是自调用函数
  • --file —— 输出文件,后面跟打印路径,不写会打印到控制台

配置文件

创建名称为rollup.config.js文件,同样运行在node.js环境中,因为Rollup会单独处理这个文件,所以我们可以直接使用ES Module

  1. 在文件中编辑
// rollup.config.js
// 这个文件中会导出一个配置对象
export default {
  // input 是打包入口文件路径
  input: 'src/index.js',
  // 输出配置
  output: {、
    // 输出路径及文件名
    file: 'dist/bundle.js',
    // 输出格式
    format: 'iife'
  }
}
  1. 使用命令行要添加--config说要使用配置文件rollup --config,默认是不使用配置文件的。

  2. rollup --config <filename>后面可以指定配置文件的名称,默认是rollup.config.js,也可以自己指定别的文件名。

插件

如果要加载其他类型的资源文件,或者是导入CommonJS模块,或者编译ES6新特性,Rollup同样支持使用插件的方式扩展。

插件是Rollup唯一扩展途径,这个与webpack有所不同,webpackpluginsmoduleoptimization三种途径。

rollup-plugin-json

rollup-plugin-json是一个导入JSON文件的插件。

  1. 安装插件 npm i rollup-plugin-josn --save-dev
  2. rollup-plugin.js中配置插件
// 默认导出是一个插件函数
import json from 'rollup-plugin-json'
export default {
  input: 'src/index.js',
  output: {
    file: 'dist/bundle.js',
    format: 'iife'
  },
  plugins: [
    // 是调用结果放在数组中,而不是函数放进去
    json()
  ]
}
  1. src/index.js中调用,打包之后可以看到json里面的变量已经打包进来了。
// 导入模块成员
import { log } from './logger'
import { name, version} from '../package.json'

log(name) // var name = "first";
log(version) // var version = "1.0.0";

rollup-plugin-node-resolve(加载npm模块)

rollup默认只能按照路径的方式加载本地模块,对于第三方模块并不能想webpack一样通过名称导入,所以需要通过插件处理。

  1. 安装插件 npm i rollup-plugin-node-resolve --save-dev
  2. rollup-plugin.js中配置插件
// 默认导出是一个插件函数
import json from 'rollup-plugin-json'
import resolve from 'rollup-plugin-node-resolve'
export default {
  ...
  plugins: [
    // 是调用结果放在数组中,而不是函数放进去
    json(),
    resolve()
  ]
}
  1. 准备一个第三方模块进行安装npm i lodash-es
  2. src/index.js中调用,可以看到lodash-es的相关代码也导入进去了
// 导入模块成员,这里可以使用node名称来导入而不是路径
import _ from 'lodash-es'
import { log } from './logger'

log(_.camelCase('hello world'))

PS: 这里使用lodashES Modules版本而不是其他版本的原因是因为rollup默认只能处理ES Modules模块,如果要引用其他版本我们需要做额外的处理。

rollup-plugin-commonjs

加载CommonJS模块,目前还是有大量的npm模块使用CommonJS的方式导入成员,为了兼容就有了这个官方插件。

  1. 安装插件npm i rollup-plugin-commonjs --save-dev
  2. rollup-plugin.js中配置插件
import commonjs from 'rollup-plugin-commonjs'
export default {
  ...
  plugins: [
    commonjs()
  ]
}
  1. 在src中新建文件cjs.module.js,编写文件
module.exports = {
  foo: bar
}
  1. src/index.js中引入,可以看到变量已经打包进去。
// 导入模块成员
import { log } from './logger'
import cjs from './cjs.module'

log(cjs)

/* var cjs_module = {
    foo: bar
  };
*/  

Code Splitting(代码拆分)

Dynamic Imports(动态导入)

动态导入,rollup内部会自动处理代码分包, 代码拆分

  1. src/index.js中引入
// import函数返回一个promise对象
// then方法参数是module,由于模块导出的成员都会放在module对象中,所以可以通过解构的方式提取log
import('./logger').then(({ log }) => {
  log('code splitting~')
})  
  1. 修改roll.config.jsoutput里面的配置
export default {
  // input 是打包入口文件路径
  input: 'src/index.js',
  // 输出配置
  output: {
    // 输出目录名称
    dir: 'dist',
    // 输出格式
    format: 'amd'
  }
}

不修改配置文件直接运行rollup --config会报错

UMDiife 是不支持代码拆分方式格式,因为自执行函数会把所有的模块都放到一个函数中,并没有像webpack一样有一些引导代码,所以没有办法做到代码拆分

如果要使用代码拆分,就需要使用AMD or CommonJS等方式。在浏览器中只能使用AMD的方式,所以这里改用输出格式为AMD

况且我们拆分代码输出不同的文件,file属性只是针对一个文件,所以我们需要改用dir去指定文件夹名称,不然还是会报错

  1. 运行代码rollup --config可以看到dist文件夹里面有两个拆分打包的文件。

多入口打包

rollup支持多入口打包,对于不同文件的公共部分也会自动提取到单个文件中作为独立的bundle.js

  1. 模板中将多入口打包的代码开启,可以看到albumindex都引用了fetch.jslogger.js的代码,我们对rollup.config.js进行修改
export default {
  // 这里input要改成数组形式或者对象形式,对象形式可以修改打包的文件名,键对应的就是打包的文件名
  // input: ['src/index.js', 'src/album.js'],
  input: {
    indexjs: 'src/index.js',
    albumjs: 'src/album.js'
  },
  // 输出配置要改成拆分包的配置,以为多入口打包默认会执行打包拆分的特性。所以输出格式要改成amd
  output: {
    dir: 'dist',
    format: 'amd'
  }
}
  1. 命令行执行rollup --config 可以看到dist里面生成了三个文件,其中两个文件打包和一个公共模块的打包,里面包含了loggerfetch模块

amd输出格式要注意什么?

对于amd输出格式的打包文件是不能直接引用到页面上,必须通过实现AMD标准的库去加载。

尝试使用一下

  1. dist下面生成一个HTML文件,尝试引入requirejs
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
 <!--requirejs的cdn地址,data-main是入口文件的名称-->
  <script src="https://unpkg.com/requirejs@2.3.6/bin/r.js" data-main="albumjs.js"></script>
</body>
</html>
  1. 浏览器打开可以看到内容正常引入,控制台也正常工作。

指令参数参考大全

  • --format —— 指定输出文件打包格式,例如:iife是自调用函数
  • --file —— 输出文件,后面跟打印路径,不写会打印到控制台
  • --config —— 指定使用配置文件,后面可以加指定配置文件的名称,rollup --config <filename>,默认是rollup.config.js