快速入门

FIS是专为解决前端开发中自动化工具、性能优化、模块化框架、开发规范、代码部署、开发流程等问题的工具框架。

使用FIS我们可以快速的完成各种前端项目的资源压缩、合并等等各种性能优化工作,同时FIS还提供了大量的开发辅助功能

首先我们了解一下FIS的基本命令

  • fis install: 此命令安装一些公共库组件比如 jQuery、echarts,我们提供的组件都放在 https://github.com/fis-components 仓库中。
  • fis release: 命令用于编译并发布的你的项目,拥有多个参数调整编译发布操作。
  • fis server: 命令可以启动一个本地调试服务器用于预览fis release产出的项目。下面这张图描述了FIS的整个使用流程

快速入门 - 图1

接下来我们可以通过快速入门进一步的了解FIS。

准备工作

快速入门除了文档外,我们还提供了视频教程,欢迎大家观看,看到最后有彩蛋哟-`д´- 传送门

工具安装

FIS使用Node.js开发,以npm包的形式发布。因此使用FIS需要先安装Node.js,再通过npm安装命令进行FIS安装。

  1. npm install -g fis

安装遇到困难?点击这里

示例准备

在介绍FIS的主要功能前,需要先准备一个示例项目。可以从Github上获取。

  1. git clone https://github.com/hefangshi/fis-quickstart-demo.git

本地预览

首先我们可以通过 fis server start 命令启动FIS的本地调试服务器功能对构建发布的项目进行预览调试

  1. fis server start

注意

  • 如果8080端口被占用,可以通过 fis server start -p [port] 指定新的端口。

  • 如果没有java、php环境,可以通过 fis server start —type node 启动Node版fis server。

  • 命令执行后内置服务器会一直运行,可以通过 fis server stop 命令关闭内置服务器。

本地调试服务器启动成功后,就会自动打开 http://127.0.0.1:8080 ,但是此时服务器内没有任何内容。我们还需要通过FIS发布DEMO项目才能进行预览

  1. cd fis-quickstart-demo #进入DEMO目录
  2. fis release #编译并发布DEMO

fis release 命令会将编译后的项目发布至本地调试服务器,再次刷新浏览器页面,我们就可以到fis-quickstart-demo项目的主页了。

资源压缩

资源压缩一直是前端项目优化中非常重要的一环,使用FIS我们无需任何配置,只需要一个命令就可以完成压缩工作。

  1. fis release --optimize

如果觉得参数输入比较麻烦,实际上也支持参数缩写,更多的参数可以参考 fis release -h命令行

  1. fis release -o

FIS构建并不会修改源代码目录中的内容,而是拥有独立的产出的目录,FIS默认的产出目构录可以通过 fis server open 打开,你也可以通过 fis release -d <path/to/output> 指定你希望的输出目录,详情可以参考FAQ

<path/to/output> 你想输出到的文件夹路径,你可以随意指定,比如 ./output../outputD:\output

查看一下网站的静态资源,我们会发现脚本、样式、图片资源都已经压缩完成。无需额外的插件和配置编写,一条命令就完成了压缩工作,是不是非常方便快捷?

FIS默认会调整所有资源引用的相对路径为绝对路径,如果只是单纯的希望对项目的脚本、样式、图片进行压缩,不希望对资源引用地址做调整,可以直接使用基于FIS封装的spt

添加文件版本(md5戳)

FIS能够根据静态资源的内容自动生成文件版本,自动更新资源引用路径,解决缓存更新问题,告别手动更新时间戳。

我们通过开启 —md5 参数,为项目中的静态资源添加md5版本号

  1. fis release --optimize --md5 # fis release -om

刷新页面,我们可以看到所有资源均加上了md5版本号

资源压缩

还是喜欢时间戳?没问题,FIS也可以满足你的需求,点击这里

资源合并

设置打包

FIS可以通过pack来进行资源文件的合并,比如我们需要将DEMO中的公共库文件打包在一起,可以修改 fis-conf.js 配置,加入pack配置

  1. fis.config.set('pack', {
  2. '/pkg/lib.js': [
  3. 'js/lib/jquery.js',
  4. 'js/lib/underscore.js',
  5. 'js/lib/backbone.js',
  6. 'js/lib/backbone.localStorage.js',
  7. ]
  8. });

设置完pack后,FIS默认只会进行文件打包,不会对页面中的静态资源引用进行替换,我们可以通过引入后端静态资源管理来加载打包模块。不过也可以利用fis-postpackager-simple插件,可以自动将页面中独立的资源引用替换为打包资源。

插件安装

FIS的编译系统拥有一个使用简单、扩展方便的插件体系,这套插件体系保证了FIS编译工具的灵活性和生命力。这里我们简单介绍一下FIS插件的安装方法,更加详细的插件系统介绍可以查看配置API modules

插件的安装分为两步,首先我们需要通过npm包管理工具进行插件安装

  1. npm install -g fis-postpackager-simple

fis-postpackager-simple插件是提供给纯前端应用的打包合并插件,其他定制解决方案,如fis-plusyogurt等不需要这个插件,需要查看各自的文档了解使用方式。

插件安装到本地后,我们还需要通过项目配置文件开启插件,修改项目根目录下的fis-conf.js配置,开启fis-postpackager-simple插件

  1. cd fis-quickstart-demo
  2. vi fis-conf.js #vi是linux下的文本编辑器,windows用户可以选用任意文本编辑器对fis-conf.js文件进行编辑。
  1. //file : fis-conf.js
  2. fis.config.set('modules.postpackager', 'simple');

应用打包

为了开发调试时更加方便 fis release 默认不会合并资源,在指定了 —pack 参数后,FIS才会进行打包合并处理。

  1. fis release --optimize --md5 --pack # fis release -omp

再次浏览我们可以发现原有的基础类库引用已经被替换为了 lib.js ,关于fis-postpackager-simple插件更多的静态资源处理策略和使用方法,请参考fis-postpackager-simple

资源合并

自动打包

利用simple插件,我们还可以按页面进行自动合并,将没有通过pack设置打包的零散资源自动合并起来。

  1. //file : fis-conf.js
  2. //开启autoCombine可以将零散资源进行自动打包
  3. fis.config.set('settings.postpackager.simple.autoCombine', true);

再次运行FIS构建项目

  1. fis release -omp

我们会发现剩余的零散资源已经被自动合并了。

自动合并

合并图片

通过上述几个步骤,我们已经成功将脚本资源和样式表资源进行了合并,但是为了进一步的减少HTTP连接数,我们还可以对引用的图片资源进行进一步的合并。

在FIS中,如果样式文件中引用图片时,添加了 ?__sprite query,那么将样式文件使用 pack 设置进行合并后,不仅仅会合并样式文件,还会将所有标识了合并的图片进行合并处理。

我们通过 pack 设置,将所有样式文件合并为 aio.css

  1. fis.config.set('pack', {
  2. '/pkg/lib.js': [
  3. 'js/lib/jquery.js',
  4. 'js/lib/underscore.js',
  5. 'js/lib/backbone.js',
  6. 'js/lib/backbone.localStorage.js',
  7. ],
  8. '/pkg/aio.css': '**.css'
  9. });

关于图片合并,更详细的使用方法可以参考使用文档

再次运行FIS构建项目

  1. fis release -omp

刷新一下,添加几个待办项,我们会发现所有待办项的图片都合并在了一张图片中。

图片合并

问题反馈

如果在使用过程中遇到了无法解决的问题,可以先查看一下FAQ,我们会定期收集经常被提到的问题。

如果FAQ中也无法找到答案,我们也提供多种渠道解决你的问题。

  • 在Github中提交Issue
  • 在文档评论中提问

下一步

  • 阅读辅助开发了解除了构建能力外,FIS提供的文件监听、自动编译、自动刷新等开发辅助能力。
  • 阅读命令行全面了解FIS命令行参数。
  • 阅读语言能力了解FIS的语言扩展能力。
  • 阅读配置API了解FIS完整的功能配置,由于内容较多,可以先大概浏览内容,使用时再详细查阅。
  • 有兴趣的同学还可以阅读更多文档了解FIS的基础原理与设计思想,让你可以更好的理解和使用FIS打造自己解决方案。FIS完全开源并托管在Github,欢迎大家Star、关注FIS的项目主页,大家的支持是我们最大的动力;)

本文提到的