我们先来看下前端开发可能存在的问题:
- 我们有许多的第三方库的依赖需要管理;
- 我们有独立的前端测试需要自动运行;
- 我们还有很多代码需要在发布时进行打包压缩;
- ??
所以构建一个自动化的前端开发流程是非常必要的,但现在前端开发流程的构建是百花齐放,没有一个统一的标准,还有很多依赖于后端的架构来做前端开发管理。例如在Rails开发中,就有各种前端库的gem包。但是这种依赖于后端框架的管理方式有许多问题:
- 许多gem包的维护者并不是前端库的维护者,所以更新不一定即时;
- 不利于前端代码与后端代码做分离;
- 增加了前端开发者的学习和使用成本;
- ??
于是现在出现了一些不依赖于后端代码(虽然还是要依赖Node.js??)的管理工具,对于前端开发者非常友好,例如:YEMAN、Jam、volo、component、Brunch??但是这些工具都或多或少有自己的一些问题,所以我决定用一些更轻量的工具(bower、grunt)来搭建自己的前端开发流程。本文的例子来自本人正在开发的一个项目,可以在github上查看所有的代码。
什么是开发流程?
在我看来一个完整的开发流程应该包括:
- 本地开发环境的初始化
- 第三方依赖的管理
- 源文件编译
- 自动化测试
- 发布到pipeline和各个环境
而现代的开发流程,就是要使上面的各个部分都可以自动化,一个命令就可以使这些流程都自动走完,并且快速的得到错误或通过的反馈,让我们可以方便快速的修复错误和release。
本地开发环境的初始化
这里我使用的工具是Node.js和NPM,它们都基于JavaScript,使用Json来配置,对于前端开发人员非常友好。
安装完成Node.js和NPM后,在项目根目录下创建NPM的配置文件package.json:
{ "name": "Project Name", "version": "0.0.1", "description": "Project Description", "repository": { "type": "git", "url": "git://github.com/path/to/your_project" }, "author": "Author Name", "license": "BSD", "readmeFilename": "README.md", "gitHead": "git head", "devDependencies": { "grunt": "latest", "grunt-contrib-connect": "latest", "grunt-contrib-concat": "latest", "grunt-contrib-jasmine": "latest", "grunt-contrib-watch": "latest", "grunt-contrib-compass": "latest" } }
其中最重要的一个配置项是devDependencies,这是用于开发的依赖,例如:自动化测试、源文件编译等等,其中各个依赖的作用和用法将会在后面讲到。而前端生产代码的依赖会使用另一个工具来管理,也在后面讲到。创建完成以后运行npm install,NPM就会将这些依赖都安装到项目根目录的node_modules文件夹中。
第三方依赖的管理
这里我使用的工具是bower。其实NPM也可以管理,但是NPM并不是读取第三方依赖原始的repository,而是读取自己管理的一个repository,所以更新可能会慢点,并且它使用CommonJS的接口方便Node.js项目的开发,并不是针对纯前端开发的项目;而bower是读取原始的github repository,没有更新延迟的问题,所有包都是针对纯前端开发项目的。
要使用bower只需要简单的三步:
- 安装:npm install bower -g
- 在项目根目录中创建配置文件.bowerrc
- 在项目根目录中创建依赖配置文件components.json
我们首先来看看.bowerrc的内容:
{ "directory" : "components", "json" : "component.json", "endpoint" : "https://bower.herokuapp.com" }
其中directory指定了所有的依赖会被安装到哪里;json指定了依赖配置文件的路径;endpoint制定了依赖的repository的寻址服务器,你可以替换为自己的寻址服务器。
然后我们来看看components.json的内容:
{ "name": "Project Name", "version": "0.0.1", "dependencies": { "jquery": "latest", "underscore": "latest", "backbone": "latest", "jasmine-jquery": "latest", "jasmine-ajax": "[email protected]:pivotal/jasmine-ajax.git" } }
其中最重要的就是dependencies,它指定了所有前端开发依赖的包。所有bower包含的依赖都可以在这里查到,对于bower没有包含的依赖也可以直接指定github的repository,例如:"jasmine-ajax": "[email protected]:pivotal/jasmine-ajax.git"。
最后运行bower install就可以在components文件夹中看到所有第三方依赖的文件了。但是bower有一个问题,就是它将所有github repository中的文件都下载下来了,其中有许多是我们不需要的文件。下面我们会将我们需要的文件提取出来打包放到我们指定的目录中。
源文件编译
这里我使用的工具是grunt,他本身主要是基于Node.js的文件操作包,其中有许多插件可以让我们完成js文件的compile和compress、sass到css的转换等等操作。要使用它需要先安装命令行工具:npm install grunt-cli -g,然后在项目根目录中创建文件Gruntfile.js,这个文件用于定义各种task,我们首先定义一个task将从bower下载的第三方依赖都打包到文件app/js/lib.js中:
module.exports = function(grunt) { var dependencies = [ ‘components/jquery/jquery.js‘, ‘components/underscore/underscore.js‘, ‘components/backbone/backbone.js‘]; grunt.initConfig({ concat: { js: { src: dependencies, dest: ‘app/js/lib.js‘ } } }); grunt.loadNpmTasks(‘grunt-contrib-concat‘); };
这里的grunt-contrib-concat就是grunt的一个插件,用于文件的合并操作,我们已经在前面的package.json中引入了。js是task name;src指定了合并的源文件地址;dest指定了合并的目标文件。这样当我们运行grunt concat:js后,所有的依赖文件都会被合并为app/js/lib.js。这样做的好处是我们可以控制每个依赖的引入顺序,但是麻烦的是每次引入新的依赖都需要手动加入到dependencies数组中。这个暂时没有更好的解决方案,因为不是所有的包都在自己的components.js中声明了main文件,很多时候必须自己手动指定。
JavaScript文件编译完成以后就是CSS文件,在现代的前端开发中,我们已经很少直接写CSS文件了,一般都使用SASS或者LESS。grunt也提供了这种支持,这里我使用的是grunt-contrib-compass:
module.exports = function(grunt) { var sasses = ‘sass‘; grunt.initConfig({ compass: { development: { options: { sassDir: sasses, cssDir: ‘app/css‘ } } } }); grunt.loadNpmTasks(‘grunt-contrib-compass‘); };
然后运行grunt compass:development就可以完成CSS文件的编译了。
自动化测试
这里我使用的自动化测试工具是Jasmine,它grunt中同样有一个插件:grunt-contrib-jasmine。下面我们来看看如何在Gruntfile.js中定义测试的task:
module.exports = function(grunt) { var sources = ‘app/js/**/*.js‘, specs = ‘spec/**/*Spec.js‘; grunt.initConfig({ jasmine: { test: { src: [sources], options: { specs: specs, helpers: [‘spec/helper/**/*.js‘], vendor: ‘app/js/lib.js‘ } } } }); grunt.loadNpmTasks(‘grunt-contrib-jasmine‘); };
配置完成以后就可以运行grunt jasmine:test来跑测试,但问题是每次写完代码都要手动执行一次非常麻烦,最好可以每次代码有更改都自动跑一次,让我们可以更快的得到反馈。grunt的watch插件就提供了这种支持:
module.exports = function(grunt) { var sources = ‘app/js/**/*.js‘, specs = ‘spec/**/*Spec.js‘; grunt.initConfig({ jasmine: { test: { src: [sources], options: { specs: specs, helpers: [‘spec/helper/**/*.js‘], vendor: ‘app/js/lib.js‘ } } }, watch: { test: { files: [sources, specs], tasks: [‘jasmine:test‘] } } }); grunt.loadNpmTasks(‘grunt-contrib-jasmine‘); grunt.loadNpmTasks(‘grunt-contrib-watch‘); };
files指定了需要监听变动的文件;tasks指定了修改后自动触发的task。现在只要我们运行grunt watch:test,那么有任何源文件、测试文件的改动,Jasmine测试都会自动运行了。有时候我们也希望测试的结果显示在网页上,便于我们做js的调试。那么可以将tasks: [‘jasmine:test‘]改为tasks: [‘jasmine:test:build‘],然后打开根目录下的_SpecRunner.html文件,就可以在网页中看到测试结果了,再加上一些Chrome的Livereload插件,就可以不用刷新实时的看到测试结果,效率非常之高。虽然grunt插件中也有livereload,但是与grunt-contrib-watch无法很好的集成,所以我没有使用这种方式。
CI Pipeline
由于我的项目是host在github上,所以我选择travis-ci作为我的CI服务器。要启用travis-ci需要以下几步:
- 在travis-ci中注册一个账号,获取一个token;
- 在你的github项目的Settings–>Service Hooks中找到Travis,填入token并且启用;
- 回到travis-ci,在Accounts–>Repositories中打开你的项目的service hook
- Push一个.travis.yml到github,触发第一次build。
- 修改package.json的scripts项,指定运行测试的命令
下面我们来看看如何配置.travis.yml:
language: node_js node_js: - "0.8" before_script: - npm install -g grunt-cli
由于我们的环境是基于Node.js搭建的,所以在language设置了nodejs;而**nodejs指定了Node.js的版本;before_script**指定了在测试运行前需要执行的命令,由于我们的脚本都是基于grunt的,所以需要先安装grunt的命令行包。
然后再修改package.json:
{ ?? "scripts": { "test": "grunt jasmine:test" } ?? }
将修改以后的package.jsonpush到github上,再次触发一个新的build,你可以看到你之前错误的build已经绿了。
这里还有一个小提示:如何让build状态显示在项目的readme中?很简单,只需要在README.md中加入以下代码就可以了:
[![Build Status](https://travis-ci.org/path/to/your_repository.png?branch=master)](http://travis-ci.org/path/to/your_repository)
到这里基本的环境搭建就完成了,当然我们还可以使用grund的registerTask来定义一个任务序列,还可以加入template的编译??这些都可以通过grunt来灵活设置。最重要的是现在别人拿到一个项目的代码以后,可以通过一些命令来快速的搭建本地环境,方便的进行测试和开发,而且没有依赖与后端的开发环境,只要定义好接口,前端开发可以完全独立开了。虽然这其中还有很多问题没有解决,例如:
- 如何让第三方依赖自申明main文件
- package.json与components.json其实有些重复
- Live Reload还需要Chrome插件才能完成
- ??
这正是由于现在前端开发环境还没有后端开发的那种标准化,也正是挑战和机遇之所在!