BUI buijs cli工具
一、简介
buijs 是BUI Webapp交互框架 的npm命令工具(专注webapp快速开发), 用于快速生成指定平台与模板必须的工程文件. 需要先安装 node环境 才能使用npm命令.
通过命令行构建的工程,每次都会自动获取最新的BUI模板工程, 并且可以指定模板及平台. BUI模板图片预览
二、安装buijs命令行工具
windows:
npm install -g buijs
mac:
sudo npm install -g buijs
三、初始化工程目录:
创建默认Webapp工程 (demo 为工程名称)
buijs create demo
默认模板预览 更多模板点击这里 BUI模板图片预览
四、命令列表
命令行 | 描述 |
---|---|
buijs -v |
查看当前工具的版本 |
buijs -h |
命令帮助信息 |
buijs list |
显示可用的版本 |
buijs list-template |
显示可用的模板列表 BUI模板图片预览 |
buijs list-platform |
显示可用的平台列表 |
buijs create <projectName> [version] |
创建bui默认工程 |
buijs create <projectName> [version] -t tab |
创建bui tab在底部的模板工程,默认平台 webapp |
buijs create <projectName> [version] -t tab -p link |
创建bui tab在底部的模板工程,更改平台为 link |
创建某个模板工程 ( main-tab 为模板名称)
可以先查看有什么模板 buijs list-template
, BUI模板图片预览
buijs create demo -t main-tab
效果预览
注意:
1. 同一个工程可以多次创建模板;
模板名以main-
开头 会覆盖 main 模块, 例如: 模板名main-tab
预览地址index.html
模板名以page-
开头 会新增模块, 例如: 模板名page-sidebar
预览地址index.html#pages/sidebar/sidebar
2. 同一个工程只能创建一个平台, 多次创建会相互覆盖;
创建指定平台工程 ( dcloud 为平台名称 )
可以先查看有什么平台选择 buijs list-platform
注意:
1. 目前已经支持以下打包平台 cordova,bingotouch,link,dcloud,apicloud,appcan,微信 等;
2. 不同平台对应的文件会有些许不同, 绑定原生后退的方法也不同, 不指定平台时, 默认是webapp平台, 可以在微信及webkit浏览器内核预览.
buijs create demo -p dcloud
创建某个平台下的某个模板工程
buijs create demo -t sidebar -p dcloud
创建指定版本工程
可以先查看有什么版本
buijs list
buijs create demo v1.0
五、目录说明:
单页应用包文件夹说明:
路径 | 描述 |
---|---|
index.html | 入口文件 |
index.js | 入口的脚本 |
css/bui.css | BUI库的样式文件 |
font/ | 字体图标目录 |
images/ | 应用图片目录 |
js/zepto.js | bui的依赖库 |
js/plugins/fastclick.js | 移动端快速点击的插件 |
js/bui.js | BUI交互控件库 |
pages/ | 模块目录 |
pages/main | 默认 main 模块 |
pages/main/main.html | 默认 main 模块模板 |
pages/main/main.js | 默认 main 模块定义脚本 |
更多建议: