插件上下文 API
无论是开发脚手架、构建器还是插件,Feflow 都会通过传参或注入全局变量给开发者提供一个 Feflow 实例方便大家开发,这是个实例又被称为插件上下文,本章将列出所有插件上下文的 API。
Feflow 运行环境相关 API
feflow.version
返回当前 Feflow 的版本。string 类型。
feflow.baseDir
返回 Feflow 的主目录。string 类型。
feflow.rcPath
返回 Feflow 全局配置文件 .feflowrc.yml
的路径。string 类型。
feflow.pkgPath
返回 Feflow 的 package.json
文件的路径。string 类型。
feflow.pluginDir
返回 Feflow 的插件、构建器、脚手架等安装路径。string 类型。
feflow.logDir
返回 Feflow 日志的路径。string 类型。
feflow.config
返回 Feflow 的全局配置对象,即 .feflowrc.yml
读取出来的数据。object 类型。
feflow.args
返回 feflow 命令经过解析的参数。如 feflow init
返回 { "": ["init"] }
。object 类型。
Feflow 日志打印相关 API
Feflow 提供的工具类函数都放在 feflow.log
实例中,它包含以下属性和方法:
feflow.log.info
控制台输出提示类日志的方法,Function 类型。
feflow.log.debug
控制台输出调试类日志的方法,需要在命令行增加 --debug 才可启用这个方法,Function 类型。
feflow.log.warn
控制台输出警告类日志的方法,Function 类型。
feflow.log.error
控制台输出错误类日志的方法,Function 类型。
feflow.log.fatal
控制台输出致命错误类日志的方法,Function 类型。
feflow.log.i
feflow.log.info
方法的简写。
feflow.log.d
feflow.log.debug
方法的简写。
feflow.log.w
feflow.log.warn
方法的简写。
feflow.log.e
feflow.log.error
方法的简写。
Feflow 工具函数相关 API
Feflow 提供的工具类函数都放在 feflow.utils
对象中,它包含以下方法:
feflow.utils.chalk
NPM 包 chalk
的引用,方便操作控制台输出字符的样式。Object 类型。
feflow.utils.Loading(name, color)
控制台显示加载进度的构造函数。Function 类型。需要先 new feflow.utils.Loading(name, color)
生成一个实例 loading
,然后再调用 loading.success(message)
或者 loading.fail(message)
方法表示成功加载或者加载失败。
Feflow 命令相关 API
Feflow 命令相关 API都放在 feflow.cmd
实例中,它包含以下属性和方法:
feflow.cmd.alias
返回 Feflow 当前支持的所有命令以及它们的缩写。object 类型。
feflow.cmd.list()
返回 Feflow 当前支持的所有命令对应的执行函数。object 类型。
feflow.cmd.get(name)
返回 Feflow 特定的命令对应的执行函数。Function 类型。
feflow.cmd.register(name, desc, options, fn)
注册一个命令。Function 类型。