Monkeys NPM | npm.io

Monkeys

一，概述：

monkeys是一个前端开发工具集合，基于koa框架开发，功能涉及以下环节

项目初始化 —— 创建项目基本结构，并初始化git提交远程仓库
本地web服务 —— 类似于apache、nginx，优势在于不需要繁琐的配置，可在任意目录启动，启动后当前目录即为web服务根目录
构建 —— html编译，css、javascript压缩合并等
部署 —— 提供项目部署快捷方式，如创建git tag并推送到远程仓库

若要使用monkeys全部功能特性，包括官方组件、项目依赖等，客户端需确保引入requirejs、zepto.

二，规范

1，目录结构

project
	|-- src						开发目录
		 |-- js
		 |-- css
		 |-- images
		 |-- index.html
	|-- build					发布目录
		 |-- js
		 |-- css
		 |-- images
		 |-- index.html
	|-- meta.json				项目元数据（配置）——详见meta详解
	|-- .gitignore              git配置		
	|-- README.md				项目文档

上述目录结构，是monkeys基于I/O实时编译及打包的基础规范。

新项目可使用monkeys init命令初始化项目，会自行创建以上规范目录
老的维护性项目，则需先按以上规范调整目录，方可适应monkeys

在项目初始化时，工具只会创建开发时所需必要资源，如src/* meta.json .gitignore README.md，build目录将在构建项目时自动创建。另外，src目录下html文件可以是多个，且文件名称均可自定义。

2，meta.json

{
	"name" : "ssdz",
	"version" : "1.1.2",
	"deps" : {
		"h5lib" : "../h5lib:1.0.2",
		"module" : "../module:1.1.7"
	},
	"seedJsList" : ["seed.js" , "seed.lack.js"],
	"widget" : {
		"base" : "http://p1.cdn.pengpengla.com/module/",
		"version" : "1.1.6"
	},
	"build" : {
		"amdJsCombine" : true,
		"jsmin" : true
	}
}

name： 项目名称

version

项目版本号，在项目构建时将替换html文件、css文件中的@@version

deps

声明项目依赖，基本格式：

"depProjectName" : "depProjectPath:depProjectVersion"

比如

"deps" : {
	"h5lib" : "../h5lib:1.0.2",
	"module" : "../module:1.1.7"
}

即声明当前项目依赖h5lib、module两个项目，且和当前项目在相同目录层级。

seedJsList

种子类型JS文件列表配置。

种子文件？通常指用script标签形势直接载入到html页面的文件，如第三方库requirejs、zepto、underscore等！种子文件，在项目中每个页面均会被使用，且无需使用模块化（amd\cmd）方式引用。

从加载性能角度考虑，为了避免多个http请求种子文件，通常会将多个种子文件合并成单个文件，很明显人肉做物理合并乃非明智之选。当然地，使用seedJsList声明便可解决此问题。

seedJsList种子文件编写务必按照约定格式，如seed.js：

require('./require');
require('./zepto/zepto');
require('./zepto/callbacks');
require('./zepto/defered');
require('./zepto/fx');
require('./underscore');
require('./fastclick/index');
require('./m-base');

文件被指定为seed类型后，monkeys做的仅仅是按顺序依次找到请求的模块做串行输出，而不按照AMD模块规范做编译，无论是在IO阶段还是项目构建阶段。

widget

声明组件配置，包括源、版本信息，有此声明之后，在当前项目目录下即可使用monkeys install widgetname安装提供的官方组件

build

项目构建的相关配置

amdJsCombile 是否执行AMD模块合并，默认false
jsmin 是否压缩javascript文件，默认false

3，项目依赖

在实际的业务场景中，有很多通用、共用的组件和模块，分布在不同的代码仓库中。

通常情况下，前端通用UI组件、功能组件会被从业务仓库中独立出来管理，如何能让这些通用模块作用于其它业务项目中？项目依赖管理正是为了解决这个问题。

姿势很重要，按以下方式做依赖声明：

"deps" : {
	"h5lib" : "../h5lib:1.0.2",
	"module" : "../module:1.1.7"
}

引用被依赖项目模块:

JS格式：

define(function (require , exports , module) {
	var PopLayer = require('module/poplayer/index');
	var http = require('module/http/index');
	module.exports = {
		init : function () {
			console.log(PopLayer);
			console.log(http);
		}
	};
});

require('依赖项目名称/模块路径')，其中模块路径src/js/已省略，monkeys在查找模块文件时会自动从src/js/目录下查找。

CSS格式：