generator-tinper-bee
tinper-bee
标准react组件脚手架生成器
功能特性
- 支持 eslint
- 支持 Enzyme
使用方式
npm install yo generator-tinper-bee -g
mkdir test
cd test
yo tinper-bee --port=8000 --author=GuoYongfeng --tb_version=1.0.0
配置说明
API介绍
参数 | 说明 | 默认值 |
---|---|---|
port | 开发时服务监听端口 | 8000 |
author | 作者名字 | 空字符串 |
beeVersion | 版本号 | 0.0.1 |
pkgName | 包名 | bee-组件名 |
repoUrl | 仓库地址 | https://github.com/tinper-bee/ + 包名 |
产出目录结构
-demo
-TestDemo.js
-TestDemo.scss
-index.js
-src
-Test.js
-Test.scss
-index.js
-test
-Test.test.js
-.eslintignore
-.npmignore
-HISTORY.md
-index.html
-package.json
-README.md
源码目录说明
- 在 src 目录中写源程序代码,在 demo 目录下写使用用例,在 tests 目录下写 测试用例,build目录产出打包组件,代码规范参考 airbnb.
- 根目录 中的 html 不可修改,通过 js 中的 jsx 渲染页面,通过 require css 引入 css
- 开发中用到其他公共库,通过
npm install --save
以及npm install --save-dev
来安装
开发调试
- 在项目根目录执行
npm install
安装必要模块 - 全局安装bee-tools
npm install -g bee-tools
- 在项目根目录执行
npm run dev
查看demo,进行调试 - 在项目根目录执行
npm run build
产出build目录代码 - 在项目根目录执行
npm run lint
执行lint检查 - 在项目根目录执行
npm run test
执行测试用例 - 在项目根目录执行
npm run chrome
在chrome执行测试用例 - 在项目根目录执行
npm run browsers
在本机多浏览器执行测试用例 - 在项目根目录执行
npm run pub
进行组件发布,master分支为正式发布版,release分支为开发分支
浏览器支持版本
- ie8, ie8+, chrome, firefox 最新版
- 可适当渐进降级,如 css 动画可以不支持 ie8
支持 HISTORY.md
- 通过在根目录运行
npm run history
生成 HISTORY.md - 需要建立必要的 milestone,issue,label,参见: https://github.com/tinper-bee/generator-tinper-bee
- milestone 标题为语义化版本号,issue 属于某个 milestone,并且具备 label
- label 为枚举,包括
new
新增的属性、功能、方法、特性等等fixed
修复 bug 和影响使用的性能问题等improved
接口增强、健壮性和性能提升、代码优化、依赖模块升级等。changed
涉及到兼容性变化的改动。
发布
- 在git上对原版本打tag
- 将修改的代码进行提交github
- 在根目录运行 npm run pub