fd-gulp-jsconcat/README.md

concat js files according to those rules listed on this page(http://wd.alibaba-inc.com/doc/page/work/cbu-regulations/merge)

## `fd-gulp-jsconcat`任务是根据指定的书写规则来将当前文件中引入的js进行合并。
### 用法
```
jsConcat(srcDir [,opt]);
```

### 例子
```
var gulp = require('gulp');
var jsConcat = require('fd-gulp-jsconcat');

gulp.task('jsConcat', function() {
	gulp.src('D:/wwwroot/workspace/fd-gulp-jsconcat/test/style_test/**/*.js')
		.pipe(jsConcat('D:/wwwroot/workspace/fd-gulp-jsconcat/test/style_test'))
		.pipe(gulp.dest('./output'));
});
```

### 参数
```
srcDir（必填）: 'D:/wwwroot/workspace/fd-gulp-jsconcat/test/style_test'  // 要合并的文件目录
opt（选填）: {
	domain: 'http://style.c.aliimg.com/', // 配置merge文件中的js文件的域名
	localCommonDir: 'D:/wwwroot/workspace'   // 配置公共资源（fdevlib/sys）在本地的目录，配置后，合并任务会优先在本地找fdevlib/sys资源
}
```


### merge start/merge end标记说明
* 合并脚本是根据此标记来判断是否是合并文件的，因此 **merge start/merge end注释不可删除！**
* merge_start内容：/*merge start*/
* merge_end内容：/*merge end*/

### 合并规则
* 一行一个import
* 路径可以使用完整的URL或者相对路径
* 路径可以使用单引号也可以使用双引号
* 在import行不能有注释
* 在一行的最前和最后可以有一个或多个空格或TAB
* import的重复文件内容只会合并到第一次出现的地方
* 由于js的import是自定义语法，因此在开发阶段在使用import的js文件里需要有ImportJavscript.url(jsPath)这个函数存在 方法是使用merge_start和merge_end标记(标记说明见下面，在两个标记之间的行在合并时会被忽略，可以用来实现ImportJavascript.url方法，也可以用来添加注释

### 语法示例
```javascript
ImportJavscript.url("http://style.c.aliimg.com/xxx/yyy.js");
```

### 可能的报错以及排查
1. 被 merge 的文件找不到
解决方法：查看日志找到未找到的文件，并作出修正即可