Skip to content

qihong1983/generator-hawk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

前端集成自动化项目构建方案Hawk

by 小洪 qihongbin@163.com

Generator-Hawk 方案简介

Generator-Hawk 是web前端集成自动化构建方案,用来生成项目代码骨架,打包合并等。你可以方便的基于此结构来开发你的项目,并享用到 web前端的诸多优秀特性。(最佳实践)

视频演示

asciicast

自动化构建17点约定(约定胜于配置)

约定1

url引用方式

规范
    http://xxx.cdn.cn/项目组/项目/项目迭代版本/页面/页面.(js|css)
    有规范的路径降底后期维护成本

约定2

地址映射

开发环境、测试环境、生产环境访问路径统一。三个环境不容易混乱

    开发环境: http://xxx.cdn.cn/group/project/0.1.0/mods/mod1.js
    测试环境: http://xxx.cdn.cn/group/project/0.1.0/mods/mod1.js
    生产环境: http://xxx.cdn.cn/group/project/0.1.0/mods/mod1.js

约定3

脚首架 (输出目录结构规范和代码规范--自动关联)

创建一个前端项目、页面、模块、组件并把css和js和html约定好的规范输出并做关联,前端工程师只要在这个骨架里填肉就好了。
可以提升开发效率

约定4

自动压缩js和css

这个就不细说了,目前大多数项目上线都会把代码压缩。降底文件大小,增加方问速度提升其中一个点

约定5

自动图片压缩

前端切出来的图片在保存png图片不一定是最有利于网络传输的图片。
而要手动压缩图片大小会占用很多不必要的工作量影响开发效率

约定6

自动合成图片

页面会有一些小图标,每个小图标都会发送一个http请求,每个请求和响应会占用一部份时间,
所以把小图标合并成一个图,用css定位的方式呈现。减少请求小图标的数量实现访问性能的提升

约定7

自动将合成图转换base64编码

可以将图片转换成文本处理,来提高访问性能。不支持ie6、ie7。
ie8合成的图片不能超过32k,否则不转换

约定8

页面模块化

一个页面由N个模块组成
模块内的功能可以N个组件组成

每个页面有自己的css和自己的js
每个模块有自己的css天自己的js --- 每个模块可以独立访问(限本地环境和测试环境)

好处是页面内不相关的区块进行解耦,代码逻辑不混淆,方便多人并行开发同一个页面,也方便后期局部改版或替换

约定9

md5戳

这种实践方式是好处有两点:
    1、上线后能够有效的清除用户浏览器缓存,使用户一直访问最新的页面
    2、避免同名文件被覆盖,在项目版本迭代上线过程中不会出现老代码和新代码的不统一导制用户短时间访问出现问题

这个方式一般是先上前端代码在上后端代码实现切到线上的过程

约定10

按需合并

将每个页面所需要的模块css和js合并成一个请求不需要的不合到一起
比如 home.html、list.html 两个页面的js静态资源
home.html用到了a.js,b.js --> home.html不会包含不用的c.js和d.js
list.html用到了c.js,d.js --> list.html不会包含不用的a.js和b.js
这个后期可以在继续优化
优化推荐(暂未实现)
    1、home.html用到了a.js,b.js,c.js --> a.js和c.js一个请求,而另一个请求是b.js
    2、list.html用到了b.js,d.js -- > 在从home.html跳转到list.html b.js就会从浏览器缓存中加载。
       而d.js从服务器上加载

约定11

通用组件包管理

可以用spm或bower对组件的管理,可以进行有效的积累
可以搭建一个spm私有平台或private-bower平台对自己写过或抽离出来的组件进行管理和复用还有文档
在开发过程中,可复用的组件越多,效率越高

约定12

一键式启动 (支持 http combo 本地服务)

约定13

ctrl + s 保存并刷新网页

需要在chrome按装这个插件
这个功能挺有意思,保存后自动就帮刷新了,省去一个操作维度,可以对开发效率的提升

约定14

一键式发布测试服务器 & 一键式发布静态服务器

常规方式是打开ftp客户端,前端需要找本地代码的位置和服务器代码的位置在提交,主要是在联调和改bug阶段,频繁修改提交
用约定好的路径一键式提交会大大减少操作维度,而且不容易出错 

约定15

注释文档

代码里写注释是一个很好的习惯,如果能通过注释生成文档就更好了,hawk里采用的是yuidoc
主要是考虑它是支持模块化声名的

约定16

采用git来管理代码

目前很主流的代码管理软件--好处不多说

约定17

采用代理调试工具

在前端项目联调或改bug阶段,会出现频繁修改代码,为了提高效率可以用代理,把测试环境上的代码代理到本地修改的文件
来测试测试环境上有没有什么问题,把bug列表里的bug全部修改完后在统一提交也是一个好的实践方式
在出现线上bug时候也是需要代理工具来调试把线上压缩后的代码指向本地方便调式
这里采用第三方charles ,不会用问百度

安装

npm install -g yo generator-hawk

基本命令-- yo & gulp

yo初始化

yo hawk:h:打印帮助

yo hawk:初始化一个标准的Project

yo hawk:初始化一个页面

yo hawk:mod:初始化一个模块

yo hawk:widget:初始化一个组件

gulp打包

gulp dev: 本地运行

gulp dev64: 本地运行图片base64编码

gulp qa: 打包到测试环境 并自动提交到ftp服务器

gulp qa64: 打包到测试环境图片base64编码 并自动提交到ftp服务器

gulp online: 打包成线上环境 并自动提交到ftp服务器

gulp online64: 打包成线上环境64 并自动提交到ftp服务器

gulp onlinedebug: 打包成线上环境 不提交到ftp服务器

gulp online64debug: 打包成线上环境 不提交到ftp服务器

目录结构 & 文件关联

目录结构

./
├── gulpfile.js              项目构建主任务
├── package.json              项目配置文件
├── README.md                 项目自述文件
├── build/                    构建目录
├── doc/                      文档存放目录
├── .bower.json               组件安装源配置(gitlab or github)
├── .bowerrc                  
├── .editorconfig
├── .gitignore
├── abc.json 				  项目配置文件
└── src/                      源码目录
    ├── config.js             项目config.js
    ├── mods/  
    │   │            
    │   ├── mod1			   业务公用模块目录
    │   │   ├── demo.html
    │   │   ├── mod1.html
    │   │   ├── mod1.js
    │   │   └── mod1.css
    │   └── mod2
    │       ├── demo.html
    │       ├── mod2.html
    │       ├── mod2.js
    │       └── mod2.css
    │		
    ├── widgets/              组件目录(通用组件)
    │   │
    │   ├── widget1/
    │   │   ├── demo.html
    │   │   ├── widget1.js
    │   │   └── widget1.css
    │   └── widget2/          
    │       ├── demo.html
    │       ├── widget2.js
    │       └── widget2.css
    └── pages/                         
        └── page1/             
            ├── page1.js      
            ├── page1.sss        
            └── page1.html       
            ...
文件关联

chome插件收集

PerfectPixel by WellDoneCode
LiveReload
Page Ruler
Postman
jsonview

待续