MIP CLI 工具

MIP脚手架.

$3

依赖环境: Node.js (>=4.x).

`` bash
$ [sudo] npm install -g mip-cli
`
注意：
nodejs 5.x, 6.x 安装模块时，可能会报node-gyp相关错误，需要使用如下命令安装

`
$ [sudo] npm install --unsafe-perm -g mip-cli
`
nodejs 5.x 安装bufferutil模块时可能会报编译错误，建议使用4.4或者6.x以上版本。

$3

在当前项目根目录中初始化mip配置：

` bash
$ mip init
`
会创建mip.config文件，相关配置如下：

`
module.exports = {

/**
* mip server调试的端口号
*
* @type {number}
*/
port: 8000,

/**
* 本地mip网页后缀名，会对mip网页动态添加调试脚本
*
* @type {RegExp}
*/
mipPageExt: /\.(?:html|htm|mip)$/i,

/**
* 本地mip组件调试目录，主要用于开发组件时进行本地调试，自动将本地mip组件注入到当前访问的页面中
* 例如：配置'../mip-extensions'，会将此目录的组件注入到调试页面
*
* @type {string}
*/
extensionsDir: '',

/**
* 本地mip调试目录，用于调试本地mip项目
*
* @type {string}
*/
mipDir: '../../../mip',

/**
* 启用调试页面自动刷新
*
* @type {boolean}
*/
livereload: true
};
`

![](./example/mip-init.png)

----
在当前项目创建一个mip模板网页：

` bash
$ mip add index.html [mip-xxx...]
`

![](./example/mip-add.png)

----
在mip-extensions仓库中创建一个mip组件：

` bash
$ mip addelement mip-demo
`

![](./example/mip-addelement.png)

----
验证mip网页：

` bash
$ mip validate index.html [...]
`

![](./example/mip-validate.png)

----
在当前项目或者mip-extensions仓库中启动mip网页调试器：

` bash
$ mip server
`

注意：调试mip-extensions仓库组件时，会读取组件中READEME.md的使用示例，因此组件的README.md中
应至少包含一段使用示例：


    使用示例
    `html
        <mip-xxx></mip-xxx>
    `

配置了mipDir之后可以调试mip引擎。

mip server 启动多个实例的话会报端口占用错误，需要关闭其他实例或者kill掉占用端口的进程后再启动。

`
➜ ~ mip server
INFO livereload server start at: http://172.20.128.110:35730
ERROR PORT 8000 already in use, please retry again!
`

![](./example/mip-server.png)

----
在当前项目中，校验编写的mip组件，可以校验mip组件目录或者mip组件压缩包：

` bash


directory

$ mip validateelement ./mip-demo

zip package

$ mip validateelement ./mip-demo.zip
`


----
更新mip工具，将mip模板更新到最新版本：

` bash
$ mip update
`

![](./example/mip-update.png)

----

直接从官方 npm registry 安装，可能会由于网络原因，导致安装时间较长或安装失败。此时我们可以选择速度更快的 registry。

`
$ [sudo] npm install -g mip-cli --registry=https://registry.npm.taobao.org
`

$3

进入mip-extensions仓库，使用mip server命令启动调试器
访问 http://127.0.0.1:8000`查看看组件列表，点击组件链接进行预览

$3

MIT