front-native: A JavaScript repository from gggdandan

前端本地开发环境

本地构建环境： node v0.10.26 npm 1.4.3 grunt 0.4.5 express3.18.4

功能简介

front-native是一个前端服务化的项目构建脚手架，整合业界优秀的框架、组件库、ui等，下载到本地直接使用，方便二次开发。

下载及使用

将项目克隆到本地：git clone git@github.com:automatically/front-native.git
切换到项目根目录下面，比如：cd ~/native依次执行

npm install 安装项目所需要的插件

grunt native 部署本地静态资源，成功后在项目根目录下会产出assets目录（只在初次执行）

node app.js 访问：http://localhost:3000就可以看到本地环境的页面效果

如何在本地快速新建一个页面？

以项目中的singleForm案例来简述构建过程：

在views/templates/mytest 下面建立一个模板文件singleForm.vm这个模板是页面的主体部分（其中不包含页面的头尾）
在controllers/mytest下面建立一个nodejs文件singleForm.js用来mock业务数据和渲染模板
在static/js/mytest/1.0.0下面建立一个singleForm.js就是页面对应的业务脚本
在gruntfile.js里面新增样式脚本部署的相关配置（依赖配置在package.json的alias），完成后在项目根目录下执行grunt native打包部署静态资源
在views/ui/mytest/config.json配置打包部署好的脚本
在routes.js加入页面访问规则
最后执行node app.js访问http://localhost:3000/mytest/singleForm预览页面效果

Tips

每次pull下来先执行npm install 和 grunt native
每次对项目中的js&css 改动都需要手动执行grunt native或者在命令行执行grunt watch则会在后台监控，一旦代码改动就会自动部署，推荐这种方式
修改controllers下面的js文件需要重启node服务node app.js

Q&A

问：这套ui-library主要用来完成什么任务？

答：库里面整合了一些基础交互组件，不依赖于服务器环境和后端，直接下载到本地开发、部署，在本地完成mockdata调试。

问：有没有案例可以参考一下呢？

答：本地访问： http://localhost:3000/mytest/singleForm

问：关于自己开发组件模块的规范是什么呢？

答：现在库里面已经有cellula fdp之类的公共模块了，理论上我们在开发环境中会涉及到2大类型的模块，一类是公共的模块，也就是可以供不同系统和业务使用的模块，它们通常是js底层的类库扩展或者是基于场景模型的构建，比如cellula fdp之类，它们存放在lib下面，另一类是纯业务型的模块组件，它们存放在static下面，而assets则是存放系统编译打包压缩后的js&css也就是在线上环境被调用的静态文件。

开发及构建

目录结构

|-- assets 静态文件资源库 存放编译打包后的js&css（第一次使用需要先执行`grunt native`）
|-- controllers 业务层
|-- lib 公共js库
|-- public 公共文件
|-- sea-modules js依赖的组件模块
|-- static 静态文件
|-- views
		|-- ui
		|-- templates
ui.js 用户自定义样式脚本以及ui层的相关配置
app.js 站点入口
config.js 站点配置
Gruntfile.js 静态资源部署脚本
macros.js 宏定义
routes.js 路由配置
package.js 项目配置

构建工具

front-native使用grunt构建项目

gggdandan/front-native