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方法，也可以用来添加注释

语法示例

ImportJavscript.url("http://style.c.aliimg.com/xxx/yyy.js");

可能的报错以及排查

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