ECharts官方教程(二)【自定义构建 ECharts】
一般来说，可以直接从 echarts 下载页 中获取构建好的 echarts，也可以从 GitHub 中的 echarts/dist 文件夹中获取构建好的 echarts，这都可以直接在浏览器端项目中使用。这些构建好的 echarts 提供了下面这几种定制：
- 完全版：
echarts/dist/echarts.js，体积最大，包含所有的图表和组件，所包含内容参见：echarts/echarts.all.js。 - 常用版：
echarts/dist/echarts.common.js，体积适中，包含常见的图表和组件，所包含内容参见：echarts/echarts.common.js。 - 精简版：
echarts/dist/echarts.simple.js，体积较小，仅包含最常用的图表和组件，所包含内容参见：echarts/echarts.simple.js。
如果对文件体积有更严苛的要求，可以自己构建 echarts，能够仅仅包括自己所需要的图表和组件。自定义构建有几种方式：
- 在线自定义构建：比较方便。
- 使用
echarts/build/build.js脚本自定义构建：比在线构建更灵活一点，并且支持多语言。 - 直接使用构建工具（如 rollup、webpack、browserify）自己构建：也是一种选择。
下面我们举些小例子，介绍后两种方式。
准备工作：创建自己的工程和安装 echarts
使用命令行，创建自己的工程：
mkdir myProject
cd myProject在 myProject 目录下使用命令行，初始化工程的 npm 环境并安装 echarts（这里前提是您已经安装了 npm）：
npm init
npm install echarts --save通过 npm 安装的 echarts 会出现在 myProject/node_modules 目录下，从而可以直接在项目代码中得到 echarts，例如：
使用 ES Module：
import * as echarts from 'echarts';使用 CommonJS：
var echarts = require('echarts')下面仅以使用 ES Module 的方式来举例。
使用 echarts 提供的构建脚本自定义构建
在这个例子中，我们要创建一个饼图，并且想自定义构建一个只含有饼图的 echarts 文件，从而能使 echarts 文件的大小比较小一些。
echarts 已经提供了构建脚本 echarts/build/build.js，基于 Node.js 运行。我们可以在 myProject 目录下使用命令行，看到它的使用方式：
node node_modules/echarts/build/build.js --help其中我们在这个例子里会用到的参数有：
-i：代码入口文件，可以是绝对路径或者基于当前命令行路径的相对路径。
-o：生成的 bundle 文件，可以是绝对路径或者基于当前命令行路径的相对路径。
--min：是否压缩文件（默认不压缩），并且去多余的打印错误信息的代码，形成生产环境可用的文件。
--lang ：是否使用其他语言版本，默认是中文。例如：--lang en 表示使用英文，--lang my/langXX.js 表示构建时使用 /my/langXX.js 替代 echarts/lib/lang.js 文件。
--sourcemap：是否输出 source map，以便于调试。
--format：输出的格式，可选 'umb'（默认）、'amd'、'iife'、'cjs'、'es'。
既然我们想自定义构建一个只含有饼图的 echarts 文件，我们需要创建一个入口文件，可以命名为 myProject/echarts.custom.js，文件里会引用所需要的 echarts 模块：
// 引入 echarts 主模块。
export * from 'echarts/src/echarts';
// 引入饼图。
import 'echarts/src/chart/pie';
// 在这个场景下，可以引用 `echarts/src` 或者 `echarts/lib` 下的文件（但是不可混用），
// 参见下方的解释：“引用 `echarts/lib/**` 还是 `echarts/src/**`”。然后我们可以在 myProject 目录下使用命令行，这样开始构建：
node node_modules/echarts/build/build.js --min -i echarts.custom.js -o lib/echarts.custom.min.js这样，myProject/lib/echarts.custom.min.js 就生成了。我们可以创建 myProject/pie.html 来使用它：
<html>
<head>
<meta charset="utf-8">
<title>myProjecttitle>
<script src="lib/echarts.custom.min.js">script>
head>
<body>
<div id="main" style="width: 600px;height:400px;">div>
<script>
// 绘制图表。
echarts.init(document.getElementById('main')).setOption({
series: {
type: 'pie',
data: [
{name: 'A', value: 1212},
{name: 'B', value: 2323},
{name: 'C', value: 1919}
]
}
});
script>
body>
html>然后在浏览器里打开 myProject/pie.html，就可以看到一个饼图：
允许被引用的模块
在自定义构建中，允许被引用的模块，全声明在 myProject/node_module/echarts/echarts.all.js 和 myProject/node_module/echarts/src/export.js 中。echarts 和 zrender 源代码中的其他模块，都是 echarts 的内部模块，不应该去引用。因为在后续 echarts 版本升级中，内部模块的接口和功能可能变化，甚至模块本身也可能被移除。
引用 echarts/lib/** 还是 echarts/src/**
- 项目中如果直接引用 echarts 里的一些模块并自行构建，应该使用
echarts/lib/**路径，而不可使用echarts/src/**。 - 当使用构建脚本
echarts/build/build.js打包 bundle，那么两者可以选其一使用（不可混用），使用echarts/src/** 可以获得稍微小一些的文件体积。
原因是：目前，
echarts/src/**中是采用 ES Module 的源代码，echarts/lib/**中是echarts/src/**编译成为 CommonJS 后的产物（编译成 CommonJS 是为了向后兼容一些不支持 ES Module 的老版本 NodeJS 和 webpack）。 因为历史上，各个 echarts 扩展、各个用户项目，一直是使用的包路径是echarts/lib/**，所以这个路径不应该改变，否则，可能导致混合使用echarts/src/**和echarts/lib/**得到两个不同的 echarts 名空间，造成问题。而使用echarts/build/build.js打包 bundle时没有涉及这个问题，echarts/src/**中的 ES Module 便于静态分析从而得到稍微小些的文件体积。
直接使用 rollup 自定义构建
上文中介绍了如何使用 echarts 提供的脚本echarts/build/build.js自定义构建。与此并列的另一种选择是，我们直接使用构建工具（如 rollup、webpack、browserify）自定义构建，并且把 echarts 代码和项目代码在构建成一体。在一些项目中可能需要这么做。下面我们仅仅介绍如何使用 rollup 来构建。webpack 和 browserify 与此类同，不赘述。
首先我们在 myProject 目录下使用 npm 安装 rollup：
npm install rollup --save-dev
npm install rollup-plugin-node-resolve --save-dev
npm install rollup-plugin-uglify --save-dev接下来创建项目 JS 文件 myProject/line.js 来绘制图表，内容为：
// 引入 echarts 主模块。
import * as echarts from 'echarts/lib/echarts';
// 引入折线图。
import 'echarts/lib/chart/line';
// 引入提示框组件、标题组件、工具箱组件。
import 'echarts/lib/component/tooltip';
import 'echarts/lib/component/title';
import 'echarts/lib/component/toolbox';
// 基于准备好的dom，初始化 echarts 实例并绘制图表。
echarts.init(document.getElementById('main')).setOption({
title: {text: 'Line Chart'},
tooltip: {},
toolbox: {
feature: {
dataView: {},
saveAsImage: {
pixelRatio: 2
},
restore: {}
}
},
xAxis: {},
yAxis: {},
series: [{
type: 'line',
smooth: true,
data: [[12, 5], [24, 20], [36, 36], [48, 10], [60, 10], [72, 20]]
}]
});对于不支持 ES Module 的浏览器而言，刚才创建的myProject/line.js 还不能直接被网页引用并在浏览器中运行，需要进行构建。使用 rollup 构建前，需要创建它的配置文件myProject/rollup.config.js，内容如下：
// 这个插件用于在 `node_module` 文件夹（即 npm 用于管理模块的文件夹）中寻找模块。比如，代码中有
// `import 'echarts/lib/chart/line';` 时，这个插件能够寻找到
// `node_module/echarts/lib/chart/line.js` 这个模块文件。
import nodeResolve from 'rollup-plugin-node-resolve';
// 用于压缩构建出的代码。
import uglify from 'rollup-plugin-uglify';
// 用于多语言支持（如果不需要可忽略此 plugin）。
// import ecLangPlugin from 'echarts/build/rollup-plugin-ec-lang';
export default {
name: 'myProject',
// 入口代码文件，就是刚才所创建的文件。
input: './line.js',
plugins: [
nodeResolve(),
// ecLangPlugin({lang: 'en'}),
// 消除代码中的 __DEV__ 代码段，从而不在控制台打印错误提示信息。
uglify()
],
output: {
// 以 UMD 格式输出，从而能在各种浏览器中加载使用。
format: 'umd',
// 输出 source map 便于调试。
sourcemap: true,
// 输出文件的路径。
file: 'lib/line.min.js'
}
};然后在 myProject 目录下使用命令行，构建工程代码myProject/line.js：
./node_modules/.bin/rollup -c其中 -c 表示让 rollup 使用我们刚才创建的
myProject/rollup.config.js文件作为配置文件。
构建生成的 myProject/lib/line.min.js 文件包括了工程代码和 echarts 代码，并且仅仅包括我们所需要的图和组件，并且可以在浏览器中使用。我们可以用一个示例页面来测试一下，创建文件myProject/line.html，内容如下：
<html>
<head>
<meta charset="utf-8">
<title>myProjecttitle>
head>
<body>
<div id="main" style="width: 600px;height:400px;">div>
<script src="lib/line.min.js">script>
body>
html>在浏览器里打开 myProject/line.html 则会得到如下效果：
多语言支持
上面的例子中能看到，工具箱组件（toolbox）的提示文字是中文。本质上，echarts 图表显示出来的文字，都可以通过 option 来定制，改成任意语言。但是如果想“默认就是某种语言”，则需要通过构建来实现。
在上面的例子中，可以在 echarts/build/build.js 的参数中指定语言：
node node_modules/echarts/build/build.js --min -i echarts.custom.js -o lib/echarts.custom.min.js --lang en表示使用内置的英文。此外还可以是 --lang fi。
node node_modules/echarts/build/build.js --min -i echarts.custom.js -o lib/echarts.custom.min.js --lang my/langXX.js表示在构建时使用 myProject/my/langXX.js 文件来替换myProject/node_modules/echarts/lib/lang.js 文件。这样可以在 myProject/my/langXX.js 文件中自定义语言。注意这种方式中，必须指定 -o 或者 --output。
另外，上面的 rollup 插件 echarts/build/rollup-plugin-ec-lang 也可以传入同样的参数，实现同样的功能。