Dokumentasi bantuan WeFlow / 自定义插件(高级)

自定义插件(高级)

首先,我们应该明确一点,作为一个通用的程序,是不应该在核心里面有过多的私有定制需求的,如想在 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 。