# Breezr core service

## 插件开发

插件本质上是一个 JS 的模块, 你需要在这个 JS 模块中导出一个方法

```javascript

export default (api: PluginAPI, opts) => {

};

```

## 插件 API

API 是个 PluginAPI 实例, 具体代码参见 src/PluginAPI.ts

### 系统 API

#### api.getCwd()

获取当前的工作路径,也就是项目所在的根目录

#### api.hasPlugin(id: string): boolean

判断当前是不是存在了某个plugin, 主要业务插件用来判断判断他依赖的插件是否存在

> id - 插件的名字, 可以忽略 (@breezr/|breezr-|@scope/breezr)-plugin-这些前缀

#### api.registerCommand(name: string, opts: CommandOption, fn: CommandCallback)

注册一个命令, 这个命令最终会变成 CLI 的命令作为透出

> name: 注册 cli 的名字

> opts: command 选项
  > * description: 命令的描述
  > * usage: 命令用法介绍
  > * details? : 更详细的信息(可选)
  > * options: 配置参数 如 { '--xxx': '描述', '-x': '描述'}

> fn: 命令被调用之后的回调方法

#### api.registerAPI(name: string, fn: PluginAPIMethod)

注册一个插件 API, 注册之后可以被其他的插件调用如:

``` javascript
api.registerAPI('log', (msg) => {
  console.log(msg)
})


api.log('show log');

```

> name: string - 注册方法名字

> fn: (...args: any) => void; - 方法被调用时候的回调方法.

#### api.on(lifecycleName: string, fn: PluginLifeCycelMethod)

注册一个生命周期

> name: string - 注册生命周期的名字

> fn: (...args: any) => void; - 生命周期被触发后的回调.


#### emit(lifecycleName: string, ...args: Array<any>)


#### api.registerPlugin

在插件内部注册其他的 API


### 插件 API

TODO