npm install generator-mpigenerator-mpi
by bachi@taobao.com
[![NPM version][npm-image]][npm-url]
[![build status][travis-image]][travis-url]
[![node version][node-image]][node-url]
[![npm download][npm-download]][download-url]
[npm-image]: http://img.shields.io/npm/v/generator-mpi.svg?style=flat-square
[npm-url]: http://npmjs.org/package/generator-mpi
[bower-image]: http://img.shields.io/bower/v/generator-mpi.svg?style=flat-square
[bower-url]: https://github.com/jayli/generator-mpi
[travis-image]: https://img.shields.io/travis/jayli/generator-mpi.svg?style=flat-square
[travis-url]: https://travis-ci.org/jayli/generator-mpi
[node-image]: https://img.shields.io/badge/node.js-%3E=_0.12-green.svg?style=flat-square
[node-url]: http://nodejs.org/download/
[npm-download]: https://img.shields.io/npm/dm/generator-mpi.svg?style=flat-square
[download-url]: https://npmjs.org/package/generator-mpi
$3
KISSY MINI 模块生成脚手架工具，KISSY MINI 的模块是基于 bower 的模块包，原则上不支持线上地址直接引用，而是推荐通过 bower insall 的方式安装引用。这里的脚手架工具即是生成这个 bower 模块包的脚手架工具。KISSY MINI 的项目生成工具是Generator-Mask，两者配合使用效果更佳。
你可以自己定制自己的模块将要存放在哪个git仓库。阿里旅行的 KISSY MINI 模块代码存放在 gitlab 上，安装组件时需要配好.bowerrc（这个文件会被 Mask 工具自动生成），
{
"directory":"./",
"shorthand_resolver":"http://gitlab.alibaba-inc.com/{{{owner}}}/{{{package}}}.git"
}
这里的代码仓库前缀可以任意修改
$3
> 如果你在阿里内网，请指向内网镜像 sudo npm install -g tnpm --registry=http://registry.npm.alibaba-inc.com，然后使用tnpm
KISSY MINI 模块包代码只能通过 bower 来管理，因此非常干净，不包含本地服务和构建，运行本地Demo和测试用例只需用个人习惯的Node服务即可，推荐使用here-ssi。
首先安装三件套：
tnpm install -g yo grunt-cli bower
然后安装本地服务和脚手架
tnpm install -g here-ssi generator-mpi
完成。
$3
首先创建好一个模块的空目录，进入这个空目录，执行
yo mpi
然后根据提示完成项目初始化的工作即可
$3
在模块目录根目录中执行here便可启动本地服务，访问demo/index.html即可运行当前demo，访问test/runner.html即可运行当前测试用例。js 开发预发规范符合 CMD 的基本约定，亦兼容 KMD 规范。
代码版本管理默认基于 Gitlab （阿里内网的代码仓库），所以源码中目录和文件名看不到版本信息，基于Bower的版本需要自行手动修改bower.json，如果当前代码对其他模块有依赖，也需要手动修改bower.json。比如offline-app-router这个模块的bower.json的内容如下：
{
"name": "offline-app-router",
"version": "0.1.0",
"description": "对在手淘，支付宝中的跨类目离线包跳转做封装",
"authors": [
"若狸
],
"main": "./index.js",
"ignore": [
".jshintrc",
"*/.txt"
],
"dependencies": {
"base":"mpi/base"
},
"devDependencies": {
}
}
请注意版本的写法和依赖模块的写法，bower.json 是模块唯一最重要的配置文件
模块的研发完全基于本地 Demo 页面，无需构建和特别的本地环境配置，因此非常干净简单，代码存储直接提交在 gitlab 里即可，他人安装此模块只需通过bower install即可。模块文件是需要被具体的项目脚本构建的，构建工具参照grunt-kmb或者gulp-kmc。阿里旅行前端同学请使用 clam 构建工具来生成项目.
因为已经安装好了here-ssi服务，代码checkout到本地后，直接在项目根目录中执行here，即可开启服务
here
模块代码完成后，如需引用该模块，只需通过 bower 来安装该模块，例如：
bower install mpi/widget-name
$3
1. 模块代码可否被发布到 npm 或 tnpm 上？答：可以，需要自己配package.json，但强烈不推荐这样做，因为从日常开发角度看，人肉保持 git 仓库中代码和远程 npm 仓库代码的版本一致性要消耗掉极高的成本，所以仅用git来保存代码可以尽可能保持简单可依赖
1. KISSY MINI 的模块为什么不支持线上直接引用，就像 KISSY 1.4.x 和 KISSY 6.x 的组件都发布到线上一份一样？答：KISSY MINI 是面向移动设备研发的js库，性能优化方面，我们坚持资源离线的大的优化方向，资源离线后的瓶颈不在于资源个数，而在于资源体积和项目包（pkg）的内聚。即项目内原则上不会引用项目之外的资源，所以我们将 KISSY MINI 的开发规范和 bower 强绑定，所有的发布动作收敛到“项目发布”一个环节，而在组件和公用代码研发方面，不在单独走发布了，这样剔除了在线引用、强调离线资源引用，就极大的简化了模块代码和项目代码的耦合方式。
1. KISSY MINI 还支持 Combo 吗？答：1.x 及后续版本不在支持Combo，代码的合并完全交给构建工具去完成。
1. 基于 KISSY MINI 的模块代码为什么不需要构建？答：因为不需要发布到线上，所以我干脆就把构建给干掉了，构建的动作一律收敛到项目中，模块中的研发约定保持最简。