WeFlow help documentation /自定义插件(高级)

自定义插件(高级)

首先,我们应该明确一点,作为一个通用的程序,是不应该在核心里面有过多的私有定制需求的,如想在gulp dev后列出根目录下所有的 html 功能,想在gulp ftp上传成功后直接弹出浏览器窗口,斯认为,侵入性过强,不应作为一个通用工作流的集成的功能,所以,我们提供了插件功能。

tmt-workflow不仅提供了多个常用任务,还开放了各个常用任务的回调接口,您只需按 node 的方式编写插件,即可自行根据具体需求设计自己想要的功能,使得用户不需要通读tmt-workflow源码,就可以扩展自己想要的任务,既降低了学习成本,也降低了工作流的耦合度。

下面,我们以一个简单的示例说明如何使用自定义插件功能。

1. 配置.tmtworkflowrc

//插件功能 //路径相对于 tasks/plugins 目录 "plugins": { "build_devAfter": ["TmTIndex"], //build_dev 任务执行后自动执行 "build_distAfter": [], //build_dist 任务执行后自动执行 "ftpAfter": ["ftp"] //ftp 任务执行后自动执行 },

如上,每个字段属性对应各个任务,以数组形式指定插件,依次执行数组指定的插件,如我们给我们的插件命名为TmTIndex

2. 在_tasks/plugins/目录下新建 TmTIndex.js

var rd = require('rd'); var fs = require('fs'); var path = require('path'); //插件必需按 node 模块规范编写 module.exports = function (config) { // do some stuff ... }

如上,插件只需要按 node 模块规范编写,就可以实现你要的功能。

可以看到,扩展插件只需要两步,具体想实现什么样的功能,可根据具体的需求进行定制。

我们内部已通过插件功能扩展了多个定制需求,哪里不明白随时 Issues 。