插件安装与管理

---

本文介绍light开发命令行工具的plugin指令。

light脚手架工具是一款可插拔的插件化的工具平台，本身支持编译构建流程上的插件扩展。

可选插件列表

当前light的所有插件可以通过https://npm.taobao.org/browse/keyword/lighting-plugin (opens new window)查看。

插件名称	插件说明
lighting-plugin-cachemanifest	生成缓存应用必要的描述文件
lighting-plugin-check	根据次配置文件检查并生成代码检查报告
lighting-plugin-debug	开启http服务和调试模式
lighting-plugin-es6	lighting<1.4,编译es6资源
lighting-plugin-imagemin	图片资源压缩
lighting-plugin-jade	lighting<1.4,编译jade资源
lighting-plugin-jslint	lighting<1.4,语法检查
lighting-plugin-jsnative	支持jsnative的编译和调试
lighting-plugin-miniprogram	支持小程序的编译和调试(旧版不再维护)
lighting-plugin-miniprogram2	支持小程序的编译和调试(推荐使用该插件开发小程序)
lighting-plugin-less	lighting<1.4,编译less文件
lighting-plugin-native	插件开启后，可打APP的配置包
lighting-plugin-postcss	lighting<1.4,支持postcss框架
lighting-plugin-sass	lighting<1.4,编译sass文件编译
lighting-plugin-sprites	lighting<1.4,编译生成图片精灵
lighting-plugin-template	lighting<1.0,支持模板文件编译
lighting-plugin-type-vue	lighting>1.4,支持webpack编译流程
lighting-plugin-vue	lighting<1.4,支持less文件编译
lighting-plugin-proxy	支持配置代理地址

查看已安装插件

可以通过如下命令来查看当前工具安装了哪些插件：

$ light plugin --list

控制台会输出当前已经安装插件的列表，以及各个插件的当前版本和最新版本。

light支持工程和插件版本的绑定关系，所以插件的本地版本可能会有多个。

.--------------------------------------------------------------------------------------------------------------.
|             pluginName             |           local versions           |           latest version           |
|------------------------------------|------------------------------------|------------------------------------|
| lighting-plugin-jsnative           | 1.0.13                             | 1.0.13                             |
| lighting-plugin-debug              | 1.0.18                             | 1.0.18                             |
| lighting-plugin-imagemin           | 1.0.3                              | 1.0.3                              |
| lighting-plugin-cachemanifest      | 1.0.4                              | 1.0.4                              |
| lighting-plugin-vue                | 1.1.9                              | 1.1.9                              |
| lighting-plugin-native             | 2.0.8                              | 2.0.8                              |
| lighting-plugin-type-vue           | 1.2.4                              | 1.2.4                              |
| lighting-plugin-proxy              | 1.0.2                              | 1.0.2                              |
| lighting-plugin-miniprogram2       | 2.0.9                              | 2.0.9                              |
'--------------------------------------------------------------------------------------------------------------'
插件已全部安装最新版本

插件安装和更新

通过如下指令（pluginName表示插件名称）来安装和更新插件：

$ light plugin -a <pluginName>  //安装插件

$ light plugin -u <pluginName>  //更新插件

light的插件都托管在npm仓库，受网络质量的影响，插件安装极易失败。如果遇到安装插件等待时间过长，或者中途资源下载报错的问题，可以在插件安装是指定使用的镜像地址。

$ light plugin -a <pluginName> --registry https://registry.npm.taobao.org

重置插件环境

当当前的工程运行异常，插件运行出错而又不好排查的时候，可以通过以下的指令对插件的安装环境进行重置。

$ light plugin --fix

注意事项

重置插件安装目录的操作会清空所有已经安装的插件，并重置插件状态信息。

卸载已安装插件

当发现插件工作不正常，或者需要卸载插件时，可以通过以下的指令对插件进行卸载。

$ light plugin -r  <pluginName>

开发lighting插件

lighting提供了易于扩展的插件接口，可以十分方便地开发lighting插件，具体的文档点我查看。

自定义临时存放目录

用户可自定义插件的临时存放目录，方法如下：

windows系统：

1.命令行执行 set LIGHT_HOME=D:\tmp\1232

2.执行light命令 light plugin -l 将会检查D:\tmp\1232目录下的插件安装情况，编译也会使用该目录下的插件进行编译

MAC系统：

1.命令行执行 export LIGHT_HOME=插件放置的路径

2.执行light命令 light plugin -l 将会检查指定的存放目录下的插件安装情况，编译也会使用该目录下的插件进行编译